tencent cloud

腾讯云命令行工具

产品简介
购买指南
操作指南
安装 TCCLI
配置 TCCLI
使用 TCCLI
文档腾讯云命令行工具操作指南使用 TCCLITCCLI 使用方法

TCCLI 使用方法

PDF
聚焦模式
字号
最后更新时间： 2025-11-24 14:56:01

操作场景

本文介绍如何使用腾讯云命令行工具 TCCLI 的基础功能。
TCCLI 集成了腾讯云所有支持云 API 的产品，您可以在命令行下完成对腾讯云产品的配置和管理。包括使用 TCCLI 创建云服务器、操作云服务器、通过 TCCLI 创建云硬盘、查看云硬盘使用情况、通过 TCCLI 创建私有网络、往私有网络中添加资源等，所有在控制台页面能完成的操作，均能在 TCCLI 上执行命令实现。例如：
通过 tccli cvm DescribeInstances 命令查看当前账号有哪些云服务器。
通过 tccli cbs DescribeDisks 命令查看有云硬盘列表。

使用基础功能

说明：
以下以 Linux 操作系统为例，示例中非简单类型的参数，必须为标准 JSON 格式。

使用 TCCLI 创建 CVM

执行以下命令，创建一台 CVM。
tccli cvm RunInstances \\
--InstanceChargeType PREPAID \\
--InstanceChargePrepaid '{"Period":1,"RenewFlag":"DISABLE_NOTIFY_AND_MANUAL_RENEW"}' \\
--Placement '{"Zone":"ap-guangzhou-3"}' \\
--InstanceType S5.SMALL1 \\
--ImageId img-8toqc6s3 \\
--SystemDisk '{"DiskType":"CLOUD_SSD", "DiskSize":50}' \\
--InternetAccessible '{"InternetChargeType":"TRAFFIC_POSTPAID_BY_HOUR","InternetMaxBandwidthOut":10,"PublicIpAssigned":true}' \\
--InstanceCount 1 \\
--InstanceName TCCLI-TEST \\
--LoginSettings '{"Password":"******"}' \\
--SecurityGroupIds '["sg-0rszg2vb"]' \\
--HostName TCCLI-HOST-NAME1

使用标准输入传输二进制文件

TCCLI 支持调用 octet-stream 类型的接口，若调用接口使用 octet-stream 协议，您可以使用标准输入 < /path/to/file 来传输二进制文件。示例命令如下：
# 以 cls 的 UploadLog 接口为例，上传日志可使用如下命令
tccli cls UploadLog --TopicId xxx < /path/to/file

--cli-unfold-argument 参数

若调用接口参数为复杂类型时，可以增加 --cli-unfold-argument 参数，并进行参数补全，使用复杂类型点(.)展开的方式调用，降低输入难度。示例命令如下：
tccli cvm RunInstances --cli-unfold-argument \\
--Placement.Zone ap-guangzhou-3 \\
--ImageId img-8toqc6s3 \\
--DryRun True
说明：
--cli-unfold-argument 命令可通过 Tab 键进行补全，详情请参见 使用命令行自动补全功能。
--cli-unfold-argument 命令需3.0.273.1 版本及以上。

--generate-cli-skeleton 参数

您可增加 --generate-cli-skeleton 参数，输出 JSON 格式入参骨架。示例命令如下：
# 您还可将 json 格式入参骨架直接输入到 json 文件中
# $ tccli cvm DescribeInstances --generate-cli-skeleton > /home/test.json
tccli cvm DescribeInstances --generate-cli-skeleton
输出结果如下：
{
    "Limit": "Integer", 
    "Filters": [
        {
            "Values": [
                "String"
            ], 
            "Name": "String"
        }
    ], 
    "InstanceIds": [
        "String"
    ], 
    "Offset": "Integer"
}
说明：
--generate-cli-skeleton 命令可通过 Tab 键进行补全，详情请参见 使用命令行自动补全功能。
--generate-cli-skeleton 命令需3.0.273.1版本及以上。

--cli-input-json 参数

若接口入参较多，可增加 --cli-input-json 参数，该参数支持 JSON 文件输入（参数后需增加 file://+文件路径）。您可以使用 --generate-cli-skeleton 生成相应的 JSON 文件，填写参数后即可直接使用该 JSON 文件调用接口。示例命令如下：
tccli cvm DescribeInstances --cli-input-json file:///home/test.json
说明：
--cli-input-json 命令可通过 Tab 键进行补全，详情请参见 使用命令行自动补全功能。
--cli-input-json 命令需3.0.250.2版本及以上。
上一篇: 使用命令行自动补全功能下一篇: 获取帮助信息

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈