一、选项说明
以下为 COSCLI 的通用选项，这些选项可以在工具的所有命令中使用：
| 选项 | 说明 |
| -h, –help | 输出帮助信息，用户可通过 -h 或 –help 命令来查看工具的 help 信息和用法。用户还可以在每个命令后（不加参数）输入 -h 查看该命令的具体用法，例如查看创建存储桶命令的具体用法，则输入 ./coscli mb -h |
| -c, –config-path | 配置文件路径，COSCLI 的默认配置文件路径为 ~/.cos.yaml，同时支持用户自定义配置文件，在命令后使用 -c 可指定配置文件 |
| -e, –endpoint | 除了在配置文件中提前配置存储桶的地域外，COSCLI 也支持在命令中通过 -e 指定存储桶的 endpoint，endpoint 形如 cos.<region>.myqcloud.com，其中<region>代表存储桶地域，如 ap-guangzhou、ap-beijing 等，COS 支持的地域列表可参见 地域与访问域名 |
| -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 的同级目录。可指定文件夹或具体文件（文件需以.log结尾），例如：/data/ 或 /data/coscli.log |
| –customized | 默认为 false，设置为 true 时启用自定义域名，需要通过–endpoint（-e）参数指定自定义域名 |
| –disable-log | 默认为 false，设置为 true 时关闭 coscli.log 的生成及对应日志的输出 |
| –bucket-type | 指定当前访问存储桶类型（COS/OFS） |
| –proxy | 指定访问 COS 所使用的代理地址 |
二、示例一：切换存储桶并上传对象
当用户需要通过 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 ********************************
四、示例三：使用自定义域名访问 COS
当用户需要使用自定义域名访问 COS 时，可以指定 -e 和 –customized 选项来实现。
例如，使用www.example.com自定义域名访问 COS，命令如下：
./coscli ls cos://examplebucket-1250000000 -e www.example.com –customized