Appearance
ListParts
接口描述
此命令用于列出用户指定UploadId所属的所有已经上传成功的Part，用户可以通过此命令查看当前的进度。
请求（Request）
请求语法
GET /<BucketName>/<ObjectName>?uploadId=UploadId&maxParts=MaxParts&partNumberMarker=PartNumberMarker HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>请求头域
无特殊头域
请求参数
| 名称 | 类型 | 参数位置 | 描述 | 是否必需 |
|---|---|---|---|---|
| maxParts | Int | Query参数 | FOS一次最多返回的part数目，默认1000，最大1000 | 否 |
| partNumberMarker | Int | Query参数 | 按照partNumber排序，本次请求的起始part从此partNumber的下一个开始返回 | 否 |
| uploadId | String | Query参数 | 此次MultipartUpload的ID | 是 |
响应（Response）
响应头域
无特殊头域
响应元素
| 名称 | 类型 | 描述 |
|---|---|---|
| bucket | String | 所属Bucket名称 |
| key | String | Object名称 |
| uploadId | String | 请求指定的UploadId |
| initiated | String | multipartUpload的创建时间 |
| owner | Container | 此object所属的租户信息 |
| +id | String | 租户CODE和租户ID组成的字符串，组合方式："{租户CODE}-{租户ID}" |
| +displayName | String | 租户CODE和租户ID组成的字符串，组合方式："{租户CODE}-{租户ID}" |
| partNumberMarker | Int | 请求指定的本次part Number起始位置 |
| nextPartNumberMarker | Int | 本次请求返回的最后一条记录的partNumber，可以作为下一次请求的PartNumberMarker |
| maxParts | Int | 请求指定的本次最多返回的part数量 |
| isTruncated | Bool | 标明是否本次返回的List Part结果列表被截断。 true表示本次没有返回全部结果； false表示本次已经返回了全部结果 |
| parts | Container | 一个part的容器 |
| +partNumber | Int | 该part的标识 |
| +lastModified | DATE | 该part的上传时间 |
| +ETag | String | 每个上传分块的ETag |
| +size | Int | 该part大小 |
注意事项
- FOS按照PartNumber升序排序。
- 由于网络传输可能出错，所以不推荐用ListParts出来的结果生成最后CompleteMultipartUpload的Part列表。
示例
请求示例
GET /BucketName/ObjectName?uploadId=a44cc9bab11cbd156984767aad637851&maxParts=2&partNumberMarker=1
Host: fos.flymeyun.com
Date: Wed, 06 Apr 2016 06:34:40 GMT响应示例
HTTP/1.1 200 OK
x-fos-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
Date: Wed, 06 Apr 2016 06:34:40 GMT
Content-Length: 985
Connection: keep-alive
{
"bucket":"BucketName",
"key":"object",
"uploadId":"a44cc9bab11cbd156984767aad637851",
"initiated":"2010-11-10T20:48:33Z",
"owner":{
"id":"Flyme-xxxxxx",
"displayName":"Flyme-xxxxxx"
},
"storageClass":"STANDARD",
"partNumberMarker":1,
"nextPartNumberMarker":3,
"maxParts":2,
"isTruncated":true,
"parts":[
{
"partNumber":2,
"lastModified":"2010-11-10T20:48:34Z",
"ETag":"7778aef83f66abc1fa1e8477f296d394",
"size":10485760
},
{
"partNumber":3,
"lastModified":"2010-11-10T20:48:33Z",
"ETag":"aaaa18db4cc2f85cedef654fccc4a4x8",
"size":10485760
}
]
}