描述
默认情况下,此操作返回的列表中最多会有1000个已上传的Part,列表按Part在文档中的位置升序排列。用户应始终检查返回体中的Marker字段,该字段可以在新的请求中作为获取下一个列表的起点;如果Marker为””(空串),则表示列表已全部获取完成。用户还可以通过设置limit 参数来限制每次请求返回的Part数量,但是limit 不能超过1000,如果超过1000,按1000处理。
请求参数
名称 | 是否必须 | 描述 |
limit | 否 | 指定列表返回数量的上限。如果未指定,则最多会返回1000个Job。当用户设置大于1000时,当1000处理 |
marker | 否 | 指定本次请求列表的起始位置。第一次请求列表时,不需要带上marker;当返回体提示Marker不为空串(””)时,第二次请求带上之前返回体中的Marker值就可以获取后续列表。当marker对应ID不存在时,归档存储会返回异常。 |
GET /vaults/[VaultId]/multipart-uploads/[UploadId] 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: 362
{
"ArchiveDescription" : "MyArchive",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"Marker": "",
"MultipartUploadId": "840C8218C9374A15A0362F32C508252C",
"PartSizeInBytes": 67108864,
"Parts":
[{
"ContentEtag": "311A6FB47120819937A10E4A98CD08A3",
"RangeInBytes": "0-67108863",
},
{
"ContentEtag": "10D78366CD4B9DE580625E7C67133696",
"RangeInBytes": "67108864-134217727"
}]
}
GET /vaults/[VaultId]/multipart-uploads/[UploadId]?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: 280
{
"ArchiveDescription": "MyArchive",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"Marker": "153548",
"MultipartUploadId": "840C8218C9374A15A0362F32C508252C",
"PartSizeInBytes": 67108864,
"Parts":
[{
"ContentEtag": "311A6FB47120819937A10E4A98CD08A3",
"RangeInBytes": "0-67108863"
}]
}
GET /vaults/[VaultId]/multipart-uploads/[UploadId]?limit=1&marker=153548 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: 281
{
"ArchiveDescription": "MyArchive",
"CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
"Marker": "",
"MultipartUploadId": "EACFA05DF334440383E1BABFD88E8749",
"PartSizeInBytes": 67108864,
"Parts":
[{
"ContentEtag": "10D78366CD4B9DE580625E7C67133696",
"RangeInBytes": "67108864-134217727"
}]
}
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。