1. Oracle ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.x
  2. S3 Object API Operation Command Reference
  3. Operations on Objects
  4. Complete Multipart Upload

Complete Multipart Upload

The Complete Multipart Upload operation assembles previously uploaded parts to complete the upload. In the request, include the parts list. For each part in the list, provide the part number and the ETag value that was returned after part upload.

Syntax Example

Request syntax example for Complete Mulitpart Upload:

POST https://appliance:443/s3/v1/export/share_mount_point_path/bucket_name/object_name?uploadId=UploadId

Request Parameters

This implementation of the Complete Multipart Upload operation supports the following request parameter, as described in Complete Multipart Upload: uploadId.

Request Headers

This implementation of the Complete Multipart Upload operation supports the following request header, as described in Supported Common Request Headers: x-amz-expected-bucket-owner.

Request Elements

This implementation of the Complete Multipart Upload operation supports the following request elements, as described in Complete Multipart Upload:

  • CompleteMultipartUpload

  • Part

Response Headers

This implementation of the Complete Multipart Upload operation supports the following response header, as described in Complete Multipart Upload: x-amz-version-id.

Response Elements

For the Complete Multipart Upload operation, the following response elements are supported, as described in Complete Multipart Upload:

  • Bucket

  • CompleteMultipartUploadResult

  • ETag

  • Key

Expected HTTP Response Code

200 OK

Error Response Code

The Complete Multipart Upload operation returns special errors described in Complete Multipart Upload. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

POST example-object?uploadId=a7846887-2ad7-48d0-8547-d81549a24853 HTTP/1.1
x-amz-date: Mon, 17 Apr 2023 20:04:21 GMT
Authorization: authorization string
<CompleteMultipartUpload xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Part>
    <ETag>cc9472149704128a4a7e3f90f828e394</ETag>
    <PartNumber>1</PartNumber>
  </Part>
  <Part>
    <ETag>0c78aef83f66abc1fa1e8477f296d3943</ETag>
    <PartNumber>2</PartNumber>
  </Part>
</CompleteMultipartUpload>

HTTP/1.1 200 OK
x-amz-request-id: txf8a4dc13d8ee4463bfe17-00644899b3
Date: Mon, 17 Apr 2023 20:05:21 GMT
Content-Length: 178
<CompleteMultipartUploadResult>
    <Bucket>example-bucket</Bucket>
    <Key>exmple-object</Key>
    <ETag>"018030db837fde4dad2d68efd69985d5"</ETag>
</CompleteMultipartUploadResult>