Common Request Parameters

Last updated: 2020-06-09 15:08:48

    Note:

    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new API Gateway API 3.0 which is standardized and faster.

    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, 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 first letter of each common request parameter is in uppercase so that the parameter 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, 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, see Regions and Availability Zones, or use the API Query Region List.
    Notes: 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, which is used to record the time when 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 for identifying identity that is applied for on Cloud API Key. A SecretId corresponds to a unique SecretKey, which is used to generate the request Signature. For more information, see Signature Method. String Yes
    Signature Request signature, which is used to verify the validity of the request. It is generated based on input parameters. For more information, 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, 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>
    

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help