**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。** 如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)。 Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 通用请求标头 Amazon Glacier（Amazon Glacier）REST 请求采用包含此请求基本说明的标头。下表描述了所有 Amazon Glacier REST 请求均可使用的标头。 | 标头名称 | 描述 | 是否必需 | | --- | --- | --- | | Authorization | 对请求签名所需的标头。Amazon Glacier 需要签名版本 4。有关更多信息，请参阅[对请求进行签名](amazon-glacier-signing-requests.md)。 类型：字符串 | 是 | | Content-Length | 请求正文（不带标头）的长度。 类型：字符串 条件：只有 [上传档案（POST archive）](api-archive-post.md) API 才需要。 | 有条件 | | Date | 可以用于创建 `Authorization` 标头中包含的签名的日期。如果要将 `Date` 标头用于签名，则必须使用 ISO 8601 基本格式来指定它。在这种情况下，不需要 `x-amz-date` 标头。请注意，存在 `x-amz-date` 时，它始终会覆盖 `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` 标头。如果使用 ISO 8601 基本格式指定了 `Date`，则它足够用于对请求签名，您无需 `x-amz-date` 标头。有关更多信息，请参阅《Amazon Web 服务词汇表》中的[处理签名版本 4 中的日期](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html)**。 | 有条件 | | Host | 此标头指定您要将请求发送到的服务端点。值必须为“`glacier.region.amazonaws.com`”格式，其中，*区域*由 AWS 区域名称（例如 `us-west-2`）代替。 类型：字符串 | 是 | | x-amz-content-sha256 | 对通过 [上传档案（POST archive）](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 archive）](api-archive-post.md) 和 [上传段（PUT uploadID）](api-upload-part.md) 需要。 | 有条件 | | x-amz-date | 用于在 Authorization 标头中创建签名的日期。格式必须为使用 `YYYYMMDD'T'HHMMSS'Z'` 格式的 ISO 8601 基本格式。例如，以下日期/时间 `20170210T120000Z` 是用于 Amazon Glacier 的有效 `x-amz-date`。 类型：字符串 条件：`x-amz-date` 对所有请求而言是可选的；它可以用于覆盖对请求签名所使用的日期。如果使用 ISO 8601 基本格式指定了 `Date` 标头，则无需 `x-amz-date`。存在 `x-amz-date` 时，它始终会覆盖 `Date` 标头的值。有关更多信息，请参阅《Amazon Web 服务词汇表》中的[处理签名版本 4 中的日期](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html)**。 | 有条件 | | x-amz-glacier-version | 要使用的 Amazon Glacier API 版本。当前版本为 `2012-06-01`。 类型：字符串 | 是 | | x-amz-sha256-tree-hash | 对上传的档案（[上传档案（POST archive）](api-archive-post.md)）或档案段（[上传段（PUT uploadID）](api-upload-part.md)）进行计算得出的 SHA256 树形哈希校验和。有关计算此校验和的更多信息，请参阅[计算校验和](checksum-calculations.md)。 类型：字符串 默认值：无 条件：[上传档案（POST archive）](api-archive-post.md) 和 [上传段（PUT uploadID）](api-upload-part.md) 需要。 | 有条件 |