Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

常见请求标头

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

标头名称 描述 必需
Authorization

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

类型:字符串

Content-Length

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

类型:字符串

条件:只有 上传档案(发布档案) API 才需要。

条件
Date

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

Date 标头如果不用于签名,则可以采用第 3.3 节 RFC 2616 中指定的完整日期格式之一。例如,以下日期/时间 Wed, 10 Feb 2017 12:00:00 GMT 是用于 Glacier 的有效日期/时间标头。

如果您要将 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.cn”格式,其中,区域由区域名称(例如 us-west-2)代替。

类型:字符串

x-amz-content-sha256

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

类型:字符串

条件:流式处理 API、上传档案(发布档案)上传段(设置上传 ID) 需要。

条件
x-amz-date

用于在 Authorization 标头中创建签名的日期。格式必须为使用 YYYYMMDD'T'HHMMSS'Z' 格式的 ISO 8601 基本格式。例如,以下日期/时间 20170210T120000Z 是用于 Glacier 的有效 x-amz-date

类型:字符串

条件: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

对上传的档案 (上传档案(发布档案)) 或档案段 (上传段(设置上传 ID)) 进行计算得出的 SHA256 树形哈希校验和。有关计算此校验和的更多信息,请参阅“计算校验和”。

类型:字符串

默认值:无

条件:上传档案(发布档案)上传段(设置上传 ID) 需要。

条件