Using Advanced Features

Product Introduction

Purchase Guide

Installing TCCLI

Obtaining Credentials Through Browser Authorization

TCCLI Configuration Method

Using an HTTPS Proxy

Using the Autocomplete Feature

Configuring TCCLI

TCCLI Usage

Obtaining Help Information

Multi-version API Access

Specifying the Nearest Endpoint

Filtering Return Results

Result Polling

Using TCCLI

Operation Guide

Tencent Cloud Command Line Interface

This document describes how to use the advanced features of TCCLI International Version, including multi-version API access, nearest access point specifying, and return result filtering.

Some products may have multiple versions of APIs, and TCCLI accesses the latest version by default. If you want to access a specific legacy version, you can do so in the following way (with CVM as an example).

# Set the default version of the CVM product: 2017-03-12

tccli configure set cvm.version 2017-03-12

# Specify the version number in real time when using

tccli cvm DescribeZones help --version 2017-03-12

tccli cvm DescribeZones --version 2017-03-12

Specify the nearest access point (Endpoint)

By default, TCCLI requests the nearest endpoint for accessing a service. You can also specify your own endpoint for a product (with CVM as an example).

# Set the default endpoint of the CVM product

tccli configure set cvm.endpoint cvm.ap-guangzhou.tencentcloudapi.com

tccli cvm DescribeZones --endpoint cvm.ap-guangzhou.tencentcloudapi.com

Output without any filtering (with the return result of CVM DescribeZones API as an example):

[root@VM_180_248_centos ~]# tccli cvm DescribeZones

 "RequestId": "4fd313a6-155f-4c7a-bf86-898c02fcae02"

[root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter TotalCount

View the information of the Nth sub-object of a specified object in array type.

[root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter ZoneSet[0]

View a certain field of all the sub-objects with a certain name under the specified object in array type.

[root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter ZoneSet[*].ZoneName
   [
    "Guangzhou Zone 1",
    "Guangzhou Zone 2",
    "Guangzhou Zone 3",
    "Guangzhou Zone 4"
   ]

Filter the sub-objects in the array and then present them under a new name:

 [root@VM_180_248_centos ~]# tccli cvm DescribeZones  --filter 'ZoneSet[*].{name:ZoneName, id:ZoneId}'

                 "name": "Guangzhou Zone 1",

                 "name": "Guangzhou Zone 2",

                 "name": "Guangzhou Zone 3",

                 "name": "Guangzhou Zone 4",

tencent cloud