Common request parameters

Common request parameters are request parameters used by each API.

Table 1. Common request parameters
Name Type Required Description
Format String No The format of the response to return. Valid values:

JSON (default) | XML

Version String Yes The version of the API in the format of YYYY-MM-DD. Valid value:

2014-05-15

AccessKeyId String Yes The AccessKey ID of the user that calls the API.
Signature String Yes The request signature.
SignatureMethod String Yes The algorithm used to create the request signature. Valid value:

HMAC-SHA1

Timestamp String Yes The timestamp of the request in the format of YYYY-MM-DDThh:mm:ssZ.

For example, 2013-01-10T12:00: 00Z.

SignatureVersion String Yes The signature version to use. Valid value:

1.0

SignatureNonce String Yes A random number used for the signature to prevent from network attacks.

Different random numbers must be used for different requests.

ResourceOwnerAccount String No The account owner of the resource that this request calls.
Examples
http://slb.aliyuncs.com/?Action=DescribeLoadBalancers
&TimeStamp=2014-05-19T10%3A33%3A56Z
&Format=xml
&AccessKeyId=testid
&SignatureMethod=Hmac-SHA1
&SignatureNonce=NwDAxvLU6tFE0DVb
&Version=2014-05-15
&SignatureVersion=1.0
&Signature=Signature

Common response parameters

The API response uses unified format. Returning 2XX HTTP status code indicates a successful call; returning 4xx or 5xx HTTP status code indicates a failed call. When a call succeeds, the formats of the returned data include XML and JSON. You can specify the format of the returned data when sending the request. The default format is XML.

Each time you send a request to call an interface, the system returns a unique identification code ( RequestId), whether the request is successful.
  • XML format
    <? xml version="1.0" encoding="utf-8"? > 
        <!—The result root node---->
        <Action+Response>
            <!—The returned request tag-->
            <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
            <!—The returned result-->
        </Action+Response>
    
  • JSON format:
    {
        "RequestId":"4C467B38-3910-447D-87BC-AC049166F216",
        /*The returned result*/
        }