文档首页/ 对象存储服务 OBS/ API参考/ API/ 多段操作/ 列举桶中已初始化多段任务
更新时间:2025-08-22 GMT+08:00

列举桶中已初始化多段任务

功能介绍

用户可以通过本接口查询一个桶中所有的初始化后还未合并以及未取消的多段上传任务,了解完整的分段上传流程请参见分段上传

请求消息样式

GET /?uploads&max-uploads=max HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

请求消息参数

该请求可以通过在请求消息中指定参数,查询指定范围的多段上传任务,请求参数说明如表1所示。

表1 请求消息参数

参数名称

是否必选

参数类型

描述

delimiter

String

参数解释:

对于名字中包含delimiter的对象的任务,其对象名(如果请求中指定了prefix,则此处的对象名需要去掉prefix)中从首字符至第一个delimiter之间的字符串将作为CommonPrefix在响应中返回。对象名包含CommonPrefix的任务被视为一个分组,作为一条记录在响应中返回,该记录不包含任务的信息,仅用于提示用户该分组下存在多段上传任务。

约束限制:

不涉及

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

不涉及

prefix

String

参数解释:

列举桶内多段任务列表时,指定一个前缀,限定返回的多段任务的对象名必须带有prefix前缀。如果请求中指定了prefix,则响应中仅包含对象名以prefix开始的任务信息。

约束限制:

满足对象名的格式。

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

不涉及

max-uploads

Integer

参数解释:

单次列举的多段任务的最大条目。单位:个。

约束限制:

不涉及

取值范围:

[1,1000],当超出范围时,按照默认的1000进行处理。

默认取值:

1000

key-marker

String

参数解释:

列举时返回指定的key-marker之后的多段任务。

约束限制:

不涉及

取值范围:

上次请求返回体的NextKeyMarker值。

默认取值:

不涉及

upload-id-marker

String

参数解释:

列举时返回指定的key-marker的upload-id-marker之后的多段任务。

约束限制:

需要和key-marker一起使用才有意义。

取值范围:

上次请求返回体的NextUploadIdMarker值。

默认取值:

不涉及

encoding-type

String

参数解释:

对响应中的部分元素进行指定类型的编码。如果Delimiter、KeyMarker、Prefix、NextKeyMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置encoding-type对响应中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key进行编码。

约束限制:

当前只支持URL编码。

取值范围:

url

默认取值:

不涉及,不设置则不编码。

请求消息头

该请求使用公共请求消息头,具体请见表3

请求消息元素

该请求消息中不使用消息元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
HTTP/1.1 status_code
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListMultipartUploadsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Bucket>bucketname</Bucket> 
    <KeyMarker/> 
    <UploadIdMarker/> 
    <NextKeyMarker>nextMarker</NextKeyMarker> 
    <NextUploadIdMarker>idMarker</NextUploadIdMarker> 
    <MaxUploads>maxUploads</MaxUploads> 
    <IsTruncated>true</IsTruncated> 
    <Upload> 
        <Key>key</Key> 
        <UploadId>uploadID</UploadId> 
        <Initiator> 
            <ID>domainID/domainID:userID/userID</ID> 
        </Initiator> 
        <Owner> 
            <ID>ownerID</ID>
        </Owner> 
        <StorageClass>storageclass</StorageClass> 
        <Initiated>initiatedDate</Initiated>  
    </Upload> 
</ListMultipartUploadsResult>

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中通过消息元素返回多段上传任务,元素的具体意义如表2所示。

表2 响应消息元素

参数名称

参数类型

描述

ListMultipartUploadsResult

Container

参数解释:

保存列举多段上传请求结果的容器,ListMultipartUploadsResult是Bucket、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker、MaxUploads、IsTruncated、Upload、Prefix、Delimiter、CommonPrefixes的父节点。

取值范围:

请详见ListMultipartUploadsResult响应消息元素说明

表3 ListMultipartUploadsResult响应消息元素说明

参数名称

参数类型

描述

Bucket

String

参数解释:

初始化任务所在的桶名。

取值范围:

长度为3~63的字符串。

EncodingType

String

参数解释:

对响应中的部分元素进行指定类型的编码。如果请求中设置了encoding-type,那响应中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key会被编码。

取值范围:

url

KeyMarker

String

参数解释:

列举时的起始对象位置。

取值范围:

长度大于0且不超过1024的字符串。

UploadIdMarker

String

参数解释:

列举时的起始UploadId位置。

取值范围:

度大于0且不超过32的字符串。

NextKeyMarker

String

参数解释:

如果本次没有返回全部结果,响应请求中将包含NextKeyMarker字段,用于标明接下来请求的KeyMarker值。

取值范围:

长度大于0且不超过1024的字符串。

NextUploadIdMarker

String

参数解释:

如果本次没有返回全部结果,响应请求中将包含NextUploadIdMarker元素,用于标明接下来请求的UploadMarker值。

取值范围:

度大于0且不超过32的字符串。

MaxUploads

Integer

参数解释:

单次返回的最大多段上传任务数目。单位:个。

取值范围:

[1,1000],当超出范围时默认为1000。

IsTruncated

Boolean

参数解释:

表明是否本次返回的分段上传结果列表被截断。

取值范围:

  • true:表示本次没有返回全部结果
  • false:表示本次已经返回了全部结果。

Upload

Container

参数解释:

保存分段上传任务信息的容器,Upload是Key、UploadId、Initiator、Owner、StorageClass、Initiated的父节点。

取值范围:

请详见Upload响应消息元素说明

ListMultipartUploadsResult.Prefix

String

参数解释:

请求中携带的prefix。

取值范围:

长度大于0且不超过1024的字符串。

Delimiter

String

参数解释:

请求中带的Delimiter。

取值范围:

长度大于且不超过1024的字符串。

CommonPrefixes

Container

参数解释:

请求中带Delimiter参数时,返回消息带CommonPrefixes分组信息,CommonPrefixes是Prefix的父节点。

取值范围:

请详见CommonPrefixes响应消息元素说明

表4 Upload响应消息元素说明

参数名称

参数类型

描述

Key

String

参数解释:

初始化多段上传任务的对象名称。

取值范围:

长度大于0且不超过1024的字符串。

UploadId

String

参数解释:

多段上传任务的ID。

取值范围:

长度大于0且不超过32的字符串。

Initiator

Container

参数解释:

多段上传任务的创建者,Initiator是ID的父节点。

取值范围:

请详见Initiator响应消息元素说明

Owner

Container

参数解释:

段的所有者,Owner是ID的父节点。

取值范围:

请详见Owner响应消息元素说明

StorageClass

String

参数解释:

表明待多段上传的对象存储类型。

取值范围:

  • STANDARD:标准存储
  • WARM:低频访问存储
  • COLD:归档存储
  • DEEP_ARCHIVE:深度归档存储(受限公测)

Initiated

Date

参数解释:

多段上传任务的初始化时间(UTC时间)。日期格式为ISO8601的格式,例如:2018-01-01T00:00:00.000Z。

取值范围:

不涉及

表5 Initiator响应消息元素说明

参数名称

参数类型

描述

ID

String

参数解释:

多段任务创建者的urn。格式为domainID/{domainId}:userID/{userId}。

取值范围:

不涉及

表6 Owner响应消息元素说明

参数名称

参数类型

描述

ID

String

参数解释:

多段任务创建者的DomainId,格式为{domainId}。

取值范围:

不涉及

表7 CommonPrefixes响应消息元素说明

参数名称

参数类型

描述

CommonPrefixes. Prefix

String

参数解释:

CommonPrefixes分组信息中,表明不同的前缀。

取值范围:

不涉及

错误响应消息

OBS系统对maxUploads进行判断,如果maxUploads不为整数类型或者小于0,OBS返回400 Bad Request。

其他错误已经包含在表2中。

请求示例:不带任何参数列举已初始化的段任务

1
2
3
4
5
6
GET /?uploads HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

响应示例:不带任何参数列举已初始化的段任务

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D405534D046A2295674C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSDaHP+a+Bp0RI6Mm9XvCOrf7q3qvBQW
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>examplebucket</Bucket>
  <KeyMarker/>
  <UploadIdMarker/>
  <Delimiter/>
  <Prefix/>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <Upload>
    <Key>obj2</Key>
    <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId>
    <Initiator>
      <ID>domainID/b4bf1b36d9ca43d984fbcb9491b6fce9:userID/71f390117351534r88115ea2c26d1999</ID>
    </Initiator>
    <Owner>
      <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2015-07-01T02:30:54.582Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

请求示例:带prefix和delimeter列举已初始化的段任务

例如,用户桶examplebucket中2个段任务,对象名分别为multipart-object001和part2-key02,列举段任务时,设置prefix为“multipart",delimeter设置为object001,列举已初始化的段任务。

GET /?uploads&delimiter=object001&prefix=multipart HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

响应示例:带prefix和delimeter列举已初始化的段任务

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 5DEB00000164A27A1610B8250790D703
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSq3ls2ZtLDD6pQLcJq1yGITXgspSvBR
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>newbucket0001</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker>
  </UploadIdMarker>
  <Delimiter>object</Delimiter>
  <Prefix>multipart</Prefix>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <CommonPrefixes>
    <Prefix>multipart-object001</Prefix>
  </CommonPrefixes>
</ListMultipartUploadsResult>