全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
容器服务

公共参数

更新时间:2017-06-28 14:11:46

公共请求头部

公共请求参数是指每个接口都需要使用到的请求参数。

参数名称 说明 选项
Authorization 用于验证请求合法性的认证信息,采用 AccessKeyId:Signature 的形式。 Required
Content-Length RFC 2616 中定义的 HTTP 请求内容长度。 Required
Content-Type RFC 2616 中定义的 HTTP 请求内容类型。 Required
Content-MD5 HTTP 协议消息体的 128-bit MD5 散列值转换成 BASE64 编码的结果。为了防止所有请求被篡改,建议所有请求都附加该信息。 Required
Date 请求的构造时间,目前只支持 GMT 格式。如果与 MNS 的服务器时间前后差异超过 15 分钟将返回本次请求非法。 Required
Host 访问 Host 值,例如:diku.aliyuncs.com Required
Accept 客户端需要的返回值类型,支持 application/json 和 application/xml。 Required
x-acs-version API 版本号。目前版本号为 2015-12-15。 Required
x-acs-region-id 地域(Region)指的是 ECS 实例所在的物理位置。更多详细信息参见 地域概念ECS查询可用地域列表 Required
x-acs-signature-nonce 唯一随机数,用于防止网络重放攻击。您在不同请求间要使用不同的随机数值。 Required
x-acs-signature-method 用户签名方式,目前只支持 HMAC-SHA1。 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

公共返回头部

您发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId。

示例

XML 示例:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!—结果的根结点-->
  3. <接口名称+Response>
  4. | <!—返回请求标签-->
  5. | <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
  6. | <!—返回结果数据-->
  7. </接口名称+Response>

JSON 示例:

  1. {
  2. "RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
  3. /* 返回结果数据 */
  4. }
本文导读目录