Object Storage Service：在Header中包含V4簽名（推薦）

參數

說明

HTTP Verb

HTTP 要求方法，包含PUT、GET、POST、HEAD、DELETE、OPTIONS等。

Canonical URI

URI 編碼的資源路徑。資源路徑不包含查詢字串，其中正斜線（/）不需要編碼。

• 如果請求目標為OSS服務，則資源路徑為/，URI 編碼的資源路徑為UriEncode("/")。

• 如果請求目標為Bucket，則資源路徑：/examplebucket/，URI 編碼的資源路徑為UriEncode("/examplebucket/")。

• 如果請求目標為Bucket中的Object，則資源路徑：/examplebucket/exampleobject，URI 編碼的資源路徑：UriEncode("/examplebucket/exampleobject")

Canonical Query String

按字典排序的URI編碼的查詢參數。

• 如果查詢參數包含參數名稱和值，先對每個參數的名稱和值分別進行 URI 編碼，然後按照參數名稱的字典順序對參數進行排序。注意，排序是在編碼之後進行的。使用 = 串連編碼後的名稱和值，並使用 & 串連不同的參數。

  • 查詢參數：prefix=somePrefix&marker=someMarker&max-keys=20

  • 正常化的查詢參數：

    UriEncode("marker")+"="+UriEncode("someMarker")+"&"+UriEncode("max-keys")+"="+UriEncode("20")+"&"+UriEncode("prefix")+"="+UriEncode("somePrefix")

• 如果查詢參數只包含參數名稱，對參數名稱進行 URI 編碼。

  • 查詢參數：?acl

  • 正常化的查詢參數：UriEncode("acl")

• 如果沒有查詢參數，即請求的 URI 中不包含 ?，則正常化的查詢字串設為空白字串（""）。

Canonical Headers

要求標頭列表。

要求標頭包含以下三類：

• 要求標頭中必須存在且參與簽名的：

  • x-oss-content-sha256：目前只支援UNSIGNED-PAYLOAD。

• 要求標頭中如果存在則參與簽名的：

  • Content-Type

  • Content-MD5

  • x-oss-*：以x-oss-開頭的其他要求標頭。例如，通過 STS AK 來訪問的時候，SecurityToken 通過 x-oss-security-token:security-token 來描述。例如，請求時間通過x-oss-date來描述，格式必須為ISO8601標準時間格式，例如20231203T121212Z。

• AdditionalHeaders中指定的可選要求標頭。

格式如下：

Lowercase(<HeaderName1>) + ":" + Trim(<value>) + "\n"
Lowercase(<HeaderName2>) + ":" + Trim(<value>) + "\n"
...
Lowercase(<HeaderNameN>) + ":" + Trim(<value>) + "\n"

樣本如下：

content-disposition:attachment
content-length:3
content-md5:ICy5YqxZB1uWSwcVLSNLcA==
content-type:text/plain
x-oss-content-sha256:UNSIGNED-PAYLOAD
x-oss-date:20250328T101048Z

Additional Headers

指定參與計算簽名的可選要求標頭（不需要指定必須參與簽名的要求標頭），僅包含小寫頭名稱，並按字典序排序，以分號（;）分隔，和AdditionalHeaders保持一致。

樣本如下：

content-disposition;content-length

Hashed PayLoad

請求負載的 SHA256 雜湊值的十六進位表現形式。目前只支援取值為UNSIGNED-PAYLOAD。

參數

說明

OSS4-HMAC-SHA256

簽名雜湊演算法，取值必須是OSS4-HMAC-SHA256。

TimeStamp

當前UTC時間，格式必須是ISO8601，例如20250320T083322Z。

Scope

擷取衍生金鑰的參數集。該參數集指明了日期、地區和服務。因此，通過衍生金鑰計算的簽名只能在指定的日期、地區和服務中有效。

格式如下：

<SignDate>/<SignRegion>/oss/aliyun_v4_request

說明如下：

• SignDate：參與簽名的日期，以 YYYYMMDD格式表示。

• SignRegion：參與簽名所使用的地區ID，例如 cn-hangzhou。

• oss：參與簽名的服務名稱，固定為oss。

• aliyun_v4_request：參與簽名的版本，固定為aliyun_v4_request。

CanonicalRequest

構造的正常化請求。

參數

值

AccessKeyId

LTAI****************

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

cn-hangzhou