Help Center> Object Storage Service> SDK Reference> Python> APIs Related to Multipart Upload> Listing Uploaded Parts
View PDF

Listing Uploaded Parts

API Description

You can use this API to list the uploaded parts in a specified bucket by using the multipart upload ID.

Method Definition

ObsClient.listParts(bucketName, objectKey, uploadId, maxParts, partNumberMarker)

Request Parameters

Field

Type

Optional or Mandatory

Description

bucketName

str

Mandatory

Bucket name

objectKey

str

Mandatory

Object name

uploadId

str

Mandatory

Multipart upload ID

maxParts

int

Optional

Maximum number of uploaded parts that can be listed per page

partNumberMarker

int

Optional

Part number after which listing uploaded parts begins. Only parts whose part numbers are larger than this value will be listed.

Returned Results

Type

Description

GetResult

SDK common result object

GetResult.body Type

Description

ListPartsResponse

Response result of the request for Listing uploaded parts

Sample Code

try:
    resp = obsClient.listParts('bucketname', 'objectkey', 'uploadid', maxParts=10) 
      
    if resp.status < 300: 
        print('requestId:', resp.requestId) 
        print('bucketName:', resp.body.bucketName) 
        print('objectKey:', resp.body.objectKey) 
        print('uploadId:', resp.body.uploadId) 
        print('storageClass:', resp.body.storageClass) 
        print('isTruncated:', resp.body.isTruncated) 
        print('initiator:', resp.body.initiator) 
        print('owner:', resp.body.owner) 
         
        index = 1 
        for part in resp.body.parts: 
            print('part [' + str(index) + ']') 
            print('partNumber:', part.partNumber) 
            print('lastModified:', part.lastModified) 
            print('etag:', part.etag) 
            print('size:', part.size) 
            index += 1 
    else: 
        print('errorCode:', resp.errorCode) 
        print('errorMessage:', resp.errorMessage)
except:
    import traceback
    print(traceback.format_exc())