公共HTTP头定义

公共请求头

对于访问授权,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 头部格式如下:

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