

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

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 [Amazon Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)。

Amazon Glacier （原始獨立保存庫型服務） 不再接受新客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議使用 [Amazon S3 Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 [AWS Amazon Glacier Amazon S3 ](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)

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

# 常見請求標題
<a name="api-common-request-headers"></a>

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


| 標頭名稱 | 說明 | 必要 | 
| --- | --- | --- | 
| Authorization |  簽署請求所需的標頭。Amazon Glacier 需要 Signature 第 4 版。如需詳細資訊，請參閱[簽署請求](amazon-glacier-signing-requests.md)。 類型：字串  | 是 | 
| Content-Length |  請求本文的長度 (不含標頭)。 類型：字串 條件：僅適用於 [上傳封存 (POST 封存)](api-archive-post.md) API。  | 有條件 | 
| Date |  用來建立 `Authorization` 標頭中包含的簽章的日期。如果要使用 `Date` 標頭簽署時，必須指定要使用 ISO 8601 基本格式。在這種情況下，不需要 `x-amz-date` 標頭。請注意，當 `x-amz-date` 存在時，一律覆寫 `Date` 標頭的值。 如果日期標頭不會用來簽署， 則它可以是 [RFC 2616](http://tools.ietf.org/html/rfc2616#section-3.3) (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 詞彙表](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html)中的 *Signature 第 4 版中的處理日期*。  | 有條件  | 
| Host |  此標頭指定您傳送請求的服務終端節點。值的格式必須是 "`glacier.region.amazonaws.com`"，其中*區域*會取代為 AWS 區域名稱，例如 `us-west-2`。 類型：字串  | 是 | 
| x-amz-content-sha256 |  使用 [上傳封存 (POST 封存)](api-archive-post.md) 或 [分段上傳 (PUT uploadID)](api-upload-part.md) 上傳的整個承載的計算 SHA256 檢查總和。這個標頭與 `x-amz-sha256-tree-hash` 標頭不同，但是對於某些小型承載，這些值是相同的。當 `x-amz-content-sha256` 是必要的，必須指定 `x-amz-content-sha256` 和 `x-amz-sha256-tree-hash`。 類型：字串 條件：串流 API 的必要項目、[上傳封存 (POST 封存)](api-archive-post.md) 和 [分段上傳 (PUT uploadID)](api-upload-part.md)。  | 有條件 | 
| x-amz-date |  用來在授權標頭中建立簽章的日期。格式必須是 ISO 8601 基本的 `YYYYMMDD'T'HHMMSS'Z'` 格式。例如，下列日期/時間`20170210T120000Z``x-amz-date`適用於 Amazon Glacier。 類型：字串 條件：`x-amz-date` 對所有請求都是選用的，都可以用於覆寫用於簽署請求的日期。如果 `Date` 標頭是以 ISO 8601 基本格式指定的，則不需要 `x-amz-date`。當 `x-amz-date` 存在時，一律覆寫 `Date` 標頭的值。如需詳細資訊，請參閱 [Amazon Web Services 詞彙表](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html)中的 *Signature 第 4 版中的處理日期*。  | 有條件 | 
| x-amz-glacier-version |  要使用的 Amazon Glacier API 版本。目前版本是 `2012-06-01`。 類型：字串  | 是 | 
| x-amz-sha256-tree-hash |  上傳封存 ([上傳封存 (POST 封存)](api-archive-post.md)) 或封存部分 ([分段上傳 (PUT uploadID)](api-upload-part.md)) 的計算 SHA256 樹雜湊檢查總和。如需計算此檢查總和的詳細資訊，請參閱 [運算檢查總和](checksum-calculations.md)。 類型：字串 預設：無 條件：[上傳封存 (POST 封存)](api-archive-post.md) 和 [分段上傳 (PUT uploadID)](api-upload-part.md) 是必要的。  | 有條件 | 