常见请求标头 - Amazon Glacier
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

此页面仅适用于使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。

如果您正在寻找档案存储解决方案，我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Deep Archive 中使用 Amazon Glacier 存储类。要了解有关这些存储选项的更多信息，请参阅 Amazon Glacier 存储类别。

从 2025 年 12 月 15 日起，Amazon Glacier（最初基于保管库的独立服务）将不再接受新客户，对现有客户不产生任何影响。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您的现有数据将保持安全且可以无限期地访问。无需迁移。对于低成本、长期的存档存储， Amazon 建议使用 Amazon S3 Glacier 存储类别，这些存储类别基于S3存储桶 APIs、完全 Amazon Web Services 区域 可用性、更低的成本和 Amazon 服务集成，可提供卓越的客户体验。如果您想要增强功能，可以考虑使用我们的Amazon 解决方案指南迁移到 Amazon S3 Glacier 存储类别，将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

常见请求标头

Amazon Glacier（亚马逊 Glacier）的 REST 请求包含包含请求基本信息的标头。下表描述了所有 Amazon Glacier REST 请求均可使用的标头。

标头名称 说明 必填
Authorization

对请求签名所需的标头。亚马逊 Glacier 需要签名版本 4。有关更多信息，请参阅 对请求进行签名。

类型：字符串

 是
Content-Length

请求正文（不带标头）的长度。

类型：字符串

条件：只有 上传档案（发布档案） API 才需要。

 条件
Date

可以用于创建 Authorization 标头中包含的签名的日期。如果要将 Date 标头用于签名，则必须使用 ISO 8601 基本格式来指定它。在这种情况下，不需要 x-amz-date 标头。请注意，存在 x-amz-date 时，它始终会覆盖 Date 标头的值。

如果 Date 标头不用于签名，则可以为 RFC 2616 第 3.3 部分指定的完整日期格式之一。例如，以下日期/时间Wed, 10 Feb 2017 12:00:00 GMT是用于 Amazon Glaci date/time er 的有效标题。

如果您要将 Date 标头用于签名，则它必须使用 ISO 8601 基本 YYYYMMDD'T'HHMMSS'Z' 格式。

类型：字符串

条件：如果指定了 Date，但它没有使用 ISO 8601 基本格式，则您还必须包括 x-amz-date 标头。如果使用 ISO 8601 基本格式指定了 Date，则它足够用于对请求签名，您无需 x-amz-date 标头。有关更多信息，请参阅《Amazon Web Services Glossary》中的“Handling Dates in Signature Version 4”。

 条件
Host

此标头指定您要将请求发送到的服务端点。该值的格式必须glacier.region.amazonaws.com为 “”，其中替换region为 Amazon 区域标识，例如us-west-2。

类型：字符串

 是
x-amz-content-sha256

使用上传档案（发布档案）或上传段（设置上传 ID）上传的整个有效载荷的计算 SHA256 校验和。虽然此标头与 x-amz-sha256-tree-hash 标头不同，但是，对于某些小型有效负载，值是相同的。如果需要 x-amz-content-sha256，则必须指定 x-amz-content-sha256 和 x-amz-sha256-tree-hash。

类型：字符串

条件：流式处理 API、上传档案（发布档案） 和 上传段（设置上传 ID） 需要。

 条件
x-amz-date

用于在 Authorization 标头中创建签名的日期。格式必须为使用 YYYYMMDD'T'HHMMSS'Z' 格式的 ISO 8601 基本格式。例如，以下内容 date/time 20170210T120000Zx-amz-date适用于亚马逊 Glacier。

类型：字符串

条件：x-amz-date 对所有请求而言是可选的；它可以用于覆盖对请求签名所使用的日期。如果使用 ISO 8601 基本格式指定了 Date 标头，则无需 x-amz-date。存在 x-amz-date 时，它始终会覆盖 Date 标头的值。有关更多信息，请参阅《Amazon Web Services Glossary》中的“Handling Dates in Signature Version 4”。

 条件
x-amz-glacier-version

要使用的亚马逊 Glacier API 版本。当前版本为 2012-06-01。

类型：字符串

 是
x-amz-sha256-tree-hash

已上传档案 (上传档案（发布档案）) 或档案部分 () 的计算出的 SHA256 树形哈希校验和。上传段（设置上传 ID）有关计算此校验和的更多信息，请参阅“计算校验和”。

类型：字符串

默认值：无

条件：上传档案（发布档案） 和 上传段（设置上传 ID） 需要。

 条件