一、命令格式
注意:说明:
config 命令包含以下子命令:
| command 名称 | command 用途 |
| add | 添加一个新的存储桶配置。 |
| delete | 删除一个已经存在的存储桶配置。 |
| init | 交互式地生成配置文件。 |
| set | 修改配置文件 base 组中的一个或多个配置项。base 组包含 secretid、secretkey、sessiontoken、mode、cvmrolename 信息。 |
| show | 打印指定配置文件中的信息。 |
config 及其子命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法。 |
| -c | –config-path | 指定要使用的配置文件路径。 |
config add 子命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法。 |
| -a | –alias | 存储桶别名。 |
| -b | –bucket | 存储桶名称。 |
| -r | –region | 存储桶地域。 |
| -o | –ofs | 元数据加速桶标记。详情请参见 元数据加速概览。 |
| 无 | –customized | 设置存储桶是否使用自定义 endpoint(自定义域名),默认 false。当存储桶配置 customized: true 时,访问该存储桶将直接使用配置的 endpoint 作为域名,而非拼接 bucket-appid 的域名(1.0.9版本以上支持)。 |
注意:如果你需要指定存储桶的 endpoint,可以使用通用 flag -e 或 –endpoint,详见 通用选项介绍。
config delete 子命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法。 |
| -a | –alias | 存储桶别名。 |
config set 子命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法。 |
| 无 | –secret_id | 设置 secret ID。可从 访问管理控制台 中创建并获取。 |
| 无 | –secret_key | 设置 secret key。可从 访问管理控制台 中创建并获取。 |
| -t | –session_token | 设置临时密钥 token。关于临时密钥的更多信息,请参见 使用临时密钥访问 COS。 |
| 无 | –mode | 设置身份模式,支持枚举值 SecretKey 和 CvmRole。可以为空,空值默认为 SecretKey,表示使用密钥请求 COS。当 mode 为 CvmRole 时,表示用 管理实例角色 请求 COS。 |
| 无 | –cvm_role_name | 设置 CVM 角色实例名称,详情请参见 管理实例角色。 |
| 无 | –close_auto_switch_host | 设置是否关闭自动切换备份域名。可选值 true、false,可以为空 。若不设置或值为 false,则会进行备份域名切换。若设置为 true,则不进行备份域名切换。 |
| 无 | –disable_encryption | 设置是否关闭密钥加密。默认为 false,若设置为 true,则不加密配置文件中的密钥相关信息。 |
| 无 | –disable_auto_fetch_bucket_type | 设置是否禁用自动获取存储桶类型,可选值 true、false。若不设置或值为 false,则会自动获取存储桶类型(请确保你所使用的账号已拥有 cos:HeadBucket 权限)。若设置为 true,则不自动获取存储桶类型,会使用用户配置文件中的存储桶类型(例如配置文件中 Bucket 配置项 ofs 设置为 true,则存储桶类型为 ofs;若设置为 false,则存储桶类型为 cos) |
| 无 | –service_domain | 列举存储桶(Service 请求)使用的默认 service 域名,例如 service.cos.myqcloud.com(1.0.9版本以上支持) |
| 无 | –proxy | 访问 COS 使用的代理地址,例如 http://127.0.0.1:8080(1.0.9版本以上支持) |
二、添加一个新的存储桶配置
./coscli config add -b examplebucket3-1250000000 -r ap-chengdu -e cos.ap-chengdu.myqcloud.com -a bucket3
三、删除一个已经存在的存储桶配置
./coscli config delete -a bucket3
四、修改默认配置文件中的 session-token
./coscli config set –session_token test-token123
五、打印指定配置文件中的信息
./coscli config show -c /your/config/path.yaml
六、修改默认配置文件中的 mode 和 cvmrolename
./coscli config set –mode CvmRole –cvm_role_name testName