./coscli --help 或 ./coscli -h 命令查看 COSCLI 支持的通用选项。
以下为 COSCLI 的通用选项,这些选项可以在工具的所有命令中使用:
注意:
建议用户通过 临时密钥 使用工具,通过临时授权的方式进一步提高工具使用的安全性。申请临时密钥时,请遵循 最小权限指引原则,防止泄露目标存储桶或对象之外的资源。
如果您一定要使用永久密钥,建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。
选项 | 说明 |
-h, --help | 输出帮助信息,用户可通过 -h 或 --help 命令来查看工具的 help 信息和用法。用户还可以在每个命令后(不加参数)输入 -h 查看该命令的具体用法,例如查看创建存储桶命令的具体用法,则输入 |
-c, --config-path | 配置文件路径,COSCLI 的默认配置文件路径为 |
-e, --endpoint | 除了在配置文件中提前配置存储桶的地域外,COSCLI 也支持在命令中通过 |
-i, --secret-id | 指定访问 COS 使用的密钥中的 SecretId |
-k, --secret-key | 指定访问 COS 使用的密钥中的 SecretKey |
--token | 用户通过临时密钥访问 COS |
-v, --version | 显示 COSCLI 的版本 |
-p, --protocol | 网络传输协议,默认为 https |
--init-skip | 默认为 false。设置为 true(--init-skip=true)则跳过 config init 交互式操作,直接使用参数中的 SecretId、SecretKey 及 endpoint 请求 api,使用此参数则-i、-k、-e参数必传 |
--log-path | 自定义 coscli.log 文件位置,默认在 COSCLI 的同级目录。可指定文件夹或具体文件(文件需以 |
--customized | 默认为 false,设置为 true 时启用自定义域名,需要通过--endpoint(-e)参数指定自定义域名 |
--disable-log | 默认为 false,设置为 true 时关闭 coscli.log 的生成及对应日志的输出 |
--bucket-type | 指定当前访问存储桶类型(COS/OFS) |
当用户需要通过 COSCLI 切换至另一个地域的存储桶时,可以通过 -e 选项指定该存储桶所属的 endpoint。
例如,将本地文件 test.txt 上传至成都地域的存储桶 examplebucket-1250000000,成都读取的 endpoint 为 cos.ap-chengdu.myqcloud.com,命令如下:./coscli cp test.txt cos://examplebucket-1250000000/test.txt -e cos.ap-chengdu.myqcloud.com
当用户需要使用另一个账号的身份时,也可以通过 -i 和 -k 选项分别指定用户密钥的 SecretId 和 SecretKey。
例如,使用另一个账号的身份列出成都地域下的存储桶 examplebucket-1250000000的文件列表,命令如下:./coscli ls cos://examplebucket-1250000000 -e cos.ap-chengdu.myqcloud.com -i ******************************** -k ********************************