如何获取Part 列表
描述
默认情况下，此操作返回的列表中最多会有1000个已上传的Part，列表按Part在文档中的位置升序排列。用户应始终检查返回体中的Marker字段，该字段可以在新的请求中作为获取下一个列表的起点；如果Marker为””（空串），则表示列表已全部获取完成。用户还可以通过设置limit 参数来限制每次请求返回的Part数量，但是limit 不能超过1000，如果超过1000，按1000处理。
请求参数
| 名称 | 是否必须 | 描述 |
| limit | 否 | 指定列表返回数量的上限。如果未指定，则最多会返回1000个Job。当用户设置大于1000时，当1000处理 |
| marker | 否 | 指定本次请求列表的起始位置。第一次请求列表时，不需要带上marker；当返回体提示Marker不为空串（””）时，第二次请求带上之前返回体中的Marker值就可以获取后续列表。当marker对应ID不存在时，归档存储会返回异常。 |
请求头部
无，其他公共请求头部参见2.4.1
请求体
无
返回头部
无，其他公共返回头部参见2.4.2
返回体
- [backcolor=transparent]ArchiveDescription
多段上传时提供的Archive描述信息
- [backcolor=transparent]CreationDate
多段上传任务的创建时间
- [backcolor=transparent]Marker
下一次列表请求的起始标记，空串（””）表示无后续的列表
- [backcolor=transparent]PartSizeInBytes
初始化时指定的Part大小
- [backcolor=transparent]MultipartUploadId
多段上传任务的ID
- [backcolor=transparent]Parts
Part元数据数组，以下是元数据的字段
- [backcolor=transparent]RangeInBytes
每个Part在文档中的范围
- [backcolor=transparent]ContentEtag
Part的校验码
示例
请求示例
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"
}]
}
带limit请求示例
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"
}]
}
带limit和marker的请求示例
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"
}]
}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答