常見請求標題 - Amazon Glacier

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

如果您要尋找封存儲存解決方案,建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項,請參閱 Amazon Glacier 儲存類別

自 2025 年 12 月 15 日起,Amazon Glacier (原始獨立保存庫型服務) 將不再接受新客戶,不會影響現有客戶。Amazon Glacier 是一項獨立服務,具有自己的 APIs,可將資料存放在保存庫中,並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存, AWS 建議採用 Amazon S3 Glacier 儲存類別,透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合,提供卓越的客戶體驗。如果您想要增強功能,請考慮使用我們的解決方案指南,將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別,以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

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

常見請求標題

Amazon Glacier (Amazon Glacier) REST 請求包含包含請求基本資訊的標頭。下表說明所有 Amazon Glacier REST 請求可以使用的標頭。

標頭名稱 說明 必要
Authorization

簽署請求所需的標頭。Amazon Glacier 需要 Signature 第 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是與 Amazon 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",其中區域會取代為 AWS 區域名稱,例如 us-west-2

類型:字串

x-amz-content-sha256

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

類型:字串

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

有條件
x-amz-date

用來在授權標頭中建立簽章的日期。格式必須是 ISO 8601 基本的 YYYYMMDD'T'HHMMSS'Z' 格式。例如,下列日期/時間20170210T120000Zx-amz-date適用於 Amazon Glacier。

類型:字串

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

有條件
x-amz-glacier-version

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

類型:字串

x-amz-sha256-tree-hash

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

類型:字串

預設:無

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

有條件