---
title: "copy"
slug: "cli-archivestorage-copy"
updated: 2026-10-22T09:07:27Z
published: 2026-10-22T09:07:27Z
canonical: "cli-gov.ncloud-docs.com/cli-archivestorage-copy"
---

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

# copy

Classic/VPC 환경에서 이용 가능합니다.

오브젝트를 새로운 위치로 복사합니다. 대상 위치를 지정하지 않으면 오브젝트의 메타데이터만 변경됩니다.

## 구문

`copy` 구문은 다음과 같습니다.

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

## 옵션

`copy` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`copy`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;container&gt;` | String | Required | 컨테이너 이름 |
| `&lt;object&gt;` | List | Required | 오브젝트 이름 - 공백으로 구분하여 여러 개 입력 가능 |

### 선택 옵션

`copy`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--destination` | String | Optional | 복사할 대상 컨테이너와 오브젝트 이름 - `/container/object` 형식으로 입력 - 오브젝트 이름을 생략하면 원본과 동일한 이름 사용 - 여러 오브젝트를 복사할 때 오브젝트 이름까지 지정하면 오류 |
| `--fresh-metadata` | Boolean | Optional | 기존 메타데이터를 제외하고 복사 - 미입력 시 기존 메타데이터 유지 또는 추가 |
| `--meta` | String | Optional | 메타데이터 항목 - `name:value` 형식으로 입력 - 다중 메타데이터 설정 가능 (예시: `swift post test-container-01 --meta name1:value1 --meta name2:value2`) |
| `--header` | String | Optional | 요청에 사용할 표준 HTTP 헤더 및 사용자 정의 메타데이터 - 표준 HTTP 헤더의 경우 `header:value` 형식으로 입력 - 사용자 정의 메타데이터의 경우 `X-Object-Meta-{header}:value` 형식으로 입력 - 반복 입력 가능 (예시: `--header Content-Type:text/plain --header X-Object-Meta-header:value`) |

### 공통 옵션

`swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

명령을 실행하면 원본 오브젝트와 대상 경로가 출력됩니다.

### 명령

명령 예시는 다음과 같습니다.

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

### 출력

출력 예시는 다음과 같습니다.

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