【转】腾讯云 TCCLI 实践分享

2018-07-10 23:06:34 浏览数 (1)

原文来自:腾讯云计算产品团队

原文地址:https://cloud.tencent.com/developer/article/1158013

转载原因:CLI被喷无数,竟然大神写了这么完美的文章


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

本文将结合实际用户场景需求,提供相关 TCCLI 的实践例子,希望能帮助大家更快速掌握 TCCLI 的用法。安装、配置 TCCLI 的详细步骤请参考官网命令行工具的介绍,本文就不再重复了。

关于 API 的选用,本文继续以创建 CVM 为例,因为该 API 较为复杂,输入参考涉及到的数据类型也较为齐全。

输入参数

其实 TCCLI 的使用也是挺简单的,对于输入参数的语法是: --参数名称 参数值

String

String

代码语言:javascript复制
## 用法示例,注意不要加引号将镜像ID引起来,参数和参数值直接有一个空格,别漏了哈
--ImageId img-8toqc6s3

Integer

Integer

代码语言:javascript复制
## 用法示例,注意不要加引号,参数和参数值直接有一个空格,别漏了哈
--InstanceCount 1

Boolean

由于创建 CVM 的API 中输入参数没有 Boolean 类型,那我这里选择关闭实例的 API 来做示例。

Boolean

代码语言:javascript复制
## 用法示例,注意不要加引号,而且是小写的true或者false。
--ForceStop true

Array of String

Array of String

代码语言:javascript复制
## 用法示例,注意不要漏了外面的单引号
--SecurityGroupIds '["sg-is82khqv"]'

Array of Object

Array of Object

DataDisk数据结构

代码语言:javascript复制
## 用法示例,注意不要漏了外面的单引号
--DataDisks '[{"DiskType":"LOCAL_BASIC","DiskSize":50},{"DiskType":"CLOUD_BASIC","DiskSize":500}]'

Object(实例1)

Object

Placement数据结构

代码语言:javascript复制
## 用法示例,注意不要漏了外面的单引号,
--Placement '{"Zone":"ap-beijing-3","ProjectId":1048443,"HostIds":["host-cy8swiou"]}'

Object(实例2)

Object

InstanceMarketOptionsRequest数据结构

SpotMarketOptions数据结构

代码语言:javascript复制
## 用法示例,注意不要漏了外面的单引号
--InstanceMarketOptions '{"MarketType":"spot", "SpotOptions":{"MaxPrice":"0.15","SpotInstanceType":"one-time"}}'

Filters

由于创建 CVM 的API 中输入参数没有 Filters,那我这里选择查看实例列表的 API 来做示例。

补充需要提醒大家的是,注意windows和linux操作系统的区别,在拼接字符串的时候windows下可能需要使用转义符。上面的例子也是如此哈,要注意windows下的转义哈。

linux 示例代码:

代码语言:javascript复制
tccli cvm DescribeInstances  --Filters '[{"Name":"private-ip-address","Values":["172.16.0.12"]}]'

windows 示例代码:

代码语言:javascript复制
tccli cvm DescribeInstances  --Filters "[{"Name":"private-ip-address","Values":["172.16.0.12"]}]"

UserData

UserData

该参数需要以 base64 方式编码,支持的最大数据大小为 16KB。关于获取此参数的详细介绍,请参阅Windows首次启动实例时运行命令和Linux首次启动实例时运行命令的介绍。

代码语言:javascript复制
## 请不要加引号
--UserData IyEvYmluL2Jhc2gKIyMgSW5zdGFsbCB0aGUgcGFja2FnZXMKZWNobyAtZSAiMXFhekBXU1giIHwgcGFzc3dkCg==

完整例子

tccli cvm RunInstances --InstanceChargeType SPOTPAID --Placement '{"Zone":"ap-beijing-3"}' --DataDisks '{"DiskType":"LOCAL_BASIC","DiskSize":50},{"DiskType":"CLOUD_BASIC","DiskSize":500}' --InstanceType S2.MEDIUM4 --ImageId img-8toqc6s3 --SystemDisk '{"DiskType":"CLOUD_BASIC", "DiskSize":50}' --InternetAccessible '{"InternetChargeType":"TRAFFIC_POSTPAID_BY_HOUR","InternetMaxBandwidthOut":10,"PublicIpAssigned":true}' --InstanceCount 1 --InstanceName TCCLI-TEST --SecurityGroupIds '"sg-is82khqv"' --HostName TCCLI-HOST-NAME1 --VirtualPrivateCloud '{"VpcId":"vpc-faob6vpi", "SubnetId":"subnet-mrmr3047"}' --InstanceMarketOptions '{"MarketType":"spot", "SpotOptions":{"MaxPrice":"0.15","SpotInstanceType":"one-time"}}' --UserData IyEvYmluL2Jhc2gKIyMgSW5zdGFsbCB0aGUgcGFja2FnZXMKZWNobyAtZSAiMXFhekBXU1giIHwgcGFzc3dkCg==


广告时间:

腾讯云API代码生成工具:

地址1:http://www.apihelper.cn/

地址2:http://www.apicoder.cn/

腾讯云API官方交流群:711269805

0 人点赞