tencent cloud

文档反馈

通用选项

最后更新时间:2024-01-06 10:43:44
    您可以通过./coscli --help./coscli -h命令查看 COSCLI 支持的通用选项。

    选项说明

    以下为 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-guangzhouap-beijing等,COS 支持的地域列表可参见 地域与访问域名
    -i, --sercret-id
    指定访问 COS 使用的密钥中的 SecretId
    -k, --sercret-key
    指定访问 COS 使用的密钥中的 SercretKey
    -t, --sesssion-token
    若用户通过临时密钥访问 COS,可通过-t指定临时密钥中的 token
    -v, --version
    显示 COSCLI 的版本

    操作示例

    示例1:切换存储桶并上传对象

    当用户需要通过 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

    示例2:切换用户账号查看文件列表

    当用户需要使用另一个账号的身份时,也可以通过 -i 和 -k 选项分别指定用户密钥的 SecretId 和 SecretKey。
    例如,使用另一个账号的身份列出成都地域下的存储桶 examplebucket-1250000000 的文件列表,命令如下:
    ./coscli ls cos://examplebucket-1250000000 -e cos.ap-chengdu.myqcloud.com -i AKIDYv3vWrwkHXVDfqkNjoc9PP8anjOm**** -k 4rNbYF1XmmVw67rKWTBernUu66u****
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持