Help & DocumentationDirect Connect

Common Request Parameters

Last updated: 2018-08-14 18:08:40

A complete Tencent Cloud API request requires two types of request parameters: common request parameters and API request parameters. This document describes 6 common request parameters used in Tencent Cloud API requests. For more information about API request parameters, please see API Request Parameters.
Common request parameters are required in every API. When developers use Tencent Cloud APIs to send requests, they should make sure that the requests carry these common request parameters. Otherwise, the requests will fail. The initial letter of each common request parameter is in uppercase so that it can be differentiated from API request parameters.

Common request parameters are as follows:

Note:
This document illustrates APIs specific to Tencent Cloud CVMs. For APIs specific to other Tencent Cloud products, please see the relevant documents.

Parameter Name Description Type Required
Action The name of the API for the desired operation. For example, when a Tencent Cloud CVM user calls the API Query Instance List, the Action parameter is DescribeInstances. String Yes
Region Region parameter, which is used to identify the region to which the instance you want to work with belongs. For more information, please see Regions and Availability Zones, or use the API Query Region List.
Note: 1. Unless otherwise specified in the API document, this parameter is required generally.
           2. Some of the regions are under internal trial and only available to certain users.
String No
Timestamp The current UNIX timestamp that records the time at which the API request was initiated. UInt Yes
Nonce A random positive integer that is used in conjunction with Timestamp to prevent replay attacks. UInt Yes
SecretId The SecretId that is applied for under Cloud API Key to identify identity. A SecretId corresponds to a unique SecretKey, which is used to generate the request Signature. For more information, please see Signature Method. String Yes
Signature Request signature, which is used to verify the validity of the request. The signature must be computed based on input parameters. For more information, please see Signature Method. String Yes
SignatureMethod Signature method. Supported methods include HmacSHA256 and HmacSHA1. The HmacSHA256 method is used to verify signatures only when the parameter is specified as HmacSHA256. Otherwise, HmacSHA1 is used. For more information, please see Signature Method. String No
Token The token used for the temporary certificate, which must be used together with a temporary key. No token is required for a long-term key. String No

Use Case

The following example shows how common request parameters look like in an API request link for a Tencent Cloud product. If, for example, you want to query the list of Tencent Cloud CVM instances in the Guangzhou region, the request link should look like this:

https://cvm.api.qcloud.com/v2/index.php?
Action=DescribeInstances
&SecretId=xxxxxxx
&Region=ap-guangzhou
&Timestamp=1465055529
&Nonce=59485
&Signature=mysignature
&SignatureMethod=HmacSHA256
&<API request parameters>