CMD通用参数
更新时间：2025-08-15
用户可以通过bos命令来访问BOS服务，管理、操作Bucket和Object。如果BOS服务余额不足时进行操作会提示Access Denied。
CMD使用多层命令结构，所有的命令以bcecmd开头，[options]表示BCE CMD支持的选项，<service>表示CMD所支持的服务，如BOS等，每个服务拥有多个特定的子命令。
Plain Text
1$ bcecmd [options] [<service> <command> [parameters [options]]]参数解释
| 参数项 | 取值 | 说明 |
|---|---|---|
| options | BCE通用的Option，取值为-c、-v、-h、-d和--conf-path。 | - |
| service | 取值为bos、bosprobe。 | bosprobe的使用方法请查看bosprobe |
| command | 取值为：mb、rb、ls、cp、rm。 | 各命令的作用请参见命令功能描述。 |
| parameters | 取值为<local-path>或<bos-path>。 | <bos-path>包含以下几种形式： - BOS根目录：bos:/ - BOS Bucket根目录：bos:/<bucket-name> - BOS Bucket下文件夹：bos:/<bucket-name>/<folder-name>/ - BOS Bucket下的Object：bos:/<bucket-name>/<folder-name>/<object-key> 注： 在<bos-path>中Bucket后面如果出现连续多个"/"会处理成一个"/"。参数的值可以是简单的字符串或数字，如 $ bcecmd bos cp localfile.txt bos:/mybucket/remotefile.txt。如果字符串中包含空格及特殊字符，在Linux中需要使用单引号，在Windows中需要使用双引号包围。如$ bcecmd bos cp 'my object 1' 'bos:/mybucket/my object 1' |
| +options | BOS命令的Option，取值为-r、-a或-s等。 | BOS各命令可配置的option不一样，详细的使用方法请参见各命令行解释。 |
CMD通用Option
-
查看帮助：可以在任意命令后面添加
-h或--help来查看该命令的帮助信息。Plain Text1$ bcecmd -h 2 $ bcecmd bos -h 3 $ bcecmd bos ls --help -
查看、设置AK、SK等配置信息：
-c/--configurePlain Text1$ bcecmd -c [<conf-path>] -
查看版本信息：
-v/--versionPlain Text1$ bcecmd -v -
查看debug信息：
-d/--debugPlain Text1$ bcecmd -d bos ls bos:/bce-test/pre/注意：
-d/--debug命令不能单独使用，必须与bos命令结合使用。 -
使用指定配置文件：
--conf-pathPlain Text1$ bcecmd --conf-path ./conf-sample/ bos ls bos:/bce-test/pre/注意： 不使用
--conf-path命令时，默认使用用户主目录~/.go-bcecli下的配置。 -
输出操作成功的日志信息：
--noticePlain Text1$ bcecmd bos --notice cp bos:/bce-test/pre/ ./local-dir/ -r 2 Download: bos:/bce-test/pre/file1 to ./local-dir/file1 3 Download: bos:/bce-test/pre/file2 to ./local-dir/file2 4 Download: bos:/bce-test/pre/file3 to ./local-dir/file3