CreateMultipartUpload

Prev Next

Available in Classic and VPC

Start a multipart upload to upload a large object of 5 GB or more and create an upload ID.

Note

The created upload ID is used to link all parts of a specific multipart upload when combining them.

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 Type Required Description
Cache-Control String Optional Caching behavior
Content-Disposition Optional Display format of requested data
Content-Encoding Optional Encoding format of requested data
Content-Language Optional Request data language
Content-Type Optional Request data format
x-amz-storage-class Optional Storage class
  • STANDARD (default) | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
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
  • When saving to a folder within the bucket, enter in the format of {folder name}/{file name}.

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
uploads String Required Request to start multipart upload.
  • Enter only keys without values.

Request example

The request example is as follows:

POST /object.xlsx?uploads HTTP/1.1
Host: bucket.kr.ncloudstorage.com
x-amz-storage-class: DEEP_ARCHIVE

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
InitiateMultipartUploadResult Object - Multipart upload start result
InitiateMultipartUploadResult.Bucket String - Bucket name
InitiateMultipartUploadResult.Key String - Object name
InitiateMultipartUploadResult.UploadId String - Multipart upload ID
  • Save this for use in later API calls.

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"?>
<InitiateMultipartUploadResult>
    <Bucket>bucket</Bucket>
    <Key>object.xlsx</Key>
    <UploadId>7880da58-****-****-****-9cc2c468d0e9</UploadId>
</InitiateMultipartUploadResult>