配置参数
最近更新时间: 2023-03-22 09:41:33
查看 help 选项
用户可通过 -h 或 --help 命令来查看工具的 help 信息和用法：coscmd -h
除此之外，用户还可以在每个命令后（不加参数）输入 -h 查看该命令的具体用法，例如：
coscmd upload -h //查看 upload 命令使用方法
生成配置文件
COSCMD 工具在运行前会首先从配置文件中读取运行时所需的必要信息，COSCMD 会默认从 ~/.cos.conf 中读取配置项。
注意：配置前，您需要先在 COS 控制台创建一个用于配置参数的存储桶（例如 configure-bucket-1250000000），并创建密钥信息。
一个配置文件的示例如下所示：
[common]
secret_id = AKIDA6wUmImTMzvXZNbGLCgtusZ2E8mG**
secret_key = TghWBCyf5LIyTcXCoBdw1oRpytWk**
bucket = configure-bucket-1250000000
region = bj
max_thread = 5
part_size = 1
retry = 5
timeout = 60
schema = https
verify = md5
anonymous = False
说明：
配置文件中 schema 项，可选值为 http、https，默认为 https。
配置文件中 anonymous 项，可选值为 True、False，表示是否使用匿名模式，即签名保持为空。
更多配置参数说明，请使用命令 coscmd config -h 查看。
使用 config 命令生成配置文件
config 命令可以在 ~/.cos.conf 自动生成配置文件，命令具体格式如下：
coscmd config [OPTION]......
[-h] --help
[-a]
[-s]
[-t]
[-b]
[-r] | [-e]
[-m]
[-p]
[--do-not-use-ssl]
[--anonymous]
说明： 其中 "[]" 中的字段为选项， "<>" 的字段为需要填写的参数。
参数配置说明如下：
| 选项 | 参数说明 | 有效值 | 是否必选 |
|---|---|---|---|
| -a | 密钥 ID，请前往 控制台管理 中的密钥管理页面查看获取 | 字符串 | 是 |
| -s | 密钥 Key， 请前往 控制台管理 中的密钥管理页面查看获取 | 字符串 | 是 |
| -t | 临时密钥 token，当使用临时密钥时需要配置，设置 x-cos-security-token 头部 | 字符串 | 否 |
| -b | 指定的存储桶名称，存储桶的命名格式为 BucketName-APPID。初次配置使用时，您需要在 COS 控制台创建一个存储桶，用于配置工具 | 字符串 | 是 |
| -r | 存储桶所在地域，北京（bj）或武汉（wh） | 字符串 | 是 |
| -e | 设置请求的 ENDPOINT | 字符串 | 否 |
| -m | 多线程操作的最大线程数（默认为5，范围为1 - 30） | 数字 | 否 |
| -p | 分块操作的单块大小（单位MB，默认为1MB，范围为1 - 1000） | 数字 | 否 |
| --do-not-use-ssl | 使用 HTTP 协议，而不使用 HTTPS | 字符串 | 否 |
| --anonymous | 匿名操作（不携带签名） | 字符串 | 否 |
config 命令的使用示例如下：
coscmd config -a AChT4ThiXAbpBDEFGhT4ThiXAbp** -s WE54wreefvds3462refgwewe** -b configure-bucket-1250000000 -r bj