常見請求標題

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) 是必要的。	有條件