MENU
      CopyObject

        CopyObject


        기사 요약

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

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

        요청

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

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

        요청 헤더

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

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

        요청 경로 파라미터

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

        필드타입필수 여부설명
        project_idStringRequired프로젝트 ID
        containerStringRequired대상 오브젝트가 저장될 컨테이너 이름
        objectStringRequired복사할 대상 오브젝트 이름

        요청 쿼리 파라미터

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

        필드타입필수 여부설명
        multipart-manifestStringConditional대용량 오브젝트의 멀티파트 업로드 선언
        • 값으로 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'
        Curl

        응답

        응답 형식을 설명합니다.

        응답 헤더

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

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

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.