列举桶中已初始化多段任务
功能介绍
用户可以通过本接口查询一个桶中所有的初始化后还未合并以及未取消的多段上传任务,了解完整的分段上传流程请参见分段上传。
请求消息样式
GET /?uploads&max-uploads=max HTTP/1.1 Host: bucketname.obs.region.myhuaweicloud.com Date: date Authorization: authorization
请求消息参数
该请求可以通过在请求消息中指定参数,查询指定范围的多段上传任务,请求参数说明如表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所示。
参数名称 |
参数类型 |
描述 |
---|---|---|
ListMultipartUploadsResult |
Container |
参数解释: 保存列举多段上传请求结果的容器,ListMultipartUploadsResult是Bucket、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker、MaxUploads、IsTruncated、Upload、Prefix、Delimiter、CommonPrefixes的父节点。 取值范围: |
参数名称 |
参数类型 |
描述 |
---|---|---|
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 |
参数解释: 表明是否本次返回的分段上传结果列表被截断。 取值范围:
|
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的父节点。 取值范围: |
参数名称 |
参数类型 |
描述 |
---|---|---|
Key |
String |
参数解释: 初始化多段上传任务的对象名称。 取值范围: 长度大于0且不超过1024的字符串。 |
UploadId |
String |
参数解释: 多段上传任务的ID。 取值范围: 长度大于0且不超过32的字符串。 |
Initiator |
Container |
参数解释: 多段上传任务的创建者,Initiator是ID的父节点。 取值范围: |
Owner |
Container |
参数解释: 段的所有者,Owner是ID的父节点。 取值范围: 请详见Owner响应消息元素说明。 |
StorageClass |
String |
参数解释: 表明待多段上传的对象存储类型。 取值范围:
|
Initiated |
Date |
参数解释: 多段上传任务的初始化时间(UTC时间)。日期格式为ISO8601的格式,例如:2018-01-01T00:00:00.000Z。 取值范围: 不涉及 |
请求示例:不带任何参数列举已初始化的段任务
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> |