列出分段上传(获取分段上传) - Amazon S3 Glacier
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

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

Description

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

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

如果marker不为 null,则为了获取下一组分段上传,您可以再发送一个 “列出分段上传” 请求,并使用marker请求参数设置为响应您之前的 “列出分段上传” 请求而返回的标记值 Amazon S3 Glacier (S3 Glacier) 的操作。

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

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

Requests

Syntax

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

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

注意

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

请求参数

名称 描述 必需
limit

指定响应正文中返回的最大上传数。如果未指定,则列出上传操作最多会返回 50 个上传。

类型: 字符串

约束:最小整数值为1。最大整数值为 50

marker

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

类型: 字符串

约束:无

请求标头

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

请求正文

此操作没有请求正文。

Responses

Syntax

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)。

类型:字符串

Errors

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

Examples

例如:列出所有分段上传

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

示例请求

GET /-/vaults/examplevault/multipart-uploads HTTP/1.1 Host: glacier.us-west-2.amazonaws.com 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

响应示例

在响应中,S3 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" } ] }

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

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

示例请求

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1 Host: glacier.us-west-2.amazonaws.com 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 S3 Glacier (S3 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" } ] }