edit-icon download-icon

Public parameters

Last Updated: Apr 08, 2018

Public request headers

Public request parameters are the request parameters that each interface must use.

Parameter nameDescription Option
AuthorizationThe authentication information used to verify the validity of a request. Format: AccessKeyId:Signature.Required
Content-Length The content length of an HTTP request, which is defined in RFC 2616.Required
Content-TypeThe content type of an HTTP request, which is defined in RFC 2616.Required
Content-MD5The Base64-encoded results converted from 128-bit MD5 hash value of the HTTP message body. We recommend that you add this message to all requests to prevent requests from being tampered.Required
DateThe construction time of a request. Currently, only the GMT format is supported. If the difference between the construction time and the MNS server time exceeds 15 minutes, invalid request is returned.Required
HostThe host access value, for example, diku.aliyuncs.com.Required
AcceptThe return type required by the client. application/json and application/xml are supported.Required
x-acs-versionThe API version. The current version is 2015-12-15.Required
x-acs-region-idA region indicates the physical location of an Elastic Compute Service (ECS) instance.Required
x-acs-signature-nonceThe unique random number used to prevent network replay attacks. Different random numbers must be used for different requests.Required
x-acs-signature-methodThe method of user signature. Currently only HMAC-SHA1 is supported.Required


  1. GET /clusters HTTP/1.1
  2. Host: cs.aliyuncs.com
  3. Accept: application/json
  4. User-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)
  5. x-acs-signature-nonce: f63659d4-10ac-483b-99da-ea8fde61eae3
  6. Authorization: acs ACSbW2iBbyX0Pk9N:mp/6Wdr18V3qAc5gbgsqMe/iB0c
  7. x-acs-signature-version: 1.0
  8. Date: Wed, 16 Dec 2015 11:18:47 GMT
  9. x-acs-signature-method: HMAC-SHA1
  10. Content-Type: application/json;charset=utf-8
  11. X-Acs-Region-Id: cn-beijing
  12. Content-Length: 0

Public response headers

Each time you send a request to call an interface, the system returns a unique identifier (RequestId), no matter the request is successful or not.


XML example:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!—Result root node-->
  3. <Interface name+Response>
  4. | <!—Return request tag-->
  5. | <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
  6. | <!—Return result data-->
  7. </Interface name+Response>

JSON example:

  1. {
  2. "RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
  3. /* Return result data */
  4. }
Thank you! We've received your feedback.