obsutil(obs命令行工具)v1.0官方版

obsutil是OBS推出的一款全新的命令行工具，具有简单易用、性能卓越等优势，是命令行模式下对OBS执行批量处理、自动化存取任务的最佳选择。

【安装说明】

　　1、将obsutil工具下载至本地。

　　2、下载完成后，将其解压至指定文件夹。

　　3、在解压后的文件夹中双击运行obsutil.exe即可开始使用。

　　说明：

　　您也可以使用cmd进入obsutil.exe的上一级目录执行obsutil命令。

【功能特色】

　　简单、易用；

　　无需安装，轻便小巧，即下即用；

　　同时支持Windows/Linux/macOS三大平台；

　　配置多元化，性能卓越。

【使用方法】

　　在不同操作系统，下载obsutil的方式也有所不同，下载后无需安装，即可开始使用。

　　Windows操作系统

　　在浏览器中打开表格中对应的下载地址将obsutil工具下载至本地。

　　下载完成后，将其解压至指定文件夹。

　　在解压后的文件夹中双击运行obsutil.exe即可开始使用。

　　说明：

　　您也可以使用cmd进入obsutil.exe的上一级目录执行obsutil命令。两种方式的命令行结构有所不同，详细请参见命令行结构。

　　命令行结构

　　遵循简单易用的原则，obsutil的命令行结构如下：

　　Windows操作系统：

　　obsutil command [parameters...] [options...]

　　macOS/Linux操作系统：

　　./obsutil command [parameters...] [options...]

　　说明：

　　command为执行的命令，例如ls，cp等。

　　parameters为该命令的基本参数（必选），例如创建桶时的桶名称。

　　options为该命令的附加参数（通常为可选），且附加参数在运行命令时必须以“-”开头。

　　方括号[]不是命令的一部分，在输入命令时，参数不能使用方括号[]括起来。

　　如命令中含有特殊字符，如&、<、>以及空格等，则需要加引号转义（macOS/Linux操作系统使用单引号，Windows操作系统使用双引号）。

　　附加参数支持两种传入方式-key=value和-key value，例如-acl=private和-acl private。两种参数传入方式无区别，您可以根据使用习惯选择任意一种方式。

　　在Windows操作系统上，obsutil支持直接运行obsutil.exe进入交互命令模式。在该模式下输入命令时可以省略“obsutil”，直接输入command [parameters...] [options...]运行命令。示例如下：

　　Enter "exit" or "quit" to logout

　　Enter "help" or "help command" to show help docs

　　Input your command:

　　-->ls -limit=3 -s

　　obs://bucket-001

　　obs://bucket-002

　　obs://bucket-003

　　Bucket number is: 3

　　Input your command:

　　-->

　　以SSH远程登录macOS/Linux操作系统使用obsutil命令时，建议配置TMOUT=0，防止SSH会话过期导致程序退出。

【软件测试】

test1

批量复制，目标文件夹ggggg-zyx0809/data/tmp/a0文件夹已存在，不使用flat命令，目标路径包含a0文件夹

操作 从ggggg-zyx0809/data/g_cagegory/a0复制到ggggg-zyx0809/data/tmp/a0

条件 ggggg-zyx0809/data/tmp/a0文件夹已存在，

结果 在ggggg-zyx0809/data/tmp/a0又生成一个文件夹a0

命令  ./obsutil cp obs://ggggg-zyx0809/data/g_cagegory/a0 obs://ggggg-zyx0809/data/tmp/a0  -f -r

test2

批量复制，目标文件夹ggggg-zyx0809/data/tmp/a0文件夹已存在，不使用flat命令，目标路径不包含a0文件夹

操作 从ggggg-zyx0809/data/g_cagegory/a0复制到ggggg-zyx0809/data/tmp/

条件 ggggg-zyx0809/data/tmp/a0文件夹已存在，

结果 在ggggg-zyx0809/data/tmp/不会重新生成文件夹a0，复制过来的数据直接存放到a0文件夹中

命令  ./obsutil cp obs://ggggg-zyx0809/data/g_cagegory/a0 obs://ggggg-zyx0809/data/tmp/  -f -r

test3

批量复制，ggggg-zyx0809/data/tmp/a0文件夹已存在，使用flat参数，目标路径包含a0文件夹

操作 从ggggg-zyx0809/data/g_cagegory/a0复制到ggggg-zyx0809/data/tmp/a0，增加flat参数

条件 ggggg-zyx0809/data/tmp/a0文件夹已存在，

结果 在ggggg-zyx0809/data/tmp/a0中不会新生成文件夹a0，复制过来的数据直接存放到a0文件夹中

 命令  ./obsutil cp obs://ggggg-zyx0809/data/g_cagegory/a0 obs://ggggg-zyx0809/data/tmp/a0  -f -r -flat

结论

通过test2和test3的实验我们发现，目标文件夹存在的情况下，复制不重复创建的文件夹的两种方式

目标路径不带目标文件夹，不使用flat参数

目标路径带目标文件夹，使用flat参数

综合对比，目标文件夹存在的情况下，复制不重复创建的文件夹最好的方式就是方法1（因为代码量少^_^）

【软件特点】

obsutil是一款用于访问管理华为云对象存储服务(Object Storage Service，OBS)的命令行工具，您可以使用该工具对OBS进行常用的配置管理操作，如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。对于熟悉命令行程序的用户，obsutil是执行批量处理、自动化任务的好的选择。obsutil适用于Windows、Linux和macOS三大主流的操作系统。

obsutil具有四大优势：简单、易用;无需安装，轻便小巧，即下即用;同时支持Windows/Linux/macOS三大平台;配置多元化，性能卓越。

使用场景，自动化备份归档等场景，比如定时上传本地数据至OBS。，支持通过OBS Browse+等其他工具不能实现的场景，比如同步上传/下载/复制对象等。