CopyObject

Prev Next

개요

다른 위치에 있는 오브젝트를 복제합니다.

구문

COPY /v1/AUTH_{project_id}/{container}/{object}

요청

명칭 In 타입 설명
project_id path string 프로젝트 ID 입력
container path string 컨테이너(버킷) 이름 입력
object path string 오브젝트의 이름 입력
multipart-manifest (Optional) query string multipart-manifest=get인 경우, 해당 오브젝트는 대용량 오브젝트(SLO)로 인식
해당 오브젝트의 내용은 복사되지 않고, 매니페스트가 복사됨
X-Auth-Token (Optional) header string 발급한 Token 값 입력
Content-Type (Optional) header string 해당 오브젝트의 MIME 타입 입력
Content-Encoding (Optional) header string 해당 오브젝트의 인코딩 방식
Content-Disposition (Optional) header string 브라우저에 대한 작동을 재정의함
X-Object-Meta-{name} (Optional) header string 해당 오브젝트의 메타데이터를 세팅 (헤더명의 name 부분이 메타데이터의 키 역할을 함)
추가, 업데이트, 삭제가 가능하며, 삭제는 빈 값으로 요청하면 됨
X-Fresh-Metadata (Optional) header boolean true인 경우 메타데이터는 생략하고 오브젝트만 복사 (디폴트 값은 false)

응답

명칭 In 타입 설명
Content-Length header string 응답 결과의 길이 (Bytes)
X-Copied-From-Last-Modified (Optional) header integer 원본 오브젝트의 last_modified 헤더 값
X-Copied-From (Optional) header string 원본 오브젝트의 경로
X-Copied-From-Account (Optional) header string 원본 오브젝트의 어카운트
Last-Modified header string 복사 오브젝트가 수정된 가장 최근 시간 (UTC)
ETag header string ETag 헤더 값
X-Trans-Id header string 해당 요청의 트랜젝션 ID
X-Openstack-Request-Id header string 해당 요청의 트랜젝션 ID (X-Trans-Id와 동일)
Date header string 해당 요청의 응답 시간 (UTC)
Content-Type header string 응답 결과의 MIME 타입

예시

요청 예시

curl -i -X COPY -H "X-Auth-Token: $token" -H "Destination: $copy_destination" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예시

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

오브젝트를 복사합니다.
요청이 성공하게 되면 Created (201) 상태 코드를 응답합니다.