上传档案（发布档案） - Simple Storage Service（Amazon S3）Glacier
描述请求响应示例相关部分
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

上传档案（发布档案）

描述

此操作会向文件库添加档案。对于成功的上传，您的数据会持久保留。作为响应，Amazon S3 Glacier（S3 Glacier）在响应x-amz-archive-id标题中返回档案 ID。您应保存返回的档案 ID，以便在以后访问档案。

您必须提供您要上传的数据的 SHA256 树形哈希。有关计算 SHA256 树形哈希的信息，请参阅“计算校验和”。

注意

使用 API 时，只有上传档案（POST 档案）操作才需要 SHA256 树哈希。使用时不是必需的Amazon CLI。

上传档案时，您可以选择指定最多 1,024 个可打印 ASCII 字符的档案描述。当您检索档案或获取文件库清单时，S3 Glacier 会返回档案描述。S3 Glacier 不会以任何方式解释描述。档案描述不需要是唯一的。您不能使用描述来取回档案列表或者对档案列表进行排序。

除了可选的档案描述外，S3 Glacier 不支持档案的任何其他元数据。档案 ID 是字符的不透明序列，您无法从其推断有关档案的任何含意。因此，您可能会在客户端维护有关档案的元数据。有关更多信息，请参阅在 Amazon S3 Glacier 中使用档：

档案是不可变的。上传档案后，您无法编辑档案或其描述。

请求

要上传档案，您可以使用 HTTP POST 方法，并将请求纳入到您要在其中保存档案的文件库的 archives 子资源。请求必须包括档案有效负载大小和校验和（SHA256 树形哈希），并且可以选择性地包括档案的描述。

语法

POST /AccountId/vaults/VaultName/archives
Host: glacier.Region.amazonaws.com
x-amz-glacier-version: 2012-06-01
Date: Date
Authorization: SignatureValue
x-amz-archive-description: Description
x-amz-sha256-tree-hash: SHA256 tree hash
x-amz-content-sha256: SHA256 linear hash
Content-Length: Length

<Request body.>

注意

该AccountId值是拥有文件库的账户的Amazon Web Services 账户 ID。您可以指定Amazon Web Services 账户 ID，也可以选择单个 “-”（连字符），在这种情况下，Amazon S3 Glacier 使用与用于签署请求的证书关联的Amazon Web Services 账户 ID。如果您使用账户 ID，请勿在 ID 中包含任何连字符 ('-')。

请求参数

此操作的实施不使用请求参数。

请求标头

除了所有操作通用的请求标头外，此操作还使用以下请求标头。有关常见的请求标头的更多信息，请参阅常见请求标头。

名称 描述 必填
Content-Length

数据元的大小（以字节为单位）。有关更多信息，请转到 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13。

类型：数字

默认值：无

限制：无

 是
x-amz-archive-description

您要上传的档案的可选描述。它可以为明语描述或者您选择来分配的某个标识符。描述不需要在所有档案中是唯一的。当您取回文件库清单（请参阅“启动作业（POST 作业）”）时，它会包括因做出响应而返回的每个档案的此描述。

类型：字符串

默认值：无

限制：描述的长度必须小于或等于 1024 个字符。允许的字符是没有控制码的 7 位 ASCII，特别是 ASCII 值 32—126 十进制或 0x20—0x7E 十六进制。

 否
x-amz-content-sha256

有效负载的 SHA256 校验和（线性哈希）。这不是您在 x-amz-sha256-tree-hash 标头中指定的相同值。

类型：字符串

默认值：无

限制：无

 是
x-amz-sha256-tree-hash

用户计算的有效负载的校验和（SHA256 树形哈希）。有关计算 SHA256 树形哈希的信息，请参阅“计算校验和”。如果 S3 Glacier 计算出不同的负载校验和，它将拒绝请求。

类型：字符串

默认值：无

限制：无

 是

请求正文

请求正文包含要上传的数据。

响应

作为响应，S3 Glacier 会持久存储档案并返回档案 ID 的 URI 路径。

语法

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
Location: Location
x-amz-archive-id: ArchiveId

响应标头

成功的响应包括以下响应标头，以及所有操作通用的响应标头。有关常见的响应标头的更多信息，请参阅常用响应标头。

名称 描述
Location

新添加的档案资源的相对 URI 路径。

类型：字符串
x-amz-archive-id

档案的 ID。此值也包括在 Location 标头中，作为该标头的一部分。

类型：字符串
x-amz-sha256-tree-hash​

由 S3 Glacier 计算的档案校验和。

类型：字符串

响应正文

此操作不会返回响应正文。

错误

有关 Amazon S3 Glacier 异常和错误消息的信息，请参阅错误响应。

示例

示例请求

以下示例显示了上传档案的请求。

POST /-/vaults/examplevault/archives HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
Content-Length: 2097152
x-amz-glacier-version: 2012-06-01
Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace

<Request body (2097152 bytes).>

响应示例

下面的成功响应有一个Location标头，您可以在其中获取 S3 Glacier 分配给档案的 ID。

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

相关部分