Spectra Logic

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

Complete Multipart Upload

Description

Commit a multipart upload that has been initiated, but not yet completed or aborted. Run this command after successfully uploading all parts of a multipart upload. The BlackPearl gateway assembles the previously uploaded parts in ascending order by part number to create a new object. This process can take several minutes to complete. This is an Amazon S3 compatible operation.

See Complete Multipart Upload for Amazon S3 operation details.

Requests

Syntax

POST http[s]://{datapathDNSname}/{bucket}/{object}/ ?upload_id={string}

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

Request Elements

An XML payload, formatted as follows, must be sent to describe the parts in the upload:

Note:

If you did not note the PartNumber and ETag for all object parts when they were uploaded using Create Multipart Upload, use List Multipart Upload Parts to determine the PartNumber and ETag.

<CompleteMultipartUpload>
   <Part>

      <PartNumber>{64-bit integer}</PartNumber>

      <ETag>{string}</ETag>

   </Part>

   ...

</CompleteMultipartUpload>

where the parameters are defined as follows:

Parameter	Description	Required
CompleteMultipartUpload	A container for the list of parts.	yes
Part	A container for the information about one part.	yes
PartNumber	The user defined number that uniquely identifies the uploaded part and its position in the object.	yes
ETag	The http entity tag for the object part.	yes

Responses

Response Elements

<CompleteMultipartUploadResult>
   <Bucket>{string}</Bucket>
   <ETag>"{string}"</ETag>
   <Key>{string}</Key>
   <Location>{string}</Location>
</CompleteMultipartUploadResult>

where the response elements are defined as follows:

Parameter	Description
CompleteMultipartUploadResult	The container for the response.
Bucket	The name for the bucket in which the object resides.
ETag	The http entity tag for the newly created object.
Key	The object name for the newly created object.
Location	The URI (uniform resource identifier) that identifies the newly created object.

Example

Sample Request

This request commits the multipart upload with the UUID 18baa28f-1c85-4cd2-9023-71600b1759f3.

POST http[s]://blackpearl-hostname/bucket1/test.aaf/ ?upload_id=18baa28f-1c85-4cd2-9023-71600b1759f3 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<CompleteMultipartUploadResult>
   <Bucket>bucket1</Bucket>
   <ETag>"98d476a1d168aa4c4592ce06cab9880f-3"</ETag>
   <Key>test.aaf</Key>
   <Location>d57cdcf7-df15-4cec-bcbd-559b651634b8</Location>
</CompleteMultipartUploadResult>