List Multipart Uploads
该接口用于获取 Bucket 内正在进行的分段上传对象的列表。列表按照对象名称的 alphanumeric
顺序从小到大排序。
正在进行的分段上传的对象,是指该对象已经调用 Initiate Multipart 接口开启了分段上传模式,且尚未调用 Complete Multipart 或 Abort Multipart 接口结束分段上传。
若用户只想获取某个对象已经上传的分段,请参考接口:List Multipart
请求语法
GET /?uploads HTTP/1.1
Host: <bucket-name>.<zone-id>.qsstor.com
Date: <date>
Authorization: <authorization-string>
请求参数
调用该接口时,可在 URL 中添加如下参数:
名称 | 类型 | 说明 | 是否必选 |
---|---|---|---|
prefix |
String |
指定返回的分段上传对象名(Object Key)的前缀 |
否 |
delimiter |
Char |
用于给对象名(Object Key)分组的字符。列表返回从指定的前缀开始,至第一次出现该分割字符之间的对象名(Object Key) |
否 |
key_marker |
String |
用于分页。当前页的起始标记 |
否 |
upload_id_marker |
String |
当前分段 |
否 |
limit |
Integer |
此次返回的分段对象的最大数量,默认值为 200,最大允许设置 1000 |
否 |
说明
-
用户第一次发送该请求时,
key_marker
与upload_id_marker
均为空。QingStor 对象存储收到请求后,返回字段next_key_marker
与next_upload_id_marker
。 -
用户第二次发送该请求时,将返回字段
next_key_marker
与next_upload_id_marker
依次填入key_marker
与upload_id_marker
,从而获取列表下一页内容。 -
若同名对象有多个分段上传,翻页被截断后只显示了一部分,下次翻页可通过
upload_id_marker
参数,获取剩下的分段上传。 -
用户通过传递
prefix
与delimiter
参数,指定获取某个目录下面正在进行的分段上传。 -
该接口只列出未完成的分段上传对象,假设还有一个目录为
Sci-Fi/
,但是该目录下没有未完成的分段上传,那么不会列出这个目录。
请求头
此接口仅包含公共请求头。关于公共请求头的更多信息,请参见公共请求头。
请求消息体
无。
响应头
此接口仅包含公共响应头。关于公共响应头的更多信息,请参见公共响应头。
响应体
成功调用该 API 后,会返回一个 Json 消息体,其各字段说明如下:
名称 | 类型 | 说明 |
---|---|---|
name |
String |
Bucket 名称 |
prefix |
String |
请求参数 prefix |
delimiter |
Char |
请求参数 delimiter |
marker |
String |
请求参数 key_marker |
limit |
Integer |
请求参数 limit |
next_key_marker |
String |
本次返回列表里的最后一个 |
next_upload_id_marker |
String |
如果有多个同名的分段上传,翻页时可能会被截断,该值是本次返回结果里最后一个 |
uploads |
List |
正在进行的分段上传对象列表 |
common_prefixes |
String |
如果请求中指定了 |
错误码
错误码 | 错误描述 | HTTP 状态码 |
---|---|---|
OK |
成功获取相应列表 |
200 |
其他错误码可参考错误码列表。
示例
请求示例
GET /?uploads&prefix=Movies/&delimiter=/&limit=6 HTTP/1.1
Host: mybucket.pek3a.qsstor.com
Date: Sun, 25 Dec 2016 19:02:00 GMT
Authorization: authorization string
响应示例
HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 25 Dec 2016 19:02:00 GMT
Content-Length: 604
Connection: close
x-qs-request-id: aa08cf7a43f611e5
{
"name": "mybucket",
"uploads": [
{
"created": "2016-12-25T16:02:05.000Z",
"key": "Movies/Star-Wars-2015.mp4",
"upload_id": "44e76b0f5eda308e"
},
{
"created": "2016-12-23T09:15:30.000Z",
"key": "Movies/The-Godfather-1972.mp4",
"upload_id": "8c0dc4f83f063d39"
},
{
"created": "2016-12-23T02:17:00.000Z",
"key": "Movies/The-Matrix-1999.mp4",
"upload_id": "07ae9cab876a33a3"
},
{
"created": "2016-12-24T09:15:30.000Z",
"key": "Movies/The-Matrix-1999.mp4",
"upload_id": "9f58a11f26cce132"
},
],
"prefix": "Movies/",
"delimiter": "/",
"limit": 6,
"key_marker": "",
"upload_id_marker": "",
"next_key_marker": "Sci-Fi/",
"next_upload_id_marker": "",
"common_prefixes": [
"Cartoon/",
"Love/"
]
}