---
title: "CopyObject "
slug: "storage-archivestorage-copyobject"
tags: ["Archive Storage"]
updated: 2026-10-22T10:47:58Z
published: 2026-10-22T10:47:58Z
canonical: "api-gov.ncloud-docs.com/storage-archivestorage-copyobject"
---

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

# CopyObject

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

다른 위치에 있는 오브젝트를 복제하여 업로드합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| COPY | /v1/AUTH_{project_id}/{container}/{object} |

### 요청 헤더

헤더에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Optional | 발급한 토큰 값 |
| `Destination` | String | Required | 복사본을 저장할 경로 - 입력 포맷: `{container}/{object}` |
| `X-Object-Meta-{name}` | String | Optional | 설정할 메타데이터 - `{name}` 부분에 메타데이터의 키 입력 - 헤더 값에 메타데이터 값 입력 - 메타데이터 추가, 업데이트, 삭제 가능 - 삭제 요청 시 빈 값으로 설정 |
| `X-Fresh-Metadata` | Boolean | Optional | 메타데이터의 복사 여부 - `true` \| `false` (기본값) - `true`: 메타데이터 복사 안 함 - `false`: 메타데이터 복사 |
| `Content-Disposition` | String | Optional | 브라우저의 응답 처리 방식 |
| `Content-Encoding` | String | Optional | 오브젝트의 인코딩 방식 |
| `Content-Type` | String | Optional | 오브젝트의 MIME 타입 |

### 요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `project_id` | String | Required | 프로젝트 ID - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 |
| `container` | String | Required | 대상 오브젝트가 저장될 컨테이너 이름 |
| `object` | String | Required | 복사할 대상 오브젝트 이름 |

### 요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `multipart-manifest` | String | Conditional | 대용량 오브젝트의 멀티파트 업로드 선언 - 값으로 `get`을 입력하면 멀티파트 업로드로 인식 - 오브젝트 자체가 아닌 매니페스트가 복사됨 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl -L -X COPY 'https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
-H 'X-Auth-Token: {token}' \
-H 'X-Object-Meta-collection: C5' \
-H 'Destination: {container}/{object name}' \
-H 'X-Fresh-Metadata: true'
```

## 응답

응답 형식을 설명합니다.

### 응답 헤더

헤더에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `Content-Type` | String | - | 응답 결과의 MIME 타입 |
| `Content-Length` | String | - | 응답 결과의 길이(Byte) |
| `ETag` | String | - | ETag 헤더 값 |
| `Last-Modified` | String | - | 오브젝트의 가장 최근 수정 시간(UTC) |
| `X-Copied-From-Account` | String | - | 원본 오브젝트의 계정(프로젝트 ID) |
| `X-Copied-From` | String | - | 원본 오브젝트의 경로 - 포맷:`{container}/{object}` |
| `X-Copied-From-Last-Modified` | String | - | 원본 오브젝트의 `Last-Modified` 헤더 값 |
| `X-Object-Meta-{name}` | String | - | 오브젝트의 메타데이터 - `{name}` 부분이 메타데이터의 키 - 헤더 값이 메타데이터 값 |
| `X-Trans-Id` | String | - | 해당 요청의 트랜잭션 ID |
| `X-Openstack-Request-Id` | String | - | 해당 요청의 트랜잭션 ID - `X-Trans-Id`와 동일 |
| `Date` | String | - | 요청에 대한 응답 시간(UTC) |

### 응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 201 | - | Created | 요청 성공 |

### 응답 예시

응답 예시는 다음과 같습니다.

```
HTTP/1.1 201 Created
Last-Modified: Mon, 17 Sep 2018 08:21:36 GMT
Content-Length: 0
Etag: f1c9645dbc14efddc7d8a322685f26eb
Content-Type: text/html; charset=UTF-8
X-Copied-From-Account: AUTH_{project_id}
X-Copied-From-Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
X-Copied-From: ncloud-container-0/ncloud-object-0
X-Trans-Id: tx851b895d7fcf47f987a5a-005b9f640f
X-Openstack-Request-Id: tx851b895d7fcf47f987a5a-005b9f640f
Date: Mon, 17 Sep 2018 08:21:35 GMT
```