Common Request Parameters

Last updated: 2017-12-12 11:37:20

A complete Tencent Cloud API request requires two types of request parameters: common request parameter and API request parameter. 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, or the requests will fail. In order to differentiate from API request parameters, the initial letters of common request parameters are all capital letters.

Common request parameters are as follows:

Note:
The API examples in this document use Tencent Cloud CVM as example. For other Tencent Cloud products, refer to their instructions accordingly.

Parameter Name Description Type Required
Action Command API name of a specific operation. For example, when a Tencent Cloud CVM user calls the Query Instance List API, the Action parameter is DescribeInstances. String Yes
Region Region parameter which is used to indicate the region of the instance to be operated in. For more information, please see the Regions and Availability Zones list, or use the Query Region List API.
Note: 1. This parameter is required in normal conditions unless stated otherwise in the API description.
           2. Some of the regions are under internal trial and are 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 SecretId applied from Cloud API Key which is used for identification. Each SecretId corresponds to a unique SecretKey, while SecretKey is used to generate request Signature. For more information, please see Signature Method. String Yes
Signature Request signature which is used to verify the validity of the current request. The signature must be calculated according to input parameters. For more information, please see Signature Method. String Yes
SignatureMethod Signature method. Currently supported methods are HmacSHA256 and HmacSHA1. HmacSHA256 method is used only when the parameter is specified as HmacSHA256, otherwise HmacSHA1 is used to verify signatures. For more information, please see Signature Method. String No
Token Token used for temporary certificate. The token must be used together with temporary key. A long-term key does not require a Token. String No

Example

The format of common 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 CVM instances in Guangzhou region, the request link should be:

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>