Spectra Logic

1-800-833-1132 : 1-303-449-6400

List Multipart Upload Parts

Description

Lists parts that have been uploaded for a specified multipart upload. This is an Amazon S3 compatible operation.

See List Parts for Amazon S3 operation details.

Requests

Syntax

GET http[s]://{datapathDNSname}/{bucket}/{object}/ ?upload_id={string}[&max_parts={64-bit integer}] [&part_number_marker={64-bit integer}]

To determine the UUID of the multipart upload, see List Multipart Uploads.

Request Parameters

Parameter	Description	Required
upload_id	The UUID of the multipart upload.	yes
max_parts	The maximum number of parts to list in the response. The default is 1000.	no
part_number_ marker	Specifies the part number after which the listing begins. Only parts with higher part numbers will be listed.	no

Responses

Response Elements

<ListPartsResult>
   <Bucket>{string}</Bucket>
   <IsTruncated>TRUE|FALSE</IsTruncated>
   <Key>{string}</Key>
   <MaxParts>{64-bit integer}</MaxParts>
   <NextPartNumberMarker>{64-bit integer}</NextPartNumberMarker>
   <Owner>
      <DisplayName>{string}</DisplayName>
      <ID>{string}</ID>
   </Owner>

   <Part>
      <ETag>"{string}"</ETag>
      <LastModified>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastModified>
      <PartNumber>{string}</PartNumber>
   </Part>
   ...
   <PartNumberMarker>{64-bit integer}</PartNumberMarker>
   <UploadId>{string}</UploadId>
</ListPartsResult>

where the response elements are defined as follows:

Parameter	Description
ListPartsResult	The container for the response.
Bucket	The name for the bucket in which the object resides.
IsTruncated	Specifies whether the results were truncated (TRUE) or not (FALSE) due to the number of results exceeding MaxParts. Values: TRUE, FALSE
Key	The object name.
MaxParts	Maximum number of parts to include in the response.
NextPartNumber Marker	When the list is truncated, this element specifies the value to use for the part_number_marker request parameter in a subsequent request.
Owner	The container for information about the owner.
DisplayName	The username for the owner.
ID	The UUID for the owner.
Part	The container for information about an object part.
ETag	The http entity tag for the part.
LastModified	The last date and time the object was modified in the format YYYY-MM-DDThh:mm:ss.xxxZ. If this attribute is null, then the object has not yet been completely received into cache.
PartNumber	The number that uniquely identifies the uploaded part and its position in the object.
PartNumberMarker	Part number after which listing begins.
UploadID	The UUID for the multipart upload.

Example

Sample Request

This request gets a list of up to three parts that have been uploaded for the multipart upload with the upload ID 125c261c-5c84-49e3-bcda-07d312e28019.

POST http[s]://blackpearl-hostname/bucket1/test.aaf/ ?upload_id=125c261c-5c84-49e3-bcda-07d312e28019&max_parts=3 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<ListPartsResult>
   <Bucket>bucket1</Bucket>
   <IsTruncated>TRUE</IsTruncated>
   <Key>test.aaf</Key>
   <MaxParts>3</MaxParts>
   <NextPartNumberMarker>3</NextPartNumberMarker>
   <Owner>
      <DisplayName>default_user_name</DisplayName>
      <ID>31569b32-3cd5-4687-ab3b-88f5aea8f54d</ID>
   </Owner>
   <Part>
      <ETag>"c4ca4238a0b923820dcc509a6f75849b"</ETag>
      <LastModified>2015-02-12T17:28:41.000Z</LastModified>
      <PartNumber>1</PartNumber>
   </Part>
   <Part>
      <ETag>"c81e728d9d4c2f636f067f89cc14862c"</ETag>
      <LastModified>2015-02-12T17:28:41.000Z</LastModified>
      <PartNumber>2</PartNumber>
   </Part>
   <Part>
      <ETag>"eccbc87e4b5ce2fe28308fd9f2a7baf3"</ETag>
      <LastModified>2015-02-12T17:28:41.000Z</LastModified>
      <PartNumber>3</PartNumber>
   </Part>
   <PartNumberMarker/>
   <UploadId>125c261c-5c84-49e3-bcda-07d312e28019</UploadId>
</ListPartsResult>