---
title: "upload-part-copy"
slug: "upload-part-copy"
updated: 2026-10-08T04:59:37Z
published: 2026-10-08T04:59:37Z
canonical: "cli.ncloud-docs.com/upload-part-copy"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/en/list-buckets). - Object name: See [list-objects-v2](/docs/en/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](/docs/en/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](/docs/en/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](/docs/en/storage-ncloudstorage#%EC%98%B5%EC%85%98).

## 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:

- [create-multipart-upload](/docs/en/create-multipart-upload)
- [upload-part](/docs/en/upload-part)
- [complete-multipart-upload](/docs/en/complete-multipart-upload)
- [abort-multipart-upload](/docs/en/abort-multipart-upload)
- [list-parts](/docs/en/list-parts)
- [list-multipart-uploads](/docs/en/list-multipart-uploads)