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

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

常见请求标头

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

标头名称 描述 必需
Authorization

对请求签名所需的标头。S3 冰川需要签名版本 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是用于的有效日期/时间标头。

如果您要将 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“,其中区域被替换为Amazon区域指定,如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是有效的x-amz-date与 S3 冰川一起使用。

类型: 字符串

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

要使用的 S3 冰川 API 版本。当前版本为 2012-06-01

类型: 字符串

x-amz-sha256-tree-hash

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

类型: 字符串

默认值:无

条件:对于 是必需的上传档案(发布档案)上传段(设置上传 ID)

条件