CompleteMultipartUpload

Prev Next

Available in Classic and VPC

Combine the uploaded parts to save the object and complete the multipart upload.

Request

This section describes the request format. The method and URI are as follows:

Method URI
POST /{Key}

Request headers

The following describes the request headers.

Note

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Field Required Description
x-amz-server-side-encryption-customer-algorithm Optional User encryption algorithm (AES256)
x-amz-server-side-encryption-customer-key Optional User-provided encryption key
x-amz-server-side-encryption-customer-key-MD5 Optional User-provided encryption key's MD5 value

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
Key String Required Object name

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
uploadId String Required Multipart upload ID

Request body

You can include the following data in the body of your request:

Field Type Required Description
CompleteMultipartUpload Object Required Request multipart upload completion.
CompleteMultipartUpload.Part Array Required Part list

Part

The following describes Part.

Field Type Required Description
PartNumber Integer Optional Part number
  • 1-10,000
ETag String Optional Unique object identifier (entity tag)

Request example

The request example is as follows:

POST /object.zip?uploadId=f228bfca-****-****-****-9cc2c468d0e9 HTTP/1.1
Host: bucket.kr.ncloudstorage.com

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUpload>
    <Part>
        <PartNumber>1</PartNumber>
        <ETag>&#34;a068860ac17***********d5d7fd3334&#34;</ETag>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <ETag>&#34;a068860ac17***********d5d7fd3334&#34;</ETag>
    </Part>
</CompleteMultipartUpload>

Response

This section describes the response format.

Response headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Response body

The response body includes the following data:

Field Type Required Description
CompleteMultipartUploadResult Object - Multipart upload completion result
CompleteMultipartUploadResult.Bucket String - Bucket name
CompleteMultipartUploadResult.Key String - Object name
CompleteMultipartUploadResult.ETag String - Unique object identifier (entity tag)
CompleteMultipartUploadResult.Location String - Upload location
CompleteMultipartUploadResult.ChecksumCRC64NVME String - CRC64 checksum value
CompleteMultipartUploadResult.ChecksumType String - Object checksum calculation type
  • COMPOSITE | FULL_OBJECT
    • COMPOSITE: multipart checksum
    • FULL_OBJECT: full object checksum

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult>
    <Bucket>bucket</Bucket>
    <Key>object.zip</Key>
    <ETag>&#34;1f75ca9b7e6***********645f438f93-1&#34;</ETag>
    <Location>/bucket000/object000.zip</Location>
    <ChecksumCRC64NVME>WU7+G*******</ChecksumCRC64NVME>
    <ChecksumType>FULL_OBJECT</ChecksumType>
</CompleteMultipartUploadResult>