公共参数是指所有接口调用都需要用到的参数,包含公共请求参数和公共返回参数。
公共请求参数
公共请求参数是每个接口都需要使用到的请求参数。主要参数参见下表:
名称 | 是否必须 | 示例 | 描述 |
---|---|---|---|
Authorization | 是 | acs<yourAccessKeyId>:<yourSignature> | 用于验证请求合法性的认证信息,格式为AccessKeyId:Signature 。
含义如下:
|
Date | 是 | Thu,17 Nov 2018 18:49:58 GMT | HTTP 1.1协议中规定的GMT时间。 |
Accept | 是 | application/json | 客户端需要的返回值类型,取值为application/json。 |
x-acs-action | 是 | ListInstance | API的名称。详情请参见API概览。 |
x-acs-version | 是 | 2017-06-13 | API版本。 |
x-acs-signature-nonce | 否 | 51284580-614a-11eb-8a9b-9dcfec8d**** | 唯一随机数,用于防止网络重放攻击。您在不同请求间需要使用不同的随机数值。 |
x-acs-signature-method | 是 | HMAC-SHA1 | 签名方式,目前仅支持HMAC-SHA1。 |
ContentMD5 | 是 | MACiECZtnLiNkNS1v5****=1 | HTTP请求正文的128-bit MD5散列值转换成BASE64编码的结果。 |
示例如下。
GET https://elasticsearch.cn-hangzhou.aliyuncs.com/openapi/instances HTTP/1.1
Authorization: acs DemoAccessKey:31nTIpResD/0C8gb+ChUeuv****=
Date: Thu, 17 Nov 2018 18:49:58 GMT
Accept: application/json
x-acs-action: ListInstance
x-acs-version: 2017-06-13
x-acs-signature-nonce: 51284580-614a-11eb-8a9b-9dcfec8d****
x-acs-signature-method: HMAC-SHA1
ContentMD5:MACiECZtnLiNkNS1v5****=1
公共返回参数
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 请求ID。无论调用接口成功与否,都会返回该参数。 |