---
title: "copy"
slug: "cli-archivestorage-copy"
updated: 2026-10-08T04:57:15Z
published: 2026-10-08T04:57:15Z
canonical: "cli.ncloud-docs.com/cli-archivestorage-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.

# copy

Available in Classic and VPC

Copy an object to a new location. If you do not specify a destination, only the object's metadata is changed.

## Syntax

The `copy` syntax is as follows:

```
swift copy \
    <container> \
    <object> \
    [--destination <destination-path>] \
    [--fresh-metadata] \
    [--meta <name:value>] \
    [--header <header:value>]
```

## Options

This section describes the options available when running `copy`.

### Required options

The following options are required for `copy`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `&lt;container&gt;` | String | Required | Container name |
| `&lt;object&gt;` | List | Required | Object name - Multiple entries are allowed, separated by spaces. |

### Optional options

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

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--destination` | String | Optional | Container and object names to copy - Enter in `/container/object` format. - If the object name is omitted, the same name as the source is used. - An error occurs if you specify object names when copying multiple objects. |
| `--fresh-metadata` | Boolean | Optional | Copy excluding existing metadata. - If left blank, existing metadata is retained or appended. |
| `--meta` | String | Optional | Metadata entry - Enter in `name:value` format. |
| `--header` | String | Optional | Custom header to use in the request - Enter in `header:value` format. |

### Common options

For information about the options common to all `swift` subcommands, see [Archive Storage options](/docs/en/guide-archivestorage#%EC%98%B5%EC%85%98).

## Examples

When you run the command, the source object and destination path are displayed.

### Command

The command example is as follows:

```
swift copy test-container-01 sample.txt \
    --destination /test-container-01/copied.txt
```

### Output

The output example is as follows:

```
created container test-container-01
test-container-01/sample.txt copied to /test-container-01/copied.txt
```