Spectra Logic

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

Initiate Multipart Upload

Description

Initiates a multipart upload for an object. This operation attempts to allocate 5 TB of cache space for the multipart upload, which may be significantly more than the actual cache space necessary. If cache space cannot be allocated in full, an error is returned. If this call succeeds, it is guaranteed that neither part uploads nor a complete multipart upload request will fail due to cache allocation issues. This is an Amazon S3 compatible operation.

See Initiate Multipart Upload for Amazon S3 operation details.

Notes:

§

Spectra Logic recommends that you use Spectra S3 requests to create a PUT job, then upload each object piece in the PUT job, rather than using Multipart Upload (see Processing a Bulk PUT Job). Using a bulk PUT job achieves better scalability and performance. Note that a maximum upload size can be specified on a PUT job if smaller transfer sizes are required.

§	The cache space allocated by this call is not released until the multi-part upload is aborted, completed, or times out.

Requests

Syntax

POST http[s]://{datapathDNSname}/{bucket}/{object}?uploads

Request Parameters

Parameter	Description	Required
uploads	Indicates that this operation initiates a multipart upload.	yes

Responses

Response Elements

HTTP/1.1 200 OK
<InitiateMultipartUploadResult>
   <Bucket>{string}</Bucket>
   <Key>{string}</Key>
   <UploadId>{string}</UploadId>
</InitiateMultipartUploadResult>

where the response elements are defined as follows:

Parameter	Description
InitiateMultipart UploadResult	The container for the response.
Bucket	The name for the bucket in which the object resides.
Key	The object name.
UploadID	The UUID for the multipart upload.

Example

Sample Request

This request initiates a multipart upload for the object test.aaf.

POST http[s]://blackpearl-hostname/bucket1/test.aaf?uploads HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<InitiateMultipartUploadResult>
   <Bucket>bucket1</Bucket>
   <Key>test.aaf</Key>
   <UploadId>18baa28f-1c85-4cd2-9023-71600b1759f3</UploadId>
</InitiateMultipartUploadResult>