Appearance
ListMultipartUploads
接口描述
此命令用于列出指定Bucket下面的所有未执行完成的Multipart Upload。“未执行完”是指完成了InitMultipartUpload，但是还没有调用CompleteMultipartUpload或AbortMultipartUpload的Multipart Upload。每次FOS最多返回1000个Multipart Upload，FOS支持prefix和delimiter过滤。
请求（Request）
请求语法
GET /<BucketName>?uploads HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>请求头域
无特殊要求头域
请求参数
| 名称 | 类型 | 参数位置 | 描述 | 是否必需 |
|---|---|---|---|---|
| delimiter | String | Query参数 | 分隔符; 主要应此项实现list文件夹的逻辑 | 否 |
| keyMarker | String | Query参数 | Object按照字典序排序后，本次从keyMarker的后面的一条开始返回 | 否 |
| maxUploads | Int | Query参数 | 本次请求返回Multipart Uploads的最大数目,默认1000，最大1000 | 否 |
| prefix | String | Query参数 | key前缀，限定返回的object key必须以此为前缀 | 否 |
| uploads | String | Query参数 | 标明请求是 ListMultipartUploads | 是 |
响应（Response）
响应头域
无特殊头域
响应元素
| 名称 | 类型 | 描述 |
|---|---|---|
| bucket | String | 所属Bucket名称 |
| commonPrefixes | - | 如果在请求的时候指定了delimiter，将返回此项。FOS把匹配到的Object名称 |
| 按照一定规则（从preifx到第一个delimiter）截取，截取的字符串去重作为CommonPrefixes的数据返回 | ||
| delimiter | String | 返回请求中的delimiter值 |
| prefix | String | object前缀 |
| isTruncated | Bool | 标明是否本次是否没有返回所有的数据。 |
| true表示本次没有返回全部结果； false表示本次已经返回了全部结果 | ||
| keyMarker | String | 请求指定的本次返回的MultipartUpload的起始位置 |
| maxUploads | Int | 请求指定的本次返回的Multipart Uploads的最大数目 |
| nextKeyMarker | String | 本次返回的最后一条MultipartUpload，可以作为下一次请求的KeyMarker |
| uploads | Container | 保存一个MultipartUpload的容器 |
| +key | String | Object名称 |
| +uploadId | String | MultipartUpload的ID |
| +owner | Container | Object所属的用户信息 |
| ++displayName | String | 用户名 |
| ++id | String | 用户ID |
| +initiated | Date | 本次MultipartUpload开始时间 |
注意事项：此处的Delimiter跟ListObjects的类似，可以参考ListObjects的接口说明。
示例
请求示例
GET /BucketName?uploads HTTP/1.1
Host: fos.flymeyun.com
Date: Wed, 06 Apr 2016 06:34:40 GMT响应示例（JSON）
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: 1330
Connection: keep-alive
{
"bucket":"bucket",
"keyMarker":"",
"nextKeyMarker":"my-movie.m2ts",
"maxUploads":3,
"isTruncated":true,
"uploads": [
{
"key":"my-divisor",
"uploadId":"a44cc9bab11bdc157676984aad851637",
"owner":{
"id":"75aa57f09aa0c8caeab4aeebf76c078efc7c6caea54ba06a",
"displayName":"OwnerDisplayName"
},
"initiated":"2010-11-10T20:48:33Z"
"storageClass" : "STANDARD_IA",
},
{
"key":"my-movie",
"uploadId":"b44cc9bab11cbd156984767aad637851",
"owner":{
"id":"b1d16700c70b0b05597d7acd6a3f92be",
"displayName":"OwnerDisplayName"
},
"initiated":"2010-11-10T20:48:33Z"
"storageClass" : "STANDARD",
},
{
"key":"my-movie.m2ts",
"uploadId":"c41cc9aad11cbd637851767bab156984",
"owner":{
"id":"b1d16700c70b0b05597d7acd6a3f92be",
"displayName":"OwnerDisplayName"
},
"initiated":"2010-11-10T20:49:33Z"
"storageClass" : "STANDARD_IA",
}
]
}