全部产品
阿里云办公

公共HTTP头定义

更新时间:2018-11-07 10:19:31

公共请求头

对于访问授权,BatchCompute 采用阿里云通用的签名方式,即请求头部包含特定以”x-acs”开头的字段,通过计算签名和比较签名进行用户验证。其中头部必须包含的字段如下:

标准头

Header名称 类型 说明
Authorization 字符串 签名内容。该字段必选,它为非签名字段。参阅 签名机制
Content-Length 数字 Body 部分实际请求长度。如果传输是压缩格式,则为压缩后大小;如果请求不包含 Body,则数值为 0,它为非签名字段。
Content-MD5 字符串 Body 经过 MD5 计算后的字符串,计算结果为大写;如果没有 Body 部分,则不需要填写该请求头。
Content-Type 字符串 Body 类型。类型为字符串,分为 application/json 和 application/json-rpc 两种类型,默认值为 application/json;如果没有 Body 部分,则不需要填写该请求头。
Date 字符串 当前发送时刻的时间,参数目前只支持 RFC 822 格式,使用 GMT 标准时间。格式化字符串如下:%a, %d %b %Y %H:%M:%S GMT (如:Mon, 3 Jan 2010 08:33:47 GMT)。Date 所表示的时间与服务器接收到 request 的时间最大误差为 15 分钟。如果超过 15 分钟的时间误差则服务器端拒绝该请求。
Accept 字符串 客户端需要的返回值类型,支持 application/json 和application/json-rpc。默认值:无。
Host 字符串 请求 host 完整名字(不加 http:// ),例如:batchcompute.cn-qingdao.aliyuncs.com。

自定义头

Header名称 类型 说明
x-acs-version 字符串 当前 API 版本,目前版本为 2015-11-11
x-acs-compress-type 字符串 压缩方式。目前只支持 deflate,如果不压缩可以不填写该字段。
x-acs-body-rawsize 数字 Body 原始大小,当压缩时用以解压,当无 Body 时该字段为 0。范围为 0-256KB。
x-acs-signature-method 字符串 签名计算方式,目前支持“hmac-sha1”。
x-acs-signature-nonce 字符串 唯一随机数,用于防止网络重放攻击。用户在不同请求间,要使用不同的随机数值。
x-acs-access-id 字符串 用户访问 BatchCompute 的 AccessId,默认值:无。
x-acs-request-id 字符串 用户自动生成的请求 ID,以便日志跟踪。

示例

HTTP 头部格式如下:

  1. Authorization: acs [Access Key Id]:[Signature]
  2. Content-Length: 2324
  3. contentMd5: 871bd77924e76fb320f2d13f55e8a7a2
  4. Content-Type: application/json
  5. Date: Tue, 06 Nov 2018 06:12:40 GMT
  6. Accept: application/json
  7. Host: batchcompute.[Region].aliyuncs.com
  8. Accept-Encoding: identity
  9. User-Agent: Mozilla/5.0 (Windows NT 6.1)
  10. x-acs-version: 2015-11-11
  11. x-acs-signature-method: HMAC-SHA1
  12. x-acs-signature-nonce: f76e8ab8-e18a-11e8-bc78-645aede9015d
  13. x-acs-signature-version: 1.0
  14. x-acs-access-key-id: [Access Key Id]
  15. x-acs-region-id: [Region]