On this page

Functions
Request Syntax
Request Parameters
Request Headers
Request Elements
Response Syntax
Response Headers
Response Elements
Error Responses
Sample Request: Listing Initiated Multipart Uploads
Sample Response: Listing Initiated Multipart Uploads
Sample Request: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)
Sample Response: Listing Initiated Multipart Uploads (with a Prefix and Delimiter Specified)

Show all

Help Center/ Object Storage Service/ API Reference (Ankara Region)/ APIs/ Operations on Multipart Upload/ Listing Initiated Multipart Uploads in a Bucket

Listing Initiated Multipart Uploads in a Bucket

Updated on 2024-04-15 GMT+08:00

View PDF

Functions

This operation queries all the multipart upload tasks that are initialized but have not been merged or canceled in a bucket.

Request Syntax

GET /?uploads&max-uploads=max HTTP/1.1 
Host: bucketname.obs.region.example.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

Request Headers

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

Request Elements

This request involves no elements.

Response Syntax

    
     
       
       HTTP/1.1 status_code
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListMultipartUploadsResult xmlns="http://obs.region.example.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> 
 
        <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
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, 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
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

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

Sample Response: Listing Initiated Multipart Uploads

    
     
       
       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.example.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>
    <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.example.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)

    
     
       
       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.example.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>

      

    
   

Parent topic: Operations on Multipart Upload

Previous topic: Operations on Multipart Upload

Next topic: Initiating a Multipart Upload

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot