S3 Object Uploads Operations:List Parts

Search (SHIFT+S)




List Parts

GET /{object_name}?uploadId={upload_id}

Lists the parts that have been uploaded for a specific multi-part upload.

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}?uploadId={upload_id}
Path Style: http://ns1.emc.com/bucketname/{object_name}?uploadId={upload_id}

Alternatively, both styles can specify the namespace using the x-emc-namespace header.


Query Parameters

uploadIdUnique identifier of the multi-part upload. Obtained from the Object Init Uploads operation
max-partsCan be used to specify a maximum number of parts to return.
part-number-markerCan be used to specify a part number after which listing should begin.

Prerequisites

The following conditions must be met in order to call this operation.

  • A multi-part upload must have been initiated and returned a valid uploadId

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace and bucket corresponding to this object should exist


Response Body

List of parts

Field Description Type Notes
<ListPartsResult>
<Bucket> Bucket name String
<Key> Object name String
<UploadId> Upload Identifier String
<Initiator>    
<ID> User ID of the user who initiated the multipart upload String
<DisplayName> The screen name of the user String
</Initiator>      
<Owner>    
<ID> The ID of the bucket owner String
<DisplayName> Screen name of the owner of the bucket. String
</Owner>      
<StorageClass> Storage class. For ex. STANDARD String
<PartNumberMarker> Part number after which listing begin Integer
<NextPartNumberMarker> Next part number Integer
<MaxParts> Maximum number of parts to return Integer
<IsTruncated> True, if there are objects still available to retrieve and False otherwise Boolean Valid Values:
  •  True
  •  False
<Part>     0-* Elements
<PartNumber> Part number that identifies the part Integer
<LastModified> Last modified time Date
<ETag> Entity tag returned when the part was uploaded String
<Size> Size Long
</Part>      
</ListPartsResult>
Notes: