This topic describes the request and response parameters that are included in all API operations.
Common request parameters
Parameter | Type | Required | Description |
---|---|---|---|
Format | String | No | The format in which to return the response. Valid values:
|
Version | String | Yes | The version number of the API. Specify the version number in the YYYY-MM-DD format. Valid values: 2019-11-20 |
AccessKeyId | String | Yes | The AccessKey ID provided to you by Alibaba Cloud. |
Signature | String | Yes | The signature string of the request. |
SignatureMethod | String | Yes | The encryption method of the signature string. Set the value to HMAC-SHA1 |
Timestamp | String | Yes | The timestamp of the request. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. For example, you can set the value to 2013-01-10T12:00:00Z. This value indicates 20:00:00 on January 10, 2013 (UTC+8). |
SignatureVersion | String | Yes | The version of the signature encryption algorithm. Set the value to 1.0 |
SignatureNonce | String | Yes | A unique random number that is used to prevent replay attacks. You must use a unique random number for each request. |
ResourceOwnerAccount | String | No | The Alibaba Cloud account to which the resource you want to access belongs. |
Examples
http://ga.aliyuncs.com/?Action=DescribeListener
&TimeStamp=2014-05-19T10%3A33%3A56Z
&Format=xml
&AccessKeyId=testid
&SignatureMethod=Hmac-SHA1
&SignatureNonce=NwDAxvLU6tFE0DVb
&Version=2019-11-20
&SignatureVersion=1.0
&Signature=Signature
Common response parameters
API responses use the HTTP response format. A response can be returned in the JSON or XML format. You can specify the response format in the request. The default response format is XML. Every response returns a unique RequestId regardless of whether the call is successful.
- A
2xx
HTTP status code indicates a successful call. - A
4xx
or5xx
HTTP status code indicates a failed call.
Sample responses
- XML format
<?xml version="1.0" encoding="utf-8"?> <!--Result Root Node--> <Interface Name+Response> <!--Returned Request Tag--> <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId> <!--Returned Result Data--> </Interface Name+Response>
- JSON format
{ "RequestId":"4C467B38-3910-447D-87BC-AC049166F216" /*Returned Result Data*/ }