公共请求头
对于访问授权,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]