公共HTTP頭定義
本文介紹了對象存儲OSS的公共請求頭和公共響應(yīng)頭的詳細說明。
公共請求頭(Common Request Headers)
OSS的RESTful接口中使用了一些公共請求頭,這些請求頭可以被所有的OSS請求使用,其詳細定義請參見下表。
名稱 | 類型 | 示例值 | 描述 |
Authorization | 字符串 | OSS4-HMAC-SHA256 Credential=**** | 在非匿名請求中,用于驗證請求合法性的認證信息。關(guān)于Authorization計算方法的更多信息,請參見簽名版本4(推薦)。 默認值:無 |
Content-Length | 字符串 | 556 | RFC 2616中定義的HTTP請求內(nèi)容長度。 默認值:無 |
Content-Type | 字符串 | application/xml | RFC 2616中定義的HTTP請求內(nèi)容類型。 默認值:無 |
Date | 字符串 | Sun, 05 Sep 2021 23:00:00 GMT | HTTP 1.1協(xié)議中規(guī)定的GMT時間。 默認值:無 |
Host | 字符串 | oss-example.oss-cn-hangzhou.aliyuncs.com | 訪問域名。支持以下三種類型:
默認值:無 |
x-oss-security-token | 字符串 | CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3+pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ+LmNpy/Ht6md1HDkAJq3LL+bk/Mdle5MJqP+/kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86+ysIP+phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq+3+FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU+KFBxpGaq8c1SU5ARo+1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2+20yrDNevWSSqnwh0qXMI3zY5**** | 僅在使用STS臨時授權(quán)賬號訪問OSS時需要配置該選項。關(guān)于如何獲取Security-Token的具體操作,請參見AssumeRole - 獲取扮演角色的臨時身份憑證。 |
公共響應(yīng)頭(Common Response Headers)
OSS的RESTful接口中使用了一些公共響應(yīng)頭。這些響應(yīng)頭可以被所有的OSS請求所使用,其詳細定義請參見下表。
名稱 | 類型 | 示例值 | 描述 |
Content-Length | 字符串 | 556 | RFC 2616中定義的HTTP請求內(nèi)容長度。 默認值:無 |
Connection | 枚舉 | keep-alive | 標明客戶端和OSS服務(wù)器之間的鏈接狀態(tài)。 有效值:keep-alive、close 默認值:無 |
Date | 字符串 | Sun, 05 Sep 2021 23:00:00 GMT | HTTP 1.1協(xié)議中規(guī)定的GMT時間。 默認值:無 |
ETag | 字符串 | 5B3C1A2E053D763E1B002CC607C5A0FE1**** | ETag (entity tag) 在每個Object生成的時候被創(chuàng)建,用于標識一個Object的內(nèi)容。對于Put Object請求創(chuàng)建的Object,ETag值是其內(nèi)容的MD5值;對于其他方式創(chuàng)建的Object,ETag值是基于一定計算規(guī)則生成的唯一值,但不是其內(nèi)容的MD5值。ETag值可以用于檢查Object內(nèi)容是否發(fā)生變化。 默認值:無 |
Server | 字符串 | AliyunOSS | 生成Response的服務(wù)器。 默認值:AliyunOSS |
x-oss-request-id | 字符串 | 534B371674E88A4D8906**** | 用于唯一標識該次請求的UUID。您可以憑借此Request ID聯(lián)系技術(shù)支持,排查并解決您遇到的問題。關(guān)于獲取Request ID的具體操作,請參見獲取Request ID。 默認值:無 |