常见请求标头 - Amazon S3 Glacier

此页面仅适用于使用保管库的 S3 Glacier 服务的现有客户以及 2012 年以RESTAPI来的原始客户。

如果您正在寻找档案存储解决方案,我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Dee p Archive 中使用 S3 Glacier 存储类。要了解有关这些存储选项的更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类和使用 S3 Glacier 存储类的长期数据存储。这些存储类别使用 Amazon S3API,适用于所有区域,并且可以在 Amazon S3 控制台中进行管理。它们提供存储成本分析、存储镜头、高级可选加密功能等功能。

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

常见请求标头

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

标头名称 描述 必填
Authorization

对请求签名所需的标头。S3 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 是用于 S3 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”格式,其中,区域由 AWS 区域名称(例如 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 是用于 S3 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

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

类型:字符串

x-amz-sha256-tree-hash

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

类型:字符串

默认值:无

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

条件