CopyObject
    • PDF

    CopyObject

    • PDF

    Article Summary

    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'
    

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    필드타입필수 여부설명
    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
    

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

    What's Next
    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.