CopyObject

Prev Next

Available in Classic and VPC

Copy and save an object stored in a Ncloud Storage bucket. Objects up to 5 GB can be copied.

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.
  • 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-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 copy name
  • When saving to a folder within the bucket, enter in the format of {folder name}/{file name}.

Request example

The request example is as follows:

PUT /object.jpg HTTP/1.1
Host: bucket.kr.ncloudstorage.com
x-amz-copy-source: bucket000/object.csv
Cache-Control: no-cache
Content-Disposition: attachment; filename=object.csv
Content-Language: en
x-amz-metadata-directive: REPLACE

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
CopyObjectResult Object - Object copy result
CopyObjectResult.LastModified String - Last modification date and time
  • ISO 8601 format
CopyObjectResult.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

<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult>
    <LastModified>2025-04-28T09:36:57Z</LastModified>
    <ETag>"2dd********************4f6181"</ETag>
</CopyObjectResult>