控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

有奖征文|投稿上云技术实践,赢取价值5000元大奖> HOT

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

下载地址

Github 地址 国内站点
Windows Windows
Mac Mac
Linux Linux
说明:

当前版本号为v0.12.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.12.0-beta

Mac

  1. 运行以下命令下载 COSCLI:
    wget https://github.com/tencentyun/coscli/releases/download/v0.12.0-beta/coscli-mac
  2. 运行以下命令重命名文件:
    mv coscli-mac coscli
  3. 运行以下命令修改文件执行权限:
    chmod 755 coscli
  4. 在命令行中输入./coscli --version,若打印出以下信息则代表安装成功:
    coscli version v0.12.0-beta
    说明:

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

Linux

  1. 单击 下载 Linux 版本 COSCLI,或运行以下命令下载 COSCLI:
    wget https://github.com/tencentyun/coscli/releases/download/v0.12.0-beta/coscli-linux
  2. 运行以下命令重命名文件:
    mv coscli-linux coscli
  3. 运行以下命令修改文件执行权限:
    chmod 755 coscli
  4. 在命令行窗口中输入./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 NameAPP 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 命令

目录