On this page

Functions
Request Syntax
Request Parameters
Request Headers
Request Elements
Response Syntax
Response Headers
Response Elements
Error Responses
Sample Request
Sample Response

Show all

Help Center/ Object Storage Service/ API Reference (Kuala Lumpur Region)/ APIs/ Operations on Multipart Upload/ Listing Uploaded Parts

Listing Uploaded Parts

Updated on 2024-03-05 GMT+08:00

View PDF

Functions

You can perform this operation to query all parts associated to a multipart upload. The size of each part listed by this API is the same as the size of the part uploaded.

Request Syntax

GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1.1 
Host: bucketname.obs.region.example.com
Date: date 
Authorization: auth

Request Parameters

This request uses parameters to specify which parts in a multipart upload will be listed. Table 1 describes the parameters.

**Table 1** Request parameters
Parameter	Description	Mandatory
uploadId	ID of the multipart upload Type: string Default value: none	Yes
max-parts	Maximum number of parts that can be listed Type: integer Default value: 1,000	No
part-number -marker	Part after which the part listing begins. OBS lists only parts with greater numbers than that specified by this parameter. Type: integer Default value: none	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"?> 
<ListPartsResult xmlns="http://obs.region.example.com/doc/2015-06-30/">
    <Bucket>BucketName</Bucket> 
    <Key>object</Key> 
    <UploadId>uploadid</UploadId> 
    <Initiator> 
        <ID>id</ID>  
    </Initiator> 
    <Owner> 
        <ID>ownerid</ID> 
    </Owner> 
    <StorageClass>storageclass</StorageClass> 
    <PartNumberMarker>partNmebermarker</PartNumberMarker> 
    <NextPartNumberMarker>nextPartnumberMarker</NextPartNumberMarker> 
    <MaxParts>maxParts</MaxParts> 
    <IsTruncated>true</IsTruncated> 
    <Part> 
        <PartNumber>partNumber</PartNumber> 
        <LastModified>modifiedDate</LastModified> 
        <ETag>etag</ETag> 
        <Size>size</Size> 
    </Part> 
</ListPartsResult>

      

    
   

Response Headers

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

Response Elements

This response uses elements to return information about uploaded parts. Table 2 describes the elements.

**Table 2** Response elements
Element	Description
ListPartsResult	Container for responses to part listing requests Type: container Child: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, and Part Parent: none
Bucket	Name of the bucket Type: string Parent: ListPartsResult
Key	Object name Type: string Parent: ListPartsResult
UploadId	ID of the multipart upload Type: string Parent: ListPartsResult
Initiator	Initiator of the multipart upload Type: container Child: ID Parent: ListPartsResult
Owner	The value of this parameter is the same as that of Initiator. Type: container Child: ID Parent: ListPartsResult
ID	ID of the domain where the owner belongs Type: string Parent: Initiator or Owner
StorageClass	Storage class Type: string Value options: STANDARD, WARM, COLD Parent: ListPartsResult
PartNumberMarker	Part number after which listing parts begins Type: integer Parent: ListPartsResult
NextPartNumberMarker	Value of PartNumberMarker in the next request when the returned result is incomplete Type: integer Parent: ListPartsResult
MaxParts	Maximum number of parts returned in a response Type: integer Parent: ListPartsResult
IsTruncated	Whether the returned part list is truncated. The value true indicates that the list was truncated and false indicates that the list was not truncated. Type: boolean Parent: ListPartsResult
Part	Container for elements related to a particular part. Type: string Child: PartNumber, LastModified, ETag, and Size Parent: ListPartsResult PartNumber identifies a part.
PartNumber	Number of an uploaded part Type: integer Parent: ListPartsResult.Part
LastModified	When a part was uploaded Type: date Parent: ListPartsResult.Part
ETag	ETag value of the uploaded parts. It is the unique identifier of the part content and is used to verify data consistency during the combination of parts. Type: string Parent: ListPartsResult.Part
Size	Size of an uploaded part Type: integer Parent: ListPartsResult.Part

Error Responses

If the AK or signature is invalid, OBS returns 403 Forbidden and the error code is AccessDenied.
If the requested bucket is not found, OBS returns 404 Not Found and the error code is NoSuchBucket.
If the requested multipart upload task does not exist, OBS returns 404 Not Found and the error code is NoSuchUpload.
OBS determines whether the use's domain ID has the read permission for the specified bucket. If the user does not have the permission, OBS returns 403 Forbidden and the error code is AccessDenied.

Other errors are included in Table 2.

Sample Request

    
       GET /object02?uploadId=00000163D40171ED8DF4050919BD02B8 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 05:20:35 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:xkABdSrBPrz5yqzuZdJnK5oL/yU=

Sample Response

    
     
       
       HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D40C099A04EF4DD1BDD9
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSK71fr+hDnzB0JBvQC1B9+S12AWxC41
Content-Type: application/xml
Date: WED, 01 Jul 2015 05:20:35 GMT
Content-Length: 888

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://obs.example.com/doc/2015-06-30/">
  <Bucket>test333</Bucket>
  <Key>obj2</Key>
  <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId>
  <Initiator>
    <ID>domainID/domainiddomainiddomainiddo000008:userID/useriduseriduseriduseridus000008</ID>
  </Initiator>
  <Owner>
    <ID>domainiddomainiddomainiddo000008</ID>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>0</PartNumberMarker>
  <NextPartNumberMarker>2</NextPartNumberMarker>
  <MaxParts>1000</MaxParts>
  <IsTruncated>false</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2018-06-06T07:39:32.522Z</LastModified>
    <ETag>"b026324c6904b2a9cb4b88d6d61c81d1"</ETag>
    <Size>2058462721</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2018-06-06T07:41:03.344Z</LastModified>
    <ETag>"3b46eaf02d3b6b1206078bb86a7b7013"</ETag>
    <Size>4572</Size>
  </Part>
</ListPartsResult>

      

    
   

Parent topic: Operations on Multipart Upload

Previous topic: Copying Parts

Next topic: Completing 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