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

列出分段上传(获取分段上传)

描述

此分段上传操作会列出指定文件库中正在进行的分段上传。正在进行的分段上传是 启动分段上传(发布分段上传) 请求启动但尚未完成或中止的分段上传。在列出分段上传响应中返回的列表没有固定的顺序。

列出分段上传操作支持分页。默认情况下,此操作最多会在响应中返回 50 个分段上传。您应始终检查响应正文中的 marker 字段,以查看是否有继续该列表的标记;如果没有更多项目,则 marker 字段为 null

如果 marker 不为 null,则为了获取下一组分段上传,您可以再发送一个“列出分段上传”请求,并将 marker 请求参数设置为 Amazon Glacier 对上一次“列出分段上传”请求所回复的标记值。

请注意此操作与 列出段(获取上传 ID) 操作之间的区别。列出分段上传操作会列出文件库的所有分段上传。列出段操作会返回上传 ID 标识的特定分段上传的段。

有关分段上传的信息,请参阅“分段上传大型档案(分段上传)”。

请求

语法

要列出分段上传,请向文件库的 multipart-uploads 子资源的 URI 发送 GET 请求。您可以选择性地指定 markerlimit 参数。

GET /AccountId/vaults/VaultName/multipart-uploads 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 { "Marker": String, "UploadsList" : [ { "ArchiveDescription": String, "CreationDate": String, "MultipartUploadId": String, "PartSizeInBytes": Number, "VaultARN": String }, ... ] }

响应标头

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

响应正文

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

ArchiveDescription

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

类型:字符串

CreationDate

分段上传启动的 UTC 时间。

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

Marker

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

类型:字符串

PartSizeInBytes

启动分段上传(发布分段上传) 请求中指定的段大小。这是上传中除了最后一段以外的所有段的大小,最后一段可能小于此大小。

类型:数字

MultipartUploadId

分段上传的 ID。

类型:字符串

UploadsList

有关分段上传数据元的元数据的列表。列表中的每个项目均包含相应上传的一组名称-值对,包括 ArchiveDescriptionCreationDateMultipartUploadIdPartSizeInBytesVaultARN

类型:数组

VaultARN

包含档案的文件库的Amazon 资源名称 (ARN)。

类型:字符串

错误

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

示例

示例:列出所有分段上传

以下示例列出了文件库的正在进行的所有分段上传。该示例显示了发送到指定文件库的 multipart-uploads 子资源 URI 的 HTTP GET 请求。由于请求中没有指定 markerlimit 参数,因此,系统最多会返回 1000 个正在进行的分段上传。

示例请求

GET /-/vaults/examplevault/multipart-uploads 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 返回指定文件库所有正在进行的分段上传的列表。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: 1054 { "Marker": null, "UploadsList": [ { "ArchiveDescription": "archive 1", "CreationDate": "2012-03-19T23:20:59.130Z", "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev", "PartSizeInBytes": 4194304, "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }, { "ArchiveDescription": "archive 2", "CreationDate": "2012-04-01T15:00:00.000Z", "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", "PartSizeInBytes": 4194304, "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }, { "ArchiveDescription": "archive 3", "CreationDate": "2012-03-20T17:03:43.221Z", "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", "PartSizeInBytes": 4194304, "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ] }

示例:分段上传的部分列表

以下示例展示了如何使用分页来获取有限数量的结果。该示例显示了发送到指定文件库的 multipart-uploads 子资源 URI 的 HTTP GET 请求。在此示例中,limit 参数设置为 1,这意味着只在列表中返回一个上传,而 marker 参数则表示返回的列表从其开始的分段上传 ID。

示例请求

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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 只返回指定文件库的最多两个正在进行的分段上传,从指定的标记开始返回两个结果。

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: 470 { "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", "UploadsList" : [ { "ArchiveDescription": "archive 2", "CreationDate": "2012-04-01T15:00:00.000Z", "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", "PartSizeInBytes": 4194304, "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ] }