upload-part-copy

Available in Classic and VPC

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

Note

For a Sub Account user to execute this command, they must have View/GetObject permissions (for the bucket containing the object to be copied) and Change/PutObject permissions (for the destination bucket where the object will be stored).

Syntax

The upload-part-copy syntax is as follows:

aws s3api upload-part-copy \
    --bucket <bucket> \
    --copy-source <copy-source> \
    --key <key> \
    --part-number <part-number> \
    --upload-id <upload-id> \
    [--copy-source-range <copy-source-range>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    [--copy-source-sse-customer-algorithm <copy-source-sse-customer-algorithm>] \
    [--copy-source-sse-customer-key <copy-source-sse-customer-key>] \
    [--copy-source-sse-customer-key-md5 <copy-source-sse-customer-key-md5>] \
    --endpoint-url <endpoint-url>

Options

This section describes the options available when running upload-part-copy.

Required options

The following options are required for upload-part-copy.

Options	Type	Required	Description
`--bucket`	String	Required	Bucket name
`--copy-source`	String	Required	Source object to copy Enter in the `{bucket_name}/{object_name}` format (e.g., `my-test-bucket/large.bin`). Bucket name: See list-buckets. Object name: See list-objects-v2. When copying a specific version of an object from a bucket with versioning enabled, add `?versionId={versionId}` to the input. Check version ID: See list-object-versions. Up to 5 GB.
`--key`	String	Required	Object name
`--part-number`	Integer	Required	Number of the part being uploaded The number of parts can range from 1 to 10,000.
`--upload-id`	String	Required	Multipart upload ID See create-multipart-upload.

Optional options

These are the optional options for upload-part-copy. Options that are not specified will use their default values.

Options	Type	Required	Description
`--copy-source-range`	String	Optional	Range of bytes to copy from the source
`--sse-customer-algorithm`	String	Optional	User encryption algorithm (AES256)
`--sse-customer-key`	String	Optional	User-provided encryption key
`--sse-customer-key-md5`	String	Optional	User-provided encryption key's MD5 value
`--copy-source-sse-customer-algorithm`	String	Optional	User encryption algorithm (AES256) of the source
`--copy-source-sse-customer-key`	String	Optional	User-provided encryption key of the source
`--copy-source-sse-customer-key-md5`	String	Optional	MD5 value of the source user-provided encryption key

Common options

For information about the options common to all aws subcommands, see Ncloud Storage options.

Examples

If the request to copy a part is successful, the identification information for the copied part and the version information for the original part are returned.

Command

The command example is as follows:

aws s3api upload-part-copy --bucket my-test-bucket \
    --key copied-large.bin \
    --part-number 1 \
    --upload-id {upload_id} \
    --copy-source my-test-bucket/large.bin \
    --endpoint-url=https://kr.ncloudstorage.com

Output

The output example is as follows:

{
    "ServerSideEncryption": "AES256",
    "CopyPartResult": {
        "ETag": "\"6caef151b75db9c5c62d1ff002024964\"",
        "LastModified": "2026-09-04T06:18:18Z"
    }
}

Related commands

Related commands are as follows: