公共請求頭
對于訪問授權,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]