Public Request Parameters
Last updated: 2017-05-08 11:24:06
Common request parameters are the parameters common to all APIs, and will not be discussed in the document for each API unless it is necessary to do so. They are required in each request for the request to be initiated normally. The first letter of each common request parameter is uppercase so that the parameter can be differentiated from API-specific request parameters.
Common request parameters are listed as follows:
|Action||String||The name of the API for the desired operation. For example, if you want to call the API of Query Domain Information, the Action parameter is DescribeCdnHosts.||Yes|
|Region||String||Identify the region to which the instance you want to operate belongs. The parameter values for regions are as follows: Beijing: bj, Guangzhou: gz, Shanghai: sh, Hong Kong: hk, North America: ca. Note: CDN is not region-specific, so this parameter is not required.||No|
|Timestamp||UInt||The current UNIX timestamp that records the time at which the API request was initiated.||Yes|
|Nonce||UInt||A random positive integer that is used in conjunction with Timestamp to prevent replay attacks.||Yes|
|SecretId||String||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, please refer to Signature Method.||Yes|
|Signature||String||Request signature used to verify the legitimacy of the request and automatically generated by system according to input parameters. For more information, please refer to Signature Method.||Yes|
Assuming that the user wants to query the list of all domains connected to CDN, the request link may be as follows:
https://cdn.api.qcloud.com/v2/index.php? Action=DescribeCdnHosts &SecretId=xxxxxxx &Timestamp=1465055529 &Nonce=59485 &Signature=mysignature &<API Request Parameters>
A complete request needs two types of request parameters: common request parameters and API request parameters. Only five common request parameters are listed above (Region parameter is not required). For information on API parameters, refer to API Request Parameters section.