COSCLI 工具提供 Windows、Mac、Linux 操作系统的二进制包，通过简单的安装和配置后即可使用。
下载地址
| Github 地址 | 国内站点 |
|---|---|
| Windows | Windows |
| Mac | Mac |
| Linux | Linux |
说明：当前版本号为v0.12.0-beta，如需获取工具的最新版本、历史版本和更新日志，请前往 release 进行查看。
安装
Windows
- 下载 Windows 版本 COSCLI。
- 将已下载的 COSCLI 可执行文件移动至
C:\Users\<用户名>目录下。 - 将
coscli-windows.exe重命名为coscli.exe。 - 按
win+r键打开运行程序。 - 在对话框中，输入
cmd，按Enter打开命令行窗口。 - 在命令行窗口中，输入
coscli --version，若打印出以下信息则代表安装成功：说明：在
Windows系统下，在不同的命令行客户端中使用 COSCLI 的方式可能略有不同，若输入coscli [command]后 COSCLI 无法正常工作，请尝试./coscli [command]的格式。coscli version v0.12.0-beta
Mac
- 运行以下命令下载 COSCLI：
wget https://github.com/tencentyun/coscli/releases/download/v0.12.0-beta/coscli-mac - 运行以下命令重命名文件：
mv coscli-mac coscli - 运行以下命令修改文件执行权限：
chmod 755 coscli - 在命令行中输入
./coscli --version，若打印出以下信息则代表安装成功：coscli version v0.12.0-beta说明：在 Mac 系统下使用 COSCLI 时，若弹出
无法打开“coscli”，因为无法验证开发者的提示，可以前往设置 > 安全性与隐私 > 通用中选择仍要打开 coscli，之后即可正常使用 COSCLI。
Linux
- 单击 下载 Linux 版本 COSCLI，或运行以下命令下载 COSCLI：
wget https://github.com/tencentyun/coscli/releases/download/v0.12.0-beta/coscli-linux - 运行以下命令重命名文件：
mv coscli-linux coscli - 运行以下命令修改文件执行权限：
chmod 755 coscli - 在命令行窗口中输入
./coscli --version，若打印出以下信息则代表安装成功：coscli version v0.12.0-beta
配置参数
您可以使用./coscli --help命令来快速查看 COSCLI 的使用方法。
初次使用时，COSCLI 会默认在~/.cos.yaml的位置生成配置文件，后续您也可以使用./coscli config init命令在其他位置为 COSCLI 交互式地生成配置文件。
配置文件中各配置项的说明如下：
| 配置项 | 说明 |
|---|---|
| Secret ID | 密钥 ID，可从 访问管理控制台 中创建并获取。 |
| Secret Key | 密钥 Key，可从 访问管理控制台 中创建并获取。 |
| Session Token | 临时密钥 token，当使用临时密钥时需要配置，若不使用可以直接按 Enter 跳过。 |
| APP ID | APP ID 是您在成功申请腾讯云账户后所得到的账号，由系统自动分配，可从 账号信息 中获取。一个存储桶的全称由Bucket Name和APP ID这两个元素组成，格式为<BucketName-APPID>，详情请参见 存储桶命名规范。 |
| Bucket Name | 存储桶名称，和 APP ID 一起构成存储桶全称，格式为<BucketName-APPID>，详情请参见 存储桶命名规范。 |
| Bucket Region | 存储桶所在地域，详情请参见 地域与访问域名。 |
| Bucket Alias | 存储桶别名，配置后可以在使用时用BucketAlias代替BucketName-APPID，减少所需输入的命令长度，如果不配置此项，BucketAlias的值是BucketName-APPID的值。 |
其他配置方法
除了使用./coscli config init交互式地生成配置文件外，您也可以直接手动编写 COSCLI 的配置文件，COSCLI 的配置文件格式是yaml格式，配置文件示例如下：
cos:
base:
secretid: XXXXXXXXXXXXXXX
secretkey: XXXXXXXXXXXXXXXXX
sessiontoken: ""
buckets:
- name: examplebucket1-1250000000
alias: bucket1
region: ap-shanghai
- name: examplebucket2-1250000000
alias: bucket2
region: ap-guangzhou
- name: examplebucket3-1250000000
alias: bucket3
region: ap-chengdu注意：COSCLI 默认从 ~/.cos.yaml 处读取配置项，若用户想要使用自定义的配置文件，请在命令后使用 -c （--config-path）选项。配置文件存储的 secretid/secretkey/sessiontoken 均为加密后的字符串。
配置多个存储桶
COSCLI 支持多个存储桶，然而在初次配置时，COSCLI 只会要求您配置一个存储桶的信息，您后续可以使用./coscli config add命令添加存储桶配置。
说明：更多有关配置文件的操作，请参考 config 命令。