CopyObject

Prev Next

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
container String Required 대상 오브젝트가 저장될 컨테이너 이름
object String Required 복사할 대상 오브젝트 이름

요청 쿼리 파라미터

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

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

요청 예시

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

curl -L -X COPY 'https://kr.archive.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