Help Center/ Object Storage Service/ API Reference/ APIs/ Operations on Multipart Upload/ Listing Initiated Multipart Uploads in a Bucket
Updated on 2024-09-29 GMT+08:00

Listing Initiated Multipart Uploads in a Bucket

Functions

You can use this API to query all initiated multipart uploads that have not been completed or canceled in a bucket..

Request Syntax

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

Request Parameters

This request uses parameters to specify the query range for multipart uploads. Table 1 describes the parameters.

Table 1 Request parameters

Parameter

Description

Mandatory

delimiter

For a multipart upload that contains delimiters, the string between the first character and the first delimiter in the object name (excluding the prefix specified in the request, if any) are returned as CommonPrefix. Multipart uploads with objects that contain CommonPrefix are considered as a group and returned as one record. The record contains no information about the tasks, only informing the user that the group involves multipart uploads.

Type: string

No

prefix

If a prefix is specified, the response only contains tasks whose names start with the prefix value.

Type: string

No

max-uploads

Maximum number of multipart upload tasks returned. The value ranges from 1 to 1000. If the value has exceeded this range, 1000 tasks are returned by default.

Type: integer

No

key-marker

Lists multipart uploads that follow the value of key-marker.

Type: string

No

upload-id-marker

Lists multipart tasks that follow the value of upload-id-marker in key-marker. This parameter only functions together with key-marker.

Type: string

No

encoding-type

Encodes some elements in the response based on the specified type. If Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key contain control characters that are not supported by the XML 1.0 standard, you can set encoding-type to encode Delimiter, KeyMarker, Prefix (including the Prefix in CommonPrefixes), NextKeyMarker, and Key in response.

Type: string

Value option: url

No

Request Headers

This request uses common headers. For details, see Table 3.

Request Elements

This request involves no elements.

Response Syntax

 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>

Response Headers

The response to the request uses common headers. For details, see Table 1.

Response Elements

This response contains elements of information about the multipart uploads. Table 2 describes the elements.

Table 2 Response elements

Element

Description

ListMultipartUploadsResult

Container for responses of requests.

Type: container

Child: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, Upload, CommonPrefixes, and IsTruncated

Parent: none

Bucket

Name of the bucket to which the multipart upload was initiated

Type: string

Parent: ListMultipartUploadsResult

EncodingType

Encodes some elements in the response based on the specified type. If encoding-type is specified in the request, Delimiter, KeyMarker, Prefix (including the Prefix in CommonPrefixes), NextKeyMarker, and Key in the response will be encoded.

Type: string

Parent: ListMultipartUploadsResult

KeyMarker

Object keys at or after which the multipart upload listing begins

Type: string

Parent: ListMultipartUploadsResult

UploadIdMarker

Upload ID after which the multipart upload listing begins

Type: string

Parent: ListMultipartUploadsResult

NextKeyMarker

Value of KeyMarker in a subsequent request after a multipart upload list is truncated

Type: string

Parent: ListMultipartUploadsResult

NextUploadIdMarker

Value of UploadMarker in a subsequent request when a multipart upload list is truncated.

Type: string

Parent: ListMultipartUploadsResult

MaxUploads

Maximum of multipart uploads to be returned in the response

Type: integer

Parent: ListMultipartUploadsResult

IsTruncated

Indicates whether the returned list of multipart uploads is truncated. The value true indicates that the list was truncated and false indicates that the list was not truncated.

Type: boolean

Parent: ListMultipartUploadsResult

Upload

Container for elements related to a specific multipart upload

Type: container

Child: Key, UploadId, InitiatorOwner, StorageClass, and Initiated

Parent: ListMultipartUploadsResult

Key

Indicates the name of the object for which a multipart upload is initiated.

Type: string

Parent: Upload

UploadId

ID of the multipart upload

Type: string

Parent: Upload

Initiator

Container element that identifies who initiated the multipart upload

Child: ID

Type: container

Parent: Upload

ID

ID of the account to which the owner belongs.

Type: string

Parent: Initiator or Owner

Owner

Owner of the part.

Type: container

Child: ID

Parent: Upload

StorageClass

Indicates the storage class that will be used for storing an object when the multipart is uploaded.

Type: string

Parent: Upload

Initiated

Date and time when the multipart upload was initiated

Type: date

Parent: Upload

ListMultipartUploadsResult.Prefix

Specified prefix in a request.

Type: string

Parent: ListMultipartUploadsResult

Delimiter

Delimiter in a request.

Type: string

Parent: ListMultipartUploadsResult

CommonPrefixes

Indicates group information. If you specify a delimiter in the request, the response contains group information in CommonPrefixes.

Type: container

Parent: ListMultipartUploadsResult

CommonPrefixes. Prefix

Indicates a different prefix in the group information in CommonPrefixes.

Type: string

Parent: CommonPrefixes

Error Responses

If the value of maxUploads is a non-integer or smaller than 0, OBS returns 400 Bad Request.

Other errors are included in Table 2.

Sample Request: Listing Initiated Multipart Uploads

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=

Sample Response: Listing Initiated Multipart Uploads

 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>

Sample Request: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)

The following example describes how to list two initiated multipart uploads (with objects multipart-object001 and part2-key02 in bucket examplebucket. In this listing operation, prefix is set to multipart and object001 is set to delimiter.

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=

Sample Response: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)

 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>