Create Multipart Upload

The Create Multipart Upload operation initiates an upload and returns the upload ID, which is used for uploading part requests. The ID is also used when completing or aborting the multipart upload request.

Syntax Example

Request syntax example for Create Multipart Upload:

POST https://appliance:443/s3/v1/export/share_mount_point_path/bucket_name/object_name?uploads

Request Parameters

This implementation of the Create Multipart Upload operation does not support request parameters.

Request Headers

This implementation of the Create Multipart Upload operation supports request headers that are common to all operations, as described in table "Common Supported Request Headers" in Supported Common Request Headers. In addition, the following request headers are supported, as described in Create Multipart Upload:

Content-Disposition
Content-Encoding
Content-Language
Content-Type
x-amz-storage-class - ignore value, all STANDARD
x-amz-tagging
x-amz-acl
x-amz-grant-full-control
x-amz-grant-read
x-amz-grant-read-acp
x-amz-grant-write-acp

Request Elements

This implementation of the Create Multipart Upload operation does not support the use of request elements.

Response Headers

This implementation of the Create Multipart Upload operation supports response headers that are common to all operations, as described in table "Common Supported Response Headers" in Supported Common Response Headers.

Response Elements

This implementation of the Create Multipart Upload operation returns the following response elements, as described in Create Multipart Upload:

InitiateMultipartUploadResult
Bucket
Key
UploadId

Expected HTTP Response Code

200 OK

Error Response Code

The Create Multipart Upload operation does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

POST /example-object?uploads HTTP/1.1
x-amz-date: Thu, 12 Apr 2023 20:04:21 GMT
Authorization: authorization string

HTTP/1.1 200 OK
<InitiateMultipartUploadResult>
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
</InitiateMultipartUploadResult>