tencent cloud

$0 14-Day TrialExperience EdgeOne for acceleration and security protection!

Feedback

Tencent Cloud Command Line Interface

TCCLI Usage

Last updated: 2023-02-21 10:41:36

Overview

This document describes how to use the basic features of TCCLI.
TCCLI integrates all Tencent Cloud products that support TencentCloud API, and allows you to configure and manage the products. For example, you can use TCCLI to create and operate a Cloud Virtual Machine (CVM) instance, create a Cloud Block Storage (CBS) disk and view its usage, and create a Virtual Private Cloud (VPC) and add resources to it. All operations that can be performed on console pages can be performed by running commands in TCCLI. Examples:
Run the tccli cvm DescribeInstances command to view CVM instances under the current account.
Run the tccli cbs DescribeDisks command to view the list of CBS disks.

Basic Feature Usage

Note:
The following examples are based on Linux. Structures in the examples must be in standard JSON format.

Using TCCLI to create a CVM instance

Run the following command to create a CVM instance:
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":"TCCLI"}'
--SecurityGroupIds '["sg-0rszg2vb"]'
--HostName TCCLI-HOST-NAME1

Using standard input to transfer binary files

TCCLI allows you to call APIs with the content type octet-stream. When calling such APIs, you can use standard input < /path/to/file to transfer binary files. Example:
# Taking the CLS UploadLog API as an example, you can use the following command to upload logs:
tccli cls UploadLog --TopicId xxx < /path/to/file

--cli-unfold-argument

If the API to call uses any structures, you can add --cli-unfold-argument in the command to use a dot (.) as the concatenation operator for structure input. In this case, you can use the autocomplete feature of TCCLI to make the input process easier. Example:
tccli cvm RunInstances --cli-unfold-argument \\
--Placement.Zone ap-guangzhou-3 \\
--ImageId img-8toqc6s3 \\
--DryRun True
Note:
You can press the Tab key to complete --cli-unfold-argument. For details, see Using the Autocomplete Feature.
You can specify --cli-unfold-argument in the command only when using TCCLI 3.0.273.1 or later.

--generate-cli-skeleton

You can use --generate-cli-skeleton to generate a parameter skeleton in JSON format. Example:
# You can also input the generated JSON skeleton into a JSON file.
# $ tccli cvm DescribeInstances --generate-cli-skeleton > /home/test.json
tccli cvm DescribeInstances --generate-cli-skeleton
The output is as follows:
{
"Limit": "Integer",
"Filters": [
{
"Values": [
"String"
],
"Name": "String"
}
],
"InstanceIds": [
"String"
],
"Offset": "Integer"
}
Note:
You can press the Tab key to complete --generate-cli-skeleton. For more information, see Using the Autocomplete Feature.
You can specify --generate-cli-skeleton in the command only when using TCCLI 3.0.273.1 or later.

--cli-input-json

If there are too many input parameters, you can add --cli-input-json in the command to support input through a JSON file. (Add file://file directory after --cli-input-json.) You can use --generate-cli-skeleton to generate the corresponding JSON file. After specifying parameters in the JSON file, you can use the file to call an API. Example:
tccli cvm DescribeInstances --cli-input-json file:///home/test.json
Note:
You can press the Tab key to complete --cli-input-json. For more information, see Using the Autocomplete Feature.
You can specify --cli-input-json in the command only when using TCCLI 3.0.250.2 or later.
Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon