产品概述
应用场景
pip install tccli
sudo pip uninstall tccli jmespathsudo pip install tccli
tccli --version
[root@VM_180_248_centos ~]# tccli --version3.0.250.1
complete -C 'tccli_completer' tccli
[root@VM_33_50_centos ~]# tccli ccam cbs cdn chdfs ckafka cloudhsm cms cr cynosdbcaptcha ccc cds cim clb cme configure cvmcat cdb cfs cis cloudaudit cmq cpdp cws[root@VM_33_50_centos ~]# tccli cvm RRebootInstances ResetInstance ResetInstancesTypeRenewHosts ResetInstancesInternetMaxBandwidth ResizeInstanceDisksRenewInstances 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 configure
TencentCloud API secretId [*afcQ]:TencentCloud API secretKey [*ArFd]:region:output[json]:
tccli configure help 命令查看。# set子命令可以设置某一配置，也可同时配置多个。tccli configure set secretId AKIDwLw1234***********nR2OTI787aBCDPtccli configure set region ap-guangzhou output json# get子命令用于获取配置信息。tccli configure get secretKeysecretKey = OxXj7khcV1234*********dCc1LiArFd# list子命令打印所有配置信息。tccli configure listcredential:secretId = AKIDwLw1234**********nR2OTI787aBCDPsecretKey = OxXj7khcV1234*********dCc1LiArFdconfigure:region = ap-guangzhououtput = json
tccli configure [list、get 或 set] help 查看，例如 tccli configure list help。 # 在交互模式中指定账户名 test。$ tccli configure --profile testTencentCloud API secretId [*BCDP]:AKIDwLw1234***********R2OTI787aBCDPTencentCloud API secretKey [*ArFd]:OxXj7khcV1234*********dCc1LiArFdregion: ap-guangzhououtput[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
--cli-input-json)--cli-unfold-argument)$ tccli cvm RunInstances --InstanceChargeType POSTPAID_BY_HOUR --InstanceChargePrepaid '{"Period":1,"RenewFlag":"DISABLE_NOTIFY_AND_MANUAL_RENEW"}' --Placement '{"Zone":"ap-guangzhou-1"}' --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
[root@VM_33_50_centos ~]# tccli monitor GetMonitorData --Namespace "QCE/CVM" --Period 300 --MetricName "CPUUsage" --Instances '[{"Dimensions":[{"Name":"InstanceId","Value":"ins-cac6a4w8"}]}]'
[root@VM_33_50_centos ~]# tccli cvm RunInstances --generate-cli-skeleton > /tmp/RunInstances.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}
{"a":{"b": "c"}} 展开为 --a.b c。复杂类型数组使用.0， .1表示数组的第一个、第二个元素。基本类型数组不需要使用.0，.1，直接将数组多个元素用空格隔开依次输入，例如 --Integer 10 20，--String str1 str2。[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-1 --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 help 命令，查看支持的产品，支持中文。[root@VM_33_50_centos ~]# tccli helpNAMEtccliDESCRIPTIONtccli (Tencent Cloud Command Line Interface) is a tool to manage your Tencent Cloud services.CONFIGUREBefore using tccli, you should use the command(tccli configure) to configure your profile as the default For more information, please enter tccli configure helpUSEAGEtccli [options] <service> [options] <action> [options] [options and parameters]OPTIONShelpshow the tccli help info--versionshow the version of tccliAVAILABLE SERVICESaf介绍如何使用API对借贷反欺诈进行操作，包括借贷反欺诈等。afc介绍如何使用API对定制建模进行操作，包括定制建模等。ame介绍如何使用API对正版曲库直通车进行操作，包括素材获取、数据上报等。......
tccli cvm help 命令，查看产品支持的接口。[root@VM_33_50_centos ~]# tccli cvm helpNAMEcvmAVAILABLE VERSIONS2017-03-12默认只展示最新版本信息，查看其它版本帮助信息加 --version xxxx-xx-xxDESCRIPTIONcvm-2017-03-12介绍如何使用API对云服务器进行操作，包括使用并管理实例、镜像、密钥等资源。USEAGEtccli cvm <action> [--param...]OPTIONShelpshow the tccli cvm help infoAVAILABLE ACTIONSAllocateHosts创建CDH实例AssociateInstancesKeyPairs绑定密钥对AssociateSecurityGroups绑定安全组......
tccli cbs DescribeDisks help 命令，查看接口支持的参数。本文以 CBS 的 DescribeDisks 接口为例。[root@VM_33_50_centos ~]# tccli cbs DescribeDisks helpNAMEDescribeDisksDESCRIPTIONcbs-2017-03-12-DescribeDisks本接口（DescribeDisks）用于查询云硬盘列表。* 可以根据云硬盘ID、云硬盘类型或者云硬盘状态等信息来查询云硬盘的详细信息，不同条件之间为与(AND)的关系，过滤信息详细请见过滤器`Filter`。* 如果参数为空，返回当前用户一定数量（`Limit`所指定的数量，默认为20）的云硬盘列表。USEAGEtccli cbs DescribeDisks [--param...]OPTIONShelpshow the tccli cbs DescribeDisks help info--regionidentify the region to which the instance you want to work with belongs.--timeoutspecify a request timeout--secretKeyspecify a SecretKey......AVAILABLE PARAMS--Limit (Integer | Optional)返回数量，默认为20，最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://www.tencentcloud.com/document/product/362/15633)中的相关小节。--OrderField (String | Optional)云盘列表排序的依据字段。取值范围：<br><li>CREATE_TIME：依据云盘的创建时间排序<br><li>DEADLINE：依据云盘的到期时间排序<br>默认按云盘创建时间排序。--Offset (Integer | Optional)偏移量，默认为0。关于`Offset`的更进一步介绍请参考API[简介](https://www.tencentcloud.com/document/product/362/15633)中的相关小节。......
[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"}
[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-nanjing | 华东地区(南京) | AVAILABLE |||| ap-seoul | 亚太地区(首尔) | AVAILABLE |||| ap-shanghai | 华东地区(上海) | AVAILABLE |||| ap-singapore | 东南亚地区(新加坡) | AVAILABLE |||| ap-tokyo | 亚太地区(东京) | AVAILABLE |||| eu-frankfurt | 欧洲地区(法兰克福) | AVAILABLE |||| na-ashburn | 美国东部(弗吉尼亚) | AVAILABLE |||| na-siliconvalley | 美国西部(硅谷) | AVAILABLE |||+-------------------+----------------+---------------+|
[root@VM_33_50_centos ~]# tccli cvm DescribeRegions --output text70bbd02f-****-****-****-afc5c34018ae 20REGIONSET ap-bangkok 亚太地区(曼谷) AVAILABLEREGIONSET ap-beijing 华北地区(北京) AVAILABLEREGIONSET ap-chengdu 西南地区(成都) AVAILABLEREGIONSET ap-chongqing 西南地区(重庆) AVAILABLEREGIONSET ap-guangzhou 华南地区(广州) AVAILABLEREGIONSET ap-guangzhou-open 华南地区(广州Open) AVAILABLEREGIONSET ap-hongkong 港澳台地区(中国香港) AVAILABLEREGIONSET ap-nanjing 华东地区(南京) AVAILABLEREGIONSET ap-seoul 亚太地区(首尔) AVAILABLEREGIONSET ap-shanghai 华东地区(上海) AVAILABLEREGIONSET ap-singapore 东南亚地区(新加坡) AVAILABLEREGIONSET ap-tokyo 亚太地区(东京) AVAILABLEREGIONSET eu-frankfurt 欧洲地区(法兰克福) AVAILABLEREGIONSET na-ashburn 美国东部(弗吉尼亚) AVAILABLEREGIONSET na-siliconvalley 美国西部(硅谷) AVAILABLE
tccli configure set cvm.version 2017-03-12
tccli cvm help --version 2017-03-12tccli cvm DescribeZones help --version 2017-03-12tccli cvm DescribeZones --version 2017-03-12
tccli configure set cvm.endpoint cvm.ap-guangzhou.tencentcloudapi.com
tccli cvm DescribeZones --endpoint cvm.ap-guangzhou.tencentcloudapi.com
[root@VM_180_248_centos ~]# tccli cvm DescribeZones{"TotalCount": 3,"ZoneSet": [{"ZoneState": "AVAILABLE","ZoneId": "100001","Zone": "ap-guangzhou-1","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 TotalCount3
[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": "100003"},{"name": "广州四区","id": "100004"}]
文档反馈