Common Request Parameters

Last updated: 2020-06-09 15:17:12


    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new Anti-DDoS Advanced 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 you send requests to Tencent Cloud APIs, please make sure that the requests include both common request parameters and API request parameters. Otherwise, the requests will fail. Also, you need to capitalize the first letter in each common request parameter so that it can be differentiated from a API request parameter.

    Common request parameters are shown in the following table:

    We take Tencent Cloud CVM-specific API as an example in this document. For other resource-specific APIs, please see relevant documents.

    Parameter Name Description Type Required
    Action Name of an action-specific API. For example, when a Tencent Cloud CVM user calls the API DescribeInstance, the Action of this request is DescribeInstances. String Yes
    Region Name of the region where your desired instance is located. For more information, see Regions and Availability Zones, or use the API DescribeRegions.
    Notes: 1. This parameter is required for the API requests, unless otherwise specified.
               2. The product is in closed beta in some of the regions and not available to all users.
    String No
    Timestamp Current UNIX timestamp, which is the time when the API request was initiated. UInt Yes
    Nonce A random positive integer that is combined with Timestamp to prevent replay attacks. UInt Yes
    SecretId Identity of the Tencent Cloud API access key Applicant Cloud API Key. A SecretId corresponds to one unique SecretKey, which is used to generate a request Signature. For more information, see Signature Method. String Yes
    Signature A signature is used for adding authentication information to the requests so that Tencent Cloud APIs can validate the identity of the request. The creation of signatures is based on input parameters. For more information, see Signature Method. String Yes
    SignatureMethod Types of message authentication methods. HmacSHA256 and HmacSHA1 are supported. If HmacSHA256 is not specified, the default is HmacSHA1. For more information, see Signature Method. String No
    Token No A token must be included in an API call along with temporary credentials. Long-term credentials do not require tokens. String

    Use Case

    The following example shows how common request parameters are formatted in an Tencent Cloud API request when you want to query the list of Tencent Cloud CVM instances in the Guangzhou region:

    Was this page helpful?

    Was this page helpful?

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