Common parameters

更新时间:
复制 MD 格式

Common request parameters are used to identify general information such as the API operation to be called, user identity, and signature. These parameters must be included in each API request. If not necessary, these parameters are no longer described in each individual interface document.

Common request parameters

The public request parameters should be carried in the request as the message header (header) of the HTTP request. The specific values are as follows:

ParameterRequiredDescription
x-acs-actionYesThe name of the API. For more information about the value, seeCommunication monitoring.
x-acs-versionYesThe version of the API operation in the YYYY-MM-DD format. Example: 2018-01-01.
x-acs-signature-nonceNoA unique, random number used to prevent replay attacks. You must use different numbers for different requests.
x-acs-signature-methodYes if the request is non-anonymousThe user signature method. Currently, HMAC-SHA1 is supported.
AuthorizationYes if the request is non-anonymousThe authentication information used to verify the validity of the request, in the format of acs AccessKeyId:Signature. The AccessKey ID is the AccessKey ID of the user. The Signature parameter is the request signature. For more information, see Signature.
DateYesThe specified Greenwich Mean Time (GMT) in HTTP 1.1, for example, Tue 9 Apr 2019 07:35:29 GMT.
AcceptNoThe type of the return value required by the client. Valid values:
  • application/json (recommended).
  • application/xml (default).
Content-MD5NoThe Base64-encoded 128-bit MD5 hash value of the HTTP request body.