Both request and response have common parameters, they appear in every round of API action..

Common request parameters

The following table describes the common parameters that comprise of a URL for a GET request over HTTP or HTTPS protocol.

Name Type Required Description
Action String Yes The target API. For more information about the optional values, see API overview.
AccessKeyId String Yes Equivalent to a logon password.  However, an AccessKey is used to call APIs, while logon password is used to log on to the  ECS console . For more information, see Create an AccessKey.
Signature String Yes Your signature.  For more information, see Signature.
SignatureMethod String Yes Signature method. Value: HMAC-SHA1.
SignatureVersion String Yes Signature algorithm version.  Value: 1.0.
SignatureNonce String Yes Unique random number, which is used to prevent network replay attacks. Different random numbers must be used for different requests.
Timestamp String Yes Request time stamp. The time format follows the ISO8601 standard, and the UTC time is used. The format is yyyy-MM-ddTHH:mm:ssZ. For example, 2018-01-01T12:00:00Z indicates 20:00:00, Jan 01, 2018, Beijing time (UTC+8).
Version String Yes The API version to use. Value: 2014-05-26.
Format String No Type of the response parameters. Optional values: json | xml. Default value: xml.

Request example


https://ecs.aliyuncs.com/?Action=XXXXXX
&Format=xml
&Version=2014-05-26
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2018-01-01T12:00:00Z
…

Common response parameters

Name Type Description
RequestId String Request ID. We return a unique RequestId for every API request, whether the request is successful or not.