This is a legacy API which has been hidden and will no longer be updated. We recommend using the new CKafka API 3.0 which is standardized and faster.
A complete Tencent Cloud API request requires two types of request parameters: common request parameter and API request parameter. This document will describe API request parameters used in Tencent Cloud API requests. For more information about common request parameters, please see Common Request Parameters.
API request parameters depend on specific APIs. Different APIs support different API request parameters. In order to differentiate from common request parameters, the initial letters of API request parameters are all lowercases.
The parameters in this document use Tencent Cloud CVM as example. For actual parameters for other Tencent Cloud products, refer to their API parameter instructions accordingly.
The following parameter list uses the Tencent Cloud CVM API DescribeInstances as example. This API supports the following API request parameters:
|instanceIds.n||Array of IDs of CVMs to be queried. The array subscript starts from 0. Both instanceId and unInstanceId are supported, but it is recommended to use unified resource ID: unInstanceId.||String||No|
|lanIps.n||Array of private IPs of the CVMs to be queried.||String||No|
|searchWord||CVM alias set by the user.||String||No|
|offset||Offset. Default is 0.||Int||No|
|limit||The maximum number of servers allowed to be queried at a time. Default is 20, and the maximum is 100.||Int||No|
|status||Status of the CVM to be queried.||Int||No|
|projectId||Project ID. CVM instances of all projects are queried if this is left empty. 0 indicates default project. Call the API [DescribeProject] to look for the IDs of other projects.||String||No|
|simplify||Obtain non-real time data if simplify=1 is added when passing parameters.||Int||No|
|zoneId||Availability zone ID. CVM instances of all availability zones are queried if this is left empty. Call the API DescribeAvailabilityZones to look for the IDs of other availability zones.||Int||No|
The fields are described as below:
Parameter name: Request parameter name supported by the API. Users can use this as API request parameter when using this API. A parameter name which ends with ".n" indicates that the parameter is an array, and array parameters need to be passed when using this parameter.
Required: Indicate whether this parameter is required. "Yes" means the parameter is required when you call the API. "No" means the parameter can be left empty.
Type: Data type of the API parameter.
Description: A brief description of the API request parameter.
The format of API request parameters in API request links for Tencent Cloud products are shown below. Take Tencent Cloud CVM as example, suppose a user needs to query the list of scaling groups, the request link should be:
https://cvm.api.qcloud.com/v2/index.php? &<Common request parameters> &instanceIds.0=ins-0hm4gvho &instanceIds.1=ins-8oby8q00 &offset=0 &limit=20 &status=2 &zoneId=100003