本文介紹了Object Storage Service的公用要求標頭和公用回應標頭的詳細說明。
公用要求標頭(Common Request Headers)
OSS的RESTful介面中使用了一些公用要求標頭,這些要求標頭可以被所有的OSS請求使用,其詳細定義請參見下表。
名稱 | 類型 | 樣本值 | 描述 |
Authorization | 字串 | OSS4-HMAC-SHA256 Credential=**** | 在非匿名請求中,用於驗證請求合法性的認證資訊。關於Authorization計算方法的更多資訊,請參見簽名版本4(推薦)。 預設值:無 |
Content-Length | 字串 | 556 | RFC 2616中定義的HTTP請求內容長度。 預設值:無 |
Content-Type | 字串 | application/xml | RFC 2616中定義的HTTP請求內容類型。 預設值:無 |
Date | 字串 | Sun, 05 Sep 2021 23:00:00 GMT | HTTP 1.1協議中規定的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臨時授權帳號訪問OSS時需要配置該選項。關於如何擷取Security-Token的具體操作,請參見AssumeRole - 擷取扮演角色的臨時身份憑證。 |
公用回應標頭(Common Response Headers)
OSS的RESTful介面中使用了一些公用回應標頭。這些回應標頭可以被所有的OSS請求所使用,其詳細定義請參見下表。
名稱 | 類型 | 樣本值 | 描述 |
Content-Length | 字串 | 556 | RFC 2616中定義的HTTP請求內容長度。 預設值:無 |
Connection | 枚舉 | keep-alive | 標明用戶端和OSS伺服器之間的連結狀態。 有效值:keep-alive、close 預設值:無 |
Date | 字串 | Sun, 05 Sep 2021 23:00:00 GMT | HTTP 1.1協議中規定的GMT時間。 預設值:無 |
ETag | 字串 | 5B3C1A2E053D763E1B002CC607C5A0FE1**** | ETag (entity tag) 在每個Object產生的時候被建立,用於標識一個Object的內容。對於Put Object請求建立的Object,ETag值是其內容的MD5值;對於其他方式建立的Object,ETag值是基於一定計算規則產生的唯一值,但不是其內容的MD5值。ETag值可以用於檢查Object內容是否發生變化。 預設值:無 |
Server | 字串 | AliyunOSS | 產生Response的伺服器。 預設值:AliyunOSS |
x-oss-request-id | 字串 | 534B371674E88A4D8906**** | 用於唯一標識該次請求的UUID。您可以憑藉此Request ID聯絡支援人員,排查並解決您遇到的問題。關於擷取Request ID的具體操作,請參見擷取Request ID。 預設值:無 |