tencent cloud

COSCLI 工具提供 Windows、Mac、Linux 操作系统的二进制包，通过简单的安装和配置后即可使用。

下载地址

Windows
Mac
Linux

说明：

当前版本号为v0.11.0-beta，如需获取工具的最新版本、历史版本和更新日志，请前往 release 进行查看。

安装

Windows

1. 下载 Windows 版本 COSCLI。
2. 将已下载的 COSCLI 可执行文件移动至C:\Users\<用户名>目录下。
3. 将coscli-windows.exe重命名为coscli.exe。
4. 按win+r键打开运行程序。
5. 在对话框中，输入cmd，按 Enter 打开命令行窗口。
6. 在命令行窗口中，输入coscli --version，若打印出以下信息则代表安装成功：

   说明：

   在Windows系统下，在不同的命令行客户端中使用 COSCLI 的方式可能略有不同，若输入coscli [command]后 COSCLI 无法正常工作，请尝试./coscli [command]的格式。

   coscli version v0.11.0-beta
   

Mac

1. 运行以下命令下载 COSCLI：

   wget https://github.com/tencentyun/coscli/releases/download/v0.11.0-beta/coscli-mac
   

2. 运行以下命令重命名文件：

   mv coscli-mac coscli
   

3. 运行以下命令修改文件执行权限：

   chmod 755 coscli
   

4. 在命令行中输入./coscli --version，若打印出以下信息则代表安装成功：

   coscli version v0.11.0-beta
   

说明：

在 Mac 系统下使用 COSCLI 时，若弹出无法打开“coscli”，因为无法验证开发者的提示，可以前往设置 > 安全性与隐私 > 通用中选择仍要打开 coscli，之后即可正常使用 COSCLI。

Linux

1. 单击 下载 Linux 版本 COSCLI，或运行以下命令下载 COSCLI：

   wget https://github.com/tencentyun/coscli/releases/download/v0.11.0-beta/coscli-linux
   

2. 运行以下命令重命名文件：

   mv coscli-linux coscli
   

3. 运行以下命令修改文件执行权限：

   chmod 755 coscli
   

4. 在命令行窗口中输入./coscli --version，若打印出以下信息则代表安装成功：

   coscli version v0.11.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）选项。

配置多个存储桶

COSCLI 支持多个存储桶，然而在初次配置时，COSCLI 只会要求您配置一个存储桶的信息，您后续可以使用./coscli config add命令添加存储桶配置。

说明：

更多有关配置文件的操作，请参考 config 命令。