UploadPartCopy

Prev Next

Available in Classic and VPC

Copy an object stored in a Ncloud Storage bucket and upload it as a part of a multipart upload.

Request

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

Method URI
PUT /{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-copy-source Required Object to be copied
  • Enter in the {Bucket name}/{Object name} format.
  • Example: bucket/object.csv
  • When copying a specific version of an object from a bucket with version control enabled, add ?versionId={versionId} to the input value.
Cache-Control 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-metadata-directive Optional Metadata processing method
  • COPY (default) | REPLACE
    • COPY: Copy original.
    • REPLACE: Redefine.
x-amz-storage-class Optional Storage class
  • STANDARD (default) | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
x-amz-copy-source-range Optional Range of bytes to copy from the source
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
x-amz-copy-source-server-side-encryption-customer-algorithm Optional User encryption algorithm (AES256) of the source
x-amz-copy-source-server-side-encryption-customer-key Optional User-provided encryption key of the source
x-amz-copy-source-server-side-encryption-customer-key-MD5 Optional MD5 value of the source user-provided encryption key

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
partNumber Integer Required Part number
  • 1-10,000
uploadId String Required Multipart upload ID

Request example

The request example is as follows:

PUT /object.zip?partNumber=2&uploadId=2c5f5e8c-****-****-****-9cc2c468d0e9 HTTP/1.1
Host: bucket.kr.ncloudstorage.com
x-amz-copy-source: bucket/part2.zip
Cache-Control: no-cache
Content-Language: en

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
CopyPartResult Object - Multipart upload result for the object copy
CopyPartResult.LastModified String - Last modification date and time
  • ISO 8651 format
CopyPartResult.ETag String - Unique object identifier (entity tag)

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
<CopyPartResult>
    <LastModified>2025-04-29T08:10:32.000Z</LastModified>
    <ETag>&#34;d8c2eafd90c***********acc479f8af&#34;</ETag>
</CopyPartResult>