如何获取Multipart Upload任务列表（GET）
描述
此操作会列出指定Vault中正在进行的Multipart Upload任务。正在进行的Multipart Upload任务是成功启动Multipart Upload，但尚未完成的任务。默认情况下，此操作返回的列表中最多会有1000个Multipart Upload任务，列表按Upload ID升序排列。用户应始终检查返回体中的Marker字段，该字段可以在新的请求中作为获取下一个列表的起点；如果Marker为””（空串），则表示列表已全部获取完成。用户还可以通过设置limit 参数来限制每次请求返回的Multipart Upload任务数量，但是limit 不能超过1000，如果超过1000，按1000处理。
请求参数
| 名称 | 是否必须 | 描述 |
| limit | 否 | 指定列表返回数量的上限。如果未指定，则最多会返回1000个Upload任务。当用户设置大于1000时，当1000处理 |
| marker | 否 | 指定本次请求列表的起始位置。第一次请求列表时，不需要带上marker；当返回体提示Marker不为空串（””）时，第二次请求带上之前返回体中的Marker值就可以获取后续列表。当marker对应ID不存在时，会报异常。 |
请求头部
无，其他公共请求头部参见2.4.1
请求体
无
返回头部
无，其他公共返回头部参见2.4.2
返回体
- [backcolor=transparent]Marker
下一次列表请求的起始标记，空串（””）表示无后续的列表
- [backcolor=transparent]UploadsList
Multipart Upload请求元数据数组，以下是元数据的字段
- [backcolor=transparent]ArchiveDescription
多段上传时提供的Archive描述信息
- [backcolor=transparent]CreationDate
多段上传任务的创建时间
- [backcolor=transparent]PartSizeInBytes
初始化时指定的段大小
- [backcolor=transparent]MultipartUploadId
多段上传任务的ID
示例
请求示例
GET /vaults/[VaultId]/multipart-uploads HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]
返回示例
HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 451
{
"Marker": "",
"UploadsList":
[{
"ArchiveDescription": "MyArchive1",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"MultipartUploadId”: "28E23B4C061D457094AD16F8D0988826",
"PartSizeInBytes": 68157440
},
{
"ArchiveDescription": "MyArchive2",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"MultipartUploadId": "5RX99B4C061D457894AD16F8D0977737",
"PartSizeInBytes": 68157440
}]
}
带limit的请求示例
GET /vaults/[VaultId]/multipart-uploads?limit=1 HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]
返回示例
HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 272
{
"Marker": "5RX99B4C061D457894AD16F8D0977737",
"UploadsList":
[{
"ArchiveDescription": "MyArchive1",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"MultipartUploadId": "28E23B4C061D457094AD16F8D0988826",
"PartSizeInBytes": 68157440
}]
}
带limit和marker的请求示例
GET /vaults/[VaultId]/multipart-uploads?limit=1&marker=5RX99B4C061D457894AD16F8D0977737 HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]
返回示例
HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 240
{
"Marker": "",
"UploadsList":
[{
"ArchiveDescription": "MyArchive2",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"MultipartUploadId": "5RX99B4C061D457894AD16F8D0977737",
"PartSizeInBytes": 68157440
}]
}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
问答排行榜
最热
最新
推荐问答
