通用请求标头 - Amazon Glacier

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

如果您正在寻找归档存储解决方案,建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息,请参阅 Amazon Glacier 存储类别

Amazon Glacier(最初基于保管库的独立服务)不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ,拥有自己的服务,可将数据存储在文件库中,不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中,您现有的数据将确保安全,并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储, AWS 建议使用 Amazon S3 Glacier 存储类别,这些存储类别基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成,可提供卓越的客户体验。如果您希望加强功能,可以考虑使用我们的 AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南,迁移到 Amazon S3 Glacier 存储类别。

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

通用请求标头

Amazon Glacier(Amazon Glacier)REST 请求采用包含此请求基本说明的标头。下表描述了所有 Amazon Glacier REST 请求均可使用的标头。

标头名称 描述 是否必需
Authorization

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

类型:字符串

Content-Length

请求正文(不带标头)的长度。

类型:字符串

条件:只有 上传档案(POST archive) 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 Glacier 的有效日期/时间标头。

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

类型:字符串

条件:如果指定了 Date,但它没有使用 ISO 8601 基本格式,则您还必须包括 x-amz-date 标头。如果使用 ISO 8601 基本格式指定了 Date,则它足够用于对请求签名,您无需 x-amz-date 标头。有关更多信息,请参阅《Amazon Web 服务词汇表》中的处理签名版本 4 中的日期

有条件
Host

此标头指定您要将请求发送到的服务端点。值必须为“glacier.region.amazonaws.com”格式,其中,区域由 AWS 区域名称(例如 us-west-2)代替。

类型:字符串

x-amz-content-sha256

对通过 上传档案(POST archive)上传段(PUT uploadID) 上传的整个有效载荷进行计算得出的 SHA256 校验和。虽然此标头与 x-amz-sha256-tree-hash 标头不同,但是,对于某些小型有效载荷,值是相同的。如果需要 x-amz-content-sha256,则必须指定 x-amz-content-sha256x-amz-sha256-tree-hash

类型:字符串

条件:流式处理 API、上传档案(POST archive)上传段(PUT uploadID) 需要。

有条件
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 中的日期

有条件
x-amz-glacier-version

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

类型:字符串

x-amz-sha256-tree-hash

对上传的档案(上传档案(POST archive))或档案段(上传段(PUT uploadID))进行计算得出的 SHA256 树形哈希校验和。有关计算此校验和的更多信息,请参阅计算校验和

类型:字符串

默认值:无

条件:上传档案(POST archive)上传段(PUT uploadID) 需要。

有条件