tccli

腾讯云命令行工具速查手册。通过命令行方式管理和操作腾讯云 200+ 云产品资源，支持实例查询、启动、停止、域名解析等功能。当用户提到腾讯云、tccli、CVM、 Lighthouse、DNSPod、VPC、SSL 证书等腾讯云服务操作时触发。

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

TCCLI - 腾讯云命令行工具

通过命令行管理腾讯云资源

简介

TCCLI（Tencent Cloud Command Line Interface）是腾讯云官方提供的命令行工具，支持管理 200+ 云产品。

安装

pip3 install tccli

配置

# 配置密钥（只需一次）
tccli configure set secretId <your-secret-id>
tccli configure set secretKey <your-secret-key>
tccli configure set region ap-guangzhou

常用服务速查

云服务器 (CVM)

操作	命令
查看实例列表	`tccli cvm DescribeInstances`
查看实例状态	`tccli cvm DescribeInstancesStatus`
查看可用区	`tccli cvm DescribeZones`
查看地域	`tccli cvm DescribeRegions`
查看镜像	`tccli cvm DescribeImages`
启动实例	`tccli cvm StartInstances --InstanceIds '["ins-xxxxx"]'`
停止实例	`tccli cvm StopInstances --InstanceIds '["ins-xxxxx"]'`
重启实例	`tccli cvm RebootInstances --InstanceIds '["ins-xxxxx"]'`

轻量应用服务器 (Lighthouse)

操作	命令
查看实例列表	`tccli lighthouse DescribeInstances`
查看套餐	`tccli lighthouse DescribeBundles`
查看镜像	`tccli lighthouse DescribeBlueprints`
查看防火墙规则	`tccli lighthouse DescribeFirewallRules`
创建防火墙规则	`tccli lighthouse CreateFirewallRules --InstanceId ins-xxxxx --FirewallRules '[{"Protocol":"TCP","Port":"80","Action":"ACCEPT"}]'`

SSL 证书

操作	命令
查看证书列表	`tccli ssl DescribeCertificates`
查看证书详情	`tccli ssl DescribeCertificate --CertificateId xxx`
下载证书	`tccli ssl DownloadCertificate --CertificateId xxx`
部署证书	`tccli ssl DeployCertificateInstance ...`

DNSPod (域名解析)

操作	命令
查看域名列表	`tccli dnspod DescribeDomainList`
查看域名详情	`tccli dnspod DescribeDomain --Domain example.com`
查看记录列表	`tccli dnspod DescribeRecordList --Domain example.com`
创建记录	`tccli dnspod CreateRecord --Domain example.com --RecordType A --RecordLine 默认 --Value 1.2.3.4`

私有网络 (VPC)

操作	命令
查看 VPC 列表	`tccli vpc DescribeVpcs`
查看子网列表	`tccli vpc DescribeSubnets`
查看安全组	`tccli vpc DescribeSecurityGroups`
查看安全组规则	`tccli vpc DescribeSecurityGroupPolicies --SecurityGroupId sg-xxxxx`

域名注册

操作	命令
查看域名列表	`tccli domain DescribeDomainNameList`
检查域名	`tccli domain CheckDomain --DomainName example.com`
查看价格	`tccli domain DescribeDomainPriceList`

云监控 (Monitor)

操作	命令
查看指标数据	`tccli monitor GetMonitorData`
查看告警策略	`tccli monitor DescribeAlarmPolicies`

输出格式

# JSON 格式（默认）
tccli cvm DescribeInstances

# 表格格式
tccli cvm DescribeInstances --output table

# 文本格式
tccli cvm DescribeInstances --output text

帮助命令

# 查看所有服务
tccli help

# 查看服务详情
tccli cvm help
tccli ssl help
tccli lighthouse help

# 查看具体接口
tccli cvm DescribeInstances help

常用参数

参数	说明	示例
`--Region`	指定地域	`--Region ap-shanghai`
`--output`	输出格式	`--output table`
`--filter`	过滤结果	`--filter 'Instances[0].InstanceId'`
`--cli-unfold-argument`	展开参数	用于复杂嵌套参数

使用示例

获取第一个实例的公网 IP

tccli cvm DescribeInstances --filter 'Instances[0].PublicIpAddresses[0]'

查看所有运行中的实例

tccli cvm DescribeInstances --Filters '[{"Name":"instance-state","Values":["RUNNING"]}]'

批量查询多个实例

tccli cvm DescribeInstances --InstanceIds '["ins-xxx1","ins-xxx2"]' --output table

完整服务列表

TCCLI 支持 200+ 云服务，常用包括：

服务代码	服务名称
cvm	云服务器
lighthouse	轻量应用服务器
vpc	私有网络
ssl	SSL 证书
dnspod	DNS 解析
domain	域名注册
cdn	内容分发网络
cls	日志服务
cos	对象存储
monitor	云监控
cam	访问管理
cdb	云数据库 MySQL
redis	云数据库 Redis
mongodb	云数据库 MongoDB
tke	容器服务
scf	云函数

安全注意事项

最小权限原则：配置的 API 密钥应仅授予所需的最小权限，避免使用主账号密钥
密钥保护：不要在共享终端、日志、截图或代码仓库中暴露 secretId / secretKey
写操作确认：执行变更类命令（启停实例、修改防火墙、部署证书、创建 DNS 记录等）前，务必确认目标账号、地域、资源 ID 和操作意图
区域确认：执行写操作前确认 --Region 参数正确，避免误操作其他地域的资源

参考文档

Repository: TeamWiseFlow/xiaobei
Path: crews/it-engineer/skills/tccli/SKILL.md
Commit: bcef823

Last updated: 3 days ago
First committed: about 2 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.