Cloud Enterprise Object Storage REST API

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
Owner    
ID The ID of the owner String
DisplayName Screen name of the owner. String
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