常見請求標題 - Amazon S3 Glacier

此頁面僅適用於使用 Vault 和 REST API 2012 年原始版本的 S3 Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱 Amazon S3 使用者指南 中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，適用於所有區域，並且可以在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

常見請求標題

Amazon S3 Glacier (S3 Glacier) REST 請求包含的標頭包含有關請求的基本資訊。下表描述了所有 S3 Glacier REST 請求可以使用的標頭。

標頭名稱 描述 必要
Authorization

簽署請求所需的標頭。S3 Glacier 需要簽章版本 4。如需更多詳細資訊，請參閱 簽署請求。

類型：字串

 是
Content-Length

請求本文的長度 (不含標頭)。

類型：字串

條件：僅適用於 上傳封存 (POST 封存) API。

 有條件
Date

用來建立 Authorization 標頭中包含的簽章的日期。如果要使用 Date 標頭簽署時，必須指定要使用 ISO 8601 基本格式。在這種情況下，不需要 x-amz-date 標頭。請注意，當 x-amz-date 存在時，一律覆寫 Date 標頭的值。

如果日期標頭不會用來簽署， 則它可以是 RFC 2616 (3.3 節) 指定的完整日期格式之一。例如，以下日期/時間 Wed, 10 Feb 2017 12:00:00 GMT 是與 S3 Glacier 搭配使用的有效日期/時間標頭。

如果您使用 Date 標頭進行簽署，則必須採用 ISO 8601 基本的 YYYYMMDD'T'HHMMSS'Z' 格式。

類型：字串

條件：如果已指定 Date，但不符合 ISO 8601 基本格式，則必須也包含 x-amz-date 標頭。如果 Date 是以 ISO 8601 基本格式指定的，那麼這對於簽署請求已足夠，並且您不需要 x-amz-date 標頭。如需詳細資訊，請參閱 Amazon Web Services 詞彙表中的 Signature 第 4 版中的處理日期。

 有條件
Host

此標頭指定您傳送請求的服務終端節點。值格式必須是「glacier.region.amazonaws.com」，其中 region 會替換為 AWS 區域目的地，例如 us-west-2。

類型：字串

 是
x-amz-content-sha256

使用 上傳封存 (POST 封存) 或 分段上傳 (PUT uploadID) 上傳的整個承載的計算 SHA256 檢查總和。這個標頭與 x-amz-sha256-tree-hash 標頭不同，但是對於某些小型承載，這些值是相同的。當 x-amz-content-sha256 是必要的，必須指定 x-amz-content-sha256 和 x-amz-sha256-tree-hash。

類型：字串

條件：串流 API 的必要項目、上傳封存 (POST 封存) 和 分段上傳 (PUT uploadID)。

 有條件
x-amz-date

用來在授權標頭中建立簽章的日期。格式必須是 ISO 8601 基本的 YYYYMMDD'T'HHMMSS'Z' 格式。例如，下列日期/時間 20170210T120000Z 是與 S3 Glacier 搭配使用的有效 x-amz-date。

類型：字串

條件：x-amz-date 對所有請求都是選用的，都可以用於覆寫用於簽署請求的日期。如果 Date 標頭是以 ISO 8601 基本格式指定的，則不需要 x-amz-date。當 x-amz-date 存在時，一律覆寫 Date 標頭的值。如需詳細資訊，請參閱 Amazon Web Services 詞彙表中的 Signature 第 4 版中的處理日期。

 有條件
x-amz-glacier-version

要使用的 S3 Glacier API 版本。目前版本是 2012-06-01。

類型：字串

 是
x-amz-sha256-tree-hash

上傳封存 (上傳封存 (POST 封存)) 或封存部分 (分段上傳 (PUT uploadID)) 的計算 SHA256 樹雜湊檢查總和。如需計算此檢查總和的詳細資訊，請參閱 運算檢查總和。

類型：字串

預設：無

條件：上傳封存 (POST 封存) 和 分段上傳 (PUT uploadID) 是必要的。

 有條件