腾讯云客户端tccli工具使用

腾讯云命令行工具 TCCLI 是管理腾讯云资源的统一工具。通过腾讯云命令行工具,可以快速轻松的调用腾讯云 API 来管理腾讯云资源。还可以基于腾讯云的命令行工具来做自动化和脚本处理,能够以更多样的方式进行组合和重用。

腾讯云 TCCLI 包含基础功能和高级功能,请参见下表:

功能描述
基础功能
  • 配置 TCCLI

  • helper 信息支持中文信息

  • 支持 JSON、table 及 text 输出格式

高级功能
  • 多版本接口访问

  • 指定最近的接入点(Endpoint)

  • 返回结果过滤

  • 支持输出入参数据结构到 JSON 文件

  • 支持从 JSON 文件读取参数调用

  • 复杂类型点(.)连接展开方式调用

安装 TCCLI

  1. 安装 Python 环境和 pip 工具,安装命令行工具前请确保您的系统已经安装了 Python 环境和 pip 工具。详情请参见 Python SDK 文档。

  • Python 版本必须为2.7及以上版本,更多内容请参考 Python 和 pip 官网文档。

  • TCCLI 依赖于 TencentCloudApi Python SDK,如果 TencentCloudApi Python SDK 的版本号小于要安装 TCCLI 版本号,在安装 TCCLI 时会自动升级 TencentCloudApi Python SDK。

  1. Windows 系统按 Win+R 打开运行窗口输入 cmd 并单击【确定】,本文以 Linux 为例。

  2. 在命令行窗口中,执行以下命令进行 TCCLI 安装。

pip install tccli

! 3.0.252.3以下版本升级需要执行以下代码:

sudo pip uninstall tccli jmespath
sudo pip install tccli
  1. 执行以下命令,查看 TCCLI 是否安装成功。

tccli --version

返回类似如下结果,则说明已成功安装 TCCLI。

[root@VM_180_248_centos ~]# tccli --version3.0.250.1
  1. 在 Linux 环境中,执行以下命令启动自动补全功能,支持大小写自动纠错:

complete -C 'tccli_completer' tccli

以下代码片段展示自动补全过程:

[root@VM_33_50_centos ~]# tccli ccam          cbs          cdn          chdfs        ckafka       cloudhsm     cms          cr           cynosdb 
captcha      ccc          cds          cim          clb          cme          configure    cvm          
cat          cdb          cfs          cis          cloudaudit   cmq          cpdp         cws          
[root@VM_33_50_centos ~]# tccli cvm RRebootInstances                      ResetInstance                        ResetInstancesType 
RenewHosts                           ResetInstancesInternetMaxBandwidth   ResizeInstanceDisks 
RenewInstances                       ResetInstancesPassword               RunInstances 
[root@VM_33_50_centos ~]# tccli cvm RunInstances ----ActionTimer               --generate-cli-skeleton     --InstanceType              --SecurityGroupIds 
--ClientToken               --HostName                  --InternetAccessible        --SystemDisk 
--cli-input-json            --HpcClusterId              --LoginSettings             --TagSpecification 
--DataDisks                 --ImageId                   --output                    --timeout 
--DisasterRecoverGroupIds   --InstanceChargePrepaid     --Placement                 --UserData 
--DryRun                    --InstanceChargeType        --profile                   --version 
--endpoint                  --InstanceCount             --region                    --VirtualPrivateCloud 
--EnhancedService           --InstanceMarketOptions     --secretId                  
--filter                    --InstanceName              --secretKey                 
[root@VM_33_50_centos ~]# tccli cvm RunInstances --Placement

配置 TCCLI

  1. 在命令行中执行以下命令,进入交互模式快配置。

tccli configure

返回结果如下,请参考以下信息进行配置:

 TencentCloud API secretId [*afcQ]:
 TencentCloud API secretKey [*ArFd]:
 region: 
 output[json]:
  • secretId:云 API 密钥 SecretId,请前往 API 密钥管理 获取(一个主账号最多可以申请两个云 API 密钥)。

  • secretKey:云 API 密钥 SecretKey,请前往 API 密钥管理 获取。

  • region: 云产品地域,请前往对应云产品的 API 文档 获取可用的 region。例如云服务器的 地域列表

  • output: 可选参数,请求回包输出格式,支持 JSON、table 及 text 三种格式,默认为 JSON。 更多信息请执行 tccli configure help 命令查看。

  1. 您可执行以下命令进入命令行模式,通过命令行模式您可以在自动化脚本中配置您的信息。

 # set子命令可以设置某一配置,也可同时配置多个。
 tccli configure set secretId AKIDwLw1234***********nR2OTI787aBCDP
 tccli configure set region ap-guangzhou  output json # get子命令用于获取配置信息。
 tccli configure get secretKey
 secretKey = OxXj7khcV1234*********dCc1LiArFd # list子命令打印所有配置信息。
 tccli configure list
 credential:
 secretId =  AKIDwLw1234**********nR2OTI787aBCDP
 secretKey =  OxXj7khcV1234*********dCc1LiArFd
 configure:
 region =  ap-guangzhou
 output =  json

更多信息请执行 tccli configure [list、get 或 set] help 查看,例如 tccli configure list help。 3. 您可执行以下命令配置多账户支持,方便您在多种配置同时使用。

 # 在交互模式中指定账户名 test。
 $ tccli configure --profile test
 TencentCloud API secretId [*BCDP]:AKIDwLw1234***********R2OTI787aBCDP
 TencentCloud API secretKey [*ArFd]:OxXj7khcV1234*********dCc1LiArFd
 region: ap-guangzhou
 output[json]: # set/get/list子命令指定账户名 test。此命令与上条命令作用相同
 $ tccli configure set region ap-guangzhou  output json secretId AKIDwLw1234***********R2OTI787aBCDP secretKey OxXj7khcV1234*********dCc1LiArFd --profile test
 # 已可以修改单独一个,例如修改地域:
 $ tccli configure set region ap-beijing # 查看test用户密钥key或查看配置, 使用命令如下:
 $ tccli configure get secretKey --profile test
 $ tccli configure list --profile test
 # 在调用接口时指定账户(以 cvm DescribeZones 接口为例)。
 $ tccli cvm DescribeZones --profile test

使用 TCCLI

基础功能

TCCLI 支持自主配置,helper 信息支持中文信息且支持 JSON、table 及 text 输出格式。

! 请注意示例中非简单类型的参数必须为标准 JSON 格式。

TCCLI 目前支持以下三种调用方式:

  • JSON 字符串入参调用

  • JSON 文件入参调用 --cli-input-json

  • 复杂类型点(.)连接展开形式入参调用 --cli-unfold-argument

JSON 字符串入参调用示例

  • 执行以下命令,创建一台 CVM。

$ tccli cvm RunInstances --InstanceChargeType POSTPAID_BY_HOUR --InstanceChargePrepaid '{"Period":1,"RenewFlag":"DISABLE_NOTIFY_AND_MANUAL_RENEW"}' --Placement '{"Zone":"ap-guangzhou-2"}' --InstanceType S1.SMALL1 --ImageId img-8toqc6s3 --SystemDisk '{"DiskType":"CLOUD_BASIC", "DiskSize":50}' --InternetAccessible '{"InternetChargeType":"TRAFFIC_POSTPAID_BY_HOUR","InternetMaxBandwidthOut":10,"PublicIpAssigned":true}' --InstanceCount 1 --InstanceName TCCLI-TEST --LoginSettings '{"Password":"isd@cloud"}' --SecurityGroupIds '["sg-0rszg2vb"]' --HostName TCCLI-HOST-NAME1
  • 执行以下命令,获取云产品 CVM 的监控数据。

[root@VM_33_50_centos ~]# tccli monitor GetMonitorData --Namespace "QCE/CVM" --Period 300 --MetricName "CPUUsage" --Instances '[{"Dimensions":[{"Name":"InstanceId","Value":"ins-cac6a4w8"}]}]'

JSON 文件入参调用(--cli-input-json)示例

  1. 执行以下命令,输出入参数据结构到 JSON 文件。

[root@VM_33_50_centos ~]# tccli cvm RunInstances  --generate-cli-skeleton > /tmp/RunInstances.json
  1. 将文件中参数值替换为实际使用值,并使用该 JSON 文件作为入参,格式为 --cli-input-json 后接 file://+文件路径。示例如下:

[root@VM_33_50_centos ~]# tccli cvm RunInstances --cli-input-json file:///tmp/RunInstances.json{        "RequestId": "20e2b42d-3260-4750-9293-79116208330e", 
        "InstanceIdSet": null
}

复杂类型点(.)连接展开形式入参调用(--cli-unfold-argument)示例

复杂类型点连接展开调用是将复杂类型按用点连接的形式展开,此方式可充分利用命令行自动补全机制来解决入参较复杂时的命令行输入困难,且易出错问题。展开方式如下: 复杂类型 {"a":{"b": "c"}} 展开为 --a.b c。复杂类型数组使用.0 .1表示数组的第一个、第二个元素。基本类型数组不需要使用.0.1,直接将数组多个元素用空格隔开依次输入,例如 --Integer 10 20--String str1 str2

执行以下命令,创建一台 CVM。

[root@VM_33_50_centos ~]# tccli cvm RunInstances --cli-unfold-argument --InstanceChargeType POSTPAID_BY_HOUR --InstanceChargePrepaid.Period 1 --InstanceChargePrepaid.RenewFlag DISABLE_NOTIFY_AND_MANUAL_RENEW --Placement.Zone ap-guangzhou-2 --InstanceType S1.SMALL1 --ImageId img-8toqc6s3 --SystemDisk.DiskType CLOUD_BASIC --SystemDisk.DiskSize 50 --InternetAccessible.InternetChargeType TRAFFIC_POSTPAID_BY_HOUR --InternetAccessible.InternetMaxBandwidthOut 10 --InternetAccessible.PublicIpAssigned True --InstanceCount 1 --InstanceName TCCLI-TEST --LoginSettings.Password isd@cloud --SecurityGroupIds sg-0rszg2vb --HostName TCCLI-HOST-NAME1

更多使用示例

您还可通过以下命令,进一步使用 TCCLI:

  • 执行 tccli help 命令,查看支持的产品,支持中文。

[root@VM_33_50_centos ~]# tccli helpNAME
    tccli
DESCRIPTION
    tccli (Tencent Cloud Command Line Interface) is a tool to manage your Tencent Cloud services.
CONFIGURE
    Before using tccli, you should use the command(tccli configure) to configure your profile as the default For more in
    formation, please enter tccli configure helpUSEAGE
    tccli [options] <service> [options] <action> [options] [options and parameters]
OPTIONS    help
    show the tccli help info
    --version
    show the version of tccli
AVAILABLE SERVICES
    af
    介绍如何使用API对借贷反欺诈进行操作,包括借贷反欺诈等。
    afc
    介绍如何使用API对定制建模进行操作,包括定制建模等。
    ame
    介绍如何使用API对正版曲库直通车进行操作,包括素材获取、数据上报等。
    ......
  • 执行 tccli cvm help 命令,查看产品支持的接口。本文以 CVM 为例。

[root@VM_33_50_centos ~]# tccli cvm helpNAME
    cvm
AVAILABLE VERSIONS
    2017-03-12
    默认只展示最新版本信息,查看其它版本帮助信息加 --version xxxx-xx-xx
DESCRIPTION
    cvm-2017-03-12
    介绍如何使用API对云服务器进行操作,包括使用并管理实例、镜像、密钥等资源。
USEAGE
    tccli cvm <action> [--param...]
OPTIONS    help
    show the tccli cvm help info
AVAILABLE ACTIONS
    AllocateHosts
    创建CDH实例
    AssociateInstancesKeyPairs
    绑定密钥对
    AssociateSecurityGroups
    绑定安全组
    ......
  • 执行 tccli cbs DescribeDisks help 命令,查看接口支持的参数。本文以 CBS 的 DescribeDisks 接口为例。

[root@VM_33_50_centos ~]# tccli cbs DescribeDisks helpNAME
    DescribeDisks
DESCRIPTION
    cbs-2017-03-12-DescribeDisks
    本接口(DescribeDisks)用于查询云硬盘列表。    * 可以根据云硬盘ID、云硬盘类型或者云硬盘状态等信息来查询云硬盘的详细信息,不同条件之间为与(AND)的关系,过滤信息详细请
    见过滤器`Filter`。    * 如果参数为空,返回当前用户一定数量(`Limit`所指定的数量,默认为20)的云硬盘列表。
USEAGE
    tccli cbs DescribeDisks [--param...]
OPTIONS    help
    show the tccli cbs DescribeDisks help info
    --region
    identify the region to which the instance you want to work with belongs.
    --timeout
    specify a request timeout
    --secretKey
    specify a SecretKey
    ......  
AVAILABLE PARAMS
    --Limit (Integer | Optional)
    返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](/document/product/362/15633)中的相关小节。
    --OrderField (String | Optional)
    云盘列表排序的依据字段。取值范围:<br><li>CREATE_TIME:依据云盘的创建时间排序<br><li>DEADLINE:依据云盘的到期时间排序    <br>默认按云盘创建时间排序。
    --Offset (Integer | Optional)
    偏移量,默认为0。关于`Offset`的更进一步介绍请参考API[简介](/document/product/362/15633)中的相关小节。
    ......
  • 输出格式支持 JSON、table 及 text 格式。

    • JSON 格式

[root@VM_33_50_centos ~]# tccli cvm DescribeRegions {    "TotalCount": 20, 
    "RegionSet": [
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-beijing", 
            "RegionName": "华北地区(北京)"
        }, 
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-chengdu", 
            "RegionName": "西南地区(成都)"
        },
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-guangzhou", 
            "RegionName": "华南地区(广州)"
        }, 
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-hongkong", 
            "RegionName": "港澳台地区(中国香港)"
        },  
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-singapore", 
            "RegionName": "东南亚地区(新加坡)"
        }, 
        {            "RegionState": "AVAILABLE", 
            "Region": "ap-tokyo", 
            "RegionName": "亚太地区(东京)"
        }, 
        {            "RegionState": "AVAILABLE", 
            "Region": "eu-frankfurt", 
            "RegionName": "欧洲地区(法兰克福)"
        }, 
        ......
    ], 
    "RequestId": "e5125cf1-****-****-****-316f18eed021"}
  • table 格式

[root@VM_33_50_centos ~]# tccli cvm DescribeRegions --output table--|                        action                        |+---------------------------------------+--------------+|               RequestId               | TotalCount   |+---------------------------------------+--------------+|  1af5f2a0-****-****-****-462f0271a69f |  20          |+---------------------------------------+--------------+||                      RegionSet                     |||+-------------------+----------------+---------------+|||      Region       |  RegionName    |  RegionState  |||+-------------------+----------------+---------------+|||  ap-bangkok       |  亚太地区(曼谷)      |  AVAILABLE    ||||  ap-beijing       |  华北地区(北京)      |  AVAILABLE    ||||  ap-chengdu       |  西南地区(成都)      |  AVAILABLE    ||||  ap-chongqing     |  西南地区(重庆)      |  AVAILABLE    ||||  ap-guangzhou     |  华南地区(广州)      |  AVAILABLE    ||||  ap-guangzhou-open|  华南地区(广州Open)  |  AVAILABLE    ||||  ap-hongkong      |  港澳台地区(中国香港)   |  AVAILABLE    ||||  ap-mumbai        |  亚太地区(孟买)      |  AVAILABLE    ||||  ap-nanjing       |  华东地区(南京)      |  AVAILABLE    ||||  ap-seoul         |  亚太地区(首尔)      |  AVAILABLE    ||||  ap-shanghai      |  华东地区(上海)      |  AVAILABLE    ||||  ap-shanghai-fsi  |  华东地区(上海金融)    |  AVAILABLE    ||||  ap-shenzhen-fsi  |  华南地区(深圳金融)    |  AVAILABLE    ||||  ap-singapore     |  东南亚地区(新加坡)    |  AVAILABLE    ||||  ap-tokyo         |  亚太地区(东京)      |  AVAILABLE    ||||  eu-frankfurt     |  欧洲地区(法兰克福)    |  AVAILABLE    ||||  eu-moscow        |  欧洲地区(莫斯科)     |  AVAILABLE    ||||  na-ashburn       |  美国东部(弗吉尼亚)    |  AVAILABLE    ||||  na-siliconvalley |  美国西部(硅谷)      |  AVAILABLE    ||||  na-toronto       |  北美地区(多伦多)     |  AVAILABLE    |||+-------------------+----------------+---------------+|
  • text 格式

[root@VM_33_50_centos ~]# tccli cvm DescribeRegions --output text70bbd02f-****-****-****-afc5c34018ae    20
REGIONSET       ap-bangkok      亚太地区(曼谷)  AVAILABLE
REGIONSET       ap-beijing      华北地区(北京)  AVAILABLE
REGIONSET       ap-chengdu      西南地区(成都)  AVAILABLE
REGIONSET       ap-chongqing    西南地区(重庆)  AVAILABLE
REGIONSET       ap-guangzhou    华南地区(广州)  AVAILABLE
REGIONSET       ap-guangzhou-open       华南地区(广州Open)      AVAILABLE
REGIONSET       ap-hongkong     港澳台地区(中国香港)    AVAILABLE
REGIONSET       ap-mumbai       亚太地区(孟买)  AVAILABLE
REGIONSET       ap-nanjing      华东地区(南京)  AVAILABLE
REGIONSET       ap-seoul        亚太地区(首尔)  AVAILABLE
REGIONSET       ap-shanghai     华东地区(上海)  AVAILABLE
REGIONSET       ap-shanghai-fsi 华东地区(上海金融)      AVAILABLE
REGIONSET       ap-shenzhen-fsi 华南地区(深圳金融)      AVAILABLE
REGIONSET       ap-singapore    东南亚地区(新加坡)      AVAILABLE
REGIONSET       ap-tokyo        亚太地区(东京)  AVAILABLE
REGIONSET       eu-frankfurt    欧洲地区(法兰克福)      AVAILABLE
REGIONSET       eu-moscow       欧洲地区(莫斯科)        AVAILABLE
REGIONSET       na-ashburn      美国东部(弗吉尼亚)      AVAILABLE
REGIONSET       na-siliconvalley        美国西部(硅谷)  AVAILABLE
REGIONSET       na-toronto      北美地区(多伦多)        AVAILABLE

高级功能

该步骤以 CVM 为例,详细介绍了如何使用 TCCLI 高级功能,包括多版本接口访问、指定最近的接入点、返回结果过滤、输出入参数据结构到 JSON 文件以及从 JSON 文件读取参数等。

多版本接口访问

某些产品可能存在多个版本的接口,TCCLI 默认访问最新版本的接口。如果您想访问特定旧版本的接口,可以通过以下方式实现:

  • 方式1:设置 CVM 产品默认使用版本:2017-03-12

tccli configure set cvm.version 2017-03-12
  • 方式2:在实时使用时指定版本号

tccli cvm help --version 2017-03-12
tccli cvm DescribeZones help --version 2017-03-12
tccli cvm DescribeZones --version 2017-03-12

指定最近的接入点(Endpoint)

TCCLI 默认会请求就近的接口点访问服务,您也可以针对某一产品指定自己的 Endpoint。

  • 设置 CVM 产品默认 endpoint

tccli configure set cvm.endpoint cvm.ap-guangzhou.tencentcloudapi.com
  • 调用时实时指定

tccli cvm DescribeZones --endpoint cvm.ap-guangzhou.tencentcloudapi.com

返回结果过滤

  • 以 CVM DescribeZones 接口的返回为例,不加任何过滤时的输出。

   [root@VM_180_248_centos ~]# tccli cvm DescribeZones
   {    "TotalCount": 4,    "ZoneSet": [
        {            "ZoneState": "AVAILABLE",            "ZoneId": "100001",            "Zone": "ap-guangzhou-1",            "ZoneName": "广州一区"
        },
        {            "ZoneState": "AVAILABLE",            "ZoneId": "100002",            "Zone": "ap-guangzhou-2",            "ZoneName": "广州二区"
        },
        {            "ZoneState": "AVAILABLE",            "ZoneId": "100003",            "Zone": "ap-guangzhou-3",            "ZoneName": "广州三区"
        },
        {            "ZoneState": "AVAILABLE",            "ZoneId": "100004",            "Zone": "ap-guangzhou-4",            "ZoneName": "广州四区"
        }
    ],    "RequestId": "4fd313a6-****-****-****-898c02fcae02"
   }
  • 仅查看某个字段。

[root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter TotalCount4
  • 指定某个数组类型对象的第 N 个子对象的信息。

 [root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter ZoneSet[0]
 {	"ZoneState": "AVAILABLE",	"ZoneId": "100001",	"Zone": "ap-guangzhou-1",	"ZoneName": "广州一区"
 }
  • 指定数组类型对象下所有某个名称的子对象的某个字段。

   [root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter ZoneSet[*].ZoneName
   [    "广州一区",    "广州二区",    "广州三区",    "广州四区"
   ]
  • 过滤数组里的子对象,同时还以新的名称展示。

!需要将说明过滤行为的内容用单引号包裹起来。

   [root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter 'ZoneSet[*].{name:ZoneName, id:ZoneId}'
    [
            {                    "name": "广州一区",                    "id": "100001"
            },
            {                    "name": "广州二区",                    "id": "100002"
            },
            {                    "name": "广州三区",                    "id": "100003"
            },
            {                    "name": "广州四区",                    "id": "100004"
            }
    ]

使用示例

# 根据实例名查其IP
tccli cvm DescribeInstances  --Filters '[{"Name":"instance-name","Values":["qcbjg-xxx-vm"]}]' --filter 'InstanceSet[*]' |jq -r '.[].InstanceName,.[].PrivateIpAddresses[0]'|xargs
qcbjg-xxx-vm 10.23.11.110
tccli cvm DescribeInstances --cli-unfold-argument --region ap-beijing --Filters.0.Name instance-name --Filters.0.Values qcbjg-xxx-vm

相关问题

如何购买命令行工具?

本服务免费。当您遇到问题时,请 联系我们 寻求相应的帮助。

如何实现接口鉴权?

在 API 支持的每个产品文档目录下,可选择【调用方法】>【接口鉴权】,结合产品的“接口鉴权”文档进行实现。例如,可前往 CVM 接口鉴权 进行查看。



参考:阿里云客户端aliyun-cli使用

anzhihe安志合个人博客,版权所有丨 如未注明,均为原创 丨转载请注明转自:https://chegva.com/4366.html | ☆★★每天进步一点点,加油!★★☆

您可能还感兴趣的文章!

发表评论

电子邮件地址不会被公开。 必填项已用*标注