252 人物

公共請求頭__API-Reference_日誌服務-阿裏雲

LOG service API是基於HTTP協議的Rest風格接口。它支持一組可以在所有API請求中使用的公共請求頭（除特別說明，每個LOG service API請求都必須提供這些公共請求頭），其詳細定義如下：

Header名稱	類型	說明
Accept	字符串	客戶端希望服務端返回的類型，目前支持application/json、application/x-protobuf兩種，該字段為非必選參數，僅對GET請求有效,具體取值以各個接口定義為準
Accept-Encoding	字符串	客戶端希望服務端返回的壓縮算法，目前支持lz4, deflate, 或空（不壓縮）,該字段為非必選參數，僅對GET類請求有效,具體取值以各個接口定義為準
Authorization	字符串	簽名內容，更多細節請參考請求簽名。
Content-Length	數值	RFC 2616中定義得HTTP請求Body長度。如果請求無Body部分，則不需要提供該請求頭。
Content-MD5	字符串	請求Body經過MD5計算後的字符串，計算結果為大寫。如果沒有Body部分，則不需要提供該請求頭。
Content-Type	字符串	RFC 2616中定義得HTTP請求Body類型。目前Log Service API請求隻支持application/x-protobuf。如果沒有Body部分，則不需要提供該請求頭，具體取值以各個接口定義為準
Date	字符串	當前發送時刻的時間，參數目前隻支持RFC 822格式，使用GMT標準時間。格式化字符串如下：%a, %d %b %Y %H:%M:%S GMT (如：Mon, 3 Jan 2010 08:33:47 GMT)。
Host	字符串	HTTP請求的完整HOST名字（不包括如“https://” 這樣的協議頭），例如：big-game.cn-hangzhou.sls.aliyuncs.com。
x-log-apiversion	字符串	API的版本號，當前版本為0.6.0。
x-log-bodyrawsize	數值	請求的Body原始大小。當無Body時該字段為0，當Body是壓縮數據，則為壓縮前的原始數據大小。該域取值範圍為[0, 3x1024x1024]。該字段為非必選字段，隻在壓縮時需要。
x-log-compresstype	字符串	API請求中Body部分使用的壓縮方式。目前支持“lz4”壓縮類型，“deflate”壓縮類型（RFC 1951，使用zlib格式，參考RFC 1950）,如果不壓縮可以不提供該請求頭。
x-log-date	字符串	當前發送時刻的時間，格式和Date頭一致。該請求頭為可選項。如果請求中包含該公共請求頭，在它的值會取代Date標準頭的值用於服務端請求驗證。無論是否有x-log-date頭，HTTP標準Date頭都必須提供。
x-log-signaturemethod	字符串	簽名計算方式，目前僅支持”hmac-sha1”。
x-acs-security-token	字符串	使用STS臨時身份發送數據，當使用STS臨時身份時必填，其他情況不要填寫

說明

請求中Date所表示的時間與服務器接收到該請求的時間最大可接受誤差為15分鍾，如果超過15分鍾服務器端會拒絕該請求。如果請求中設置了x-log-date頭部，則該時間誤差計算基於x-log-date頭的值。
如果請求指明壓縮算法（在x-log-compresstype中指定），則需要把原始數據壓縮後放到HTTP Body部分，而對應的Content-Length、Content-MD5頭部也是按照壓縮後的Body部分計算。
由於某些平台上發送HTTP請求時無法指定Date頭（由平台自身的庫內部自動指定為發送當前時間），造成無法使用正確的Date值計算請求簽名。在這種情況下，請指定x-log-date頭並用該請求頭的值參與請求簽名計算。Log Service服務端在接受到API請求後會首先判斷是否有x-log-date頭，如果有則用它的值來做簽名驗證，否則就用HTTP的標準頭Date做簽名驗證。

最後更新：2016-05-06 10:44:22

上一篇：訪問秘鑰__API-Reference_日誌服務-阿裏雲

下一篇：公共響應頭__API-Reference_日誌服務-阿裏雲

相關內容

熱門內容

最新內容