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

列出段(获取上传 ID)

描述

此分段上传操作会列出上传 ID 标识的特定分段上传中已上传的档案的段。有关分段上传的信息,请参阅“分段上传大型档案(分段上传)”。

在完成分段上传前,您可以在正在进行的分段上传过程中随时发送此请求。 Amazon Glacier 会返回段列表,该列表按您在每一段上传中指定的范围排序。如果您在完成分段上传后发送“列出段”请求,则 Amazon Glacier 返回错误。

列出段操作支持分页。您应始终检查响应正文中的 Marker 字段,以查看是否有继续该列表的标记;如果没有更多项目,则 marker 字段为 null。如果 marker 不为 null,则为了获取下一组段,您可以发送另一个“列出段”请求,并将 marker 请求参数设置为 Amazon Glacier 为响应您之前的“列出段”请求而返回的标记值。

您也可以通过在请求中指定 limit 参数来限制响应中返回的段数。

请求

语法

要列出正在进行的分段上传的段,您可以向分段上传 ID 资源的 URI 发送 GET 请求。当您启动分段上传 (启动分段上传(发布分段上传)) 时,系统会返回分段上传 ID。您可以选择性地指定 markerlimit 参数。

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 Host: glacier.Region.amazonaws.com.cn Date: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01

注意

AccountId 值为拥有文件库的账户的 AWS 账户 ID。您可以指定一个 AWS 账户 ID 或者选择指定单一的“-” (连字符),在这种情况下,Amazon Glacier 会使用与用于对请求签名的证书关联的 AWS 账户 ID。如果您使用账户 ID,请勿在该 ID 中包括连字符 (“-”)。

请求参数

名称 描述 必需
limit

要返回部分的最大数目。默认限制为 50。返回的部分数可能少于指定的限制值,但永远不会超过限制值。

类型:字符串

限制:最小值为 1。最大值为 50

marker

用于分页的不透明字符串。marker 指定应从其开始列出段的段。从之前的列出段响应获取 marker 值。只有在您要继续对之前的列出段请求中开始的结果进行分页,您才需要包括 marker

类型:字符串

限制:无

请求标头

此操作仅使用大多数响应通用的响应头。有关通用响应头的信息,请参阅常用响应标头

请求正文

此操作没有请求正文。

响应

语法

HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "ArchiveDescription" : String, "CreationDate" : String, "Marker": String, "MultipartUploadId" : String, "PartSizeInBytes" : Number, "Parts" : [ { "RangeInBytes" : String, "SHA256TreeHash" : String }, ... ], "VaultARN" : String }

响应标头

此操作仅使用大多数响应通用的响应头。有关通用响应头的信息,请参阅常用响应标头

响应正文

响应正文包含以下 JSON 字段。

ArchiveDescription

在启动分段上传请求中指定的档案描述。如果在启动分段上传操作中没有指定档案描述,则此字段为 null

类型:字符串

CreationDate

分段上传启动的 UTC 时间。

类型:字符串。ISO 8601 日期格式的字符串表示形式,例如,2013-03-20T17:03:43.221Z

Marker

表示从何处继续对结果进行分页的不透明字符串。您可以在新的列出段请求中使用 marker 来获取列表中的更多段。如果没有更多段,则此值为 null

类型:字符串

MultipartUploadId

段与其相关联的上传的 ID。

类型:字符串

PartSizeInBytes

段大小(以字节为单位)。这是您在启动分段上传请求中指定的相同值。

类型:数字

Parts

分段上传的段大小的列表。数组中的每个数据元均包含 RangeBytessha256-tree-hash 名称/值对。

类型:数组

RangeInBytes

段的字节范围,包括范围的上限值。

类型:字符串

SHA256TreeHash

Amazon Glacier 为段计算的 SHA256 树形哈希值。此字段绝不为 null

类型:字符串

VaultARN

向其启动分段上传的文件库的Amazon 资源名称 (ARN)。

类型:字符串

错误

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

示例

示例 – 列出分段上传的段

以下示例列出了上传的所有段。该示例向正在进行的分段上传的特定分段上传 ID URI 发送 HTTP GET 请求,并且最多返回 1000 段。

示例请求

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 Host: glacier.us-west-2.amazonaws.com.cn x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

响应示例

在响应中,Amazon Glacier 返回与指定分段上传 ID 相关联的上传段的列表。在此示例中,只有两段。返回的 Marker 字段为 null,表示没有更多分段上传的段。

HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 412 { "ArchiveDescription" : "archive description", "CreationDate" : "2012-03-20T17:03:43.221Z", "Marker": null, "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", "PartSizeInBytes" : 4194304, "Parts" : [ { "RangeInBytes" : "0-4194303", "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" }, { "RangeInBytes" : "4194304-8388607", "SHA256TreeHash" : "0195875365afda349fc21c84c099987164" }], "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" }

示例 – 列出分段上传的段(指定标记和限制请求参数)

以下示例展示了如何使用分页来获取有限数量的结果。该示例向正在进行的分段上传的特定分段上传 ID URI 发送 HTTP GET 请求,以返回一段。开始 marker 参数指定从哪段开始段列表。您可以从之前的段列表请求的响应获取 marker 值。此外,在此示例中,limit 参数设置为 1,并且返回一段。请注意,Marker 字段不为 null,表示至少还有另一段要获取。

示例请求

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1 Host: glacier.us-west-2.amazonaws.com.cn x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

响应示例

在响应中,Amazon Glacier 返回与正在进行的指定分段上传 ID 相关联的上传段的列表。

HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: text/json Content-Length: 412 { "ArchiveDescription" : "archive description 1", "CreationDate" : "2012-03-20T17:03:43.221Z", "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ", "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", "PartSizeInBytes" : 4194304, "Parts" : [ { "RangeInBytes" : "4194304-8388607", "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" }], "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" }