메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

객체 복사

복사 작업은 Amazon S3에 저장되어 있는 객체의 복사본을 만듭니다. 단일 원자성 작업으로 최대 5GB의 객체 복사본을 만들 수 있습니다. 그러나 5GB보다 큰 객체를 복사하려면 멀티파트 업로드 API를 사용해야 합니다. copy를 사용하여 다음과 같은 작업을 수행할 수 있습니다.

  • 객체의 추가 복사본 생성

  • 객체를 복사하여 이름을 변경한 후 원본 삭제

  • 객체를 다른 Amazon S3 위치로 이동(예: us-west-1에서 EU로 이동)

  • 객체 메타데이터 변경

    각 Amazon S3 객체에는 메타데이터가 있으며, 이름-값 페어의 집합으로 표시됩니다. 객체를 업로드할 때 객체 메타데이터를 설정할 수 있습니다. 객체를 업로드한 후에는 객체 메타데이터를 변경할 수 없습니다. 객체 메타데이터를 수정할 수 있는 유일한 방법은 객체 복사본을 만든 후 메타데이터를 설정하는 것입니다. 이때 복사 작업의 원본과 대상을 동일한 객체로 설정합니다.

각 객체에는 메타데이터가 있으며, 시스템 메타데이터와 사용자 정의 메타데이터의 두 종류 메타데이터가 있습니다. 객체에 대해 사용하도록 구성된 스토리지 클래스, 서버 측 암호화와 같은 일부 시스템 메타데이터는 사용자가 제어할 수 있습니다. 객체를 복사할 때 사용자 제어 시스템 메타데이터와 사용자 정의 메타데이터는 복사되지만, 시스템 제어 메타데이터는 Amazon S3에 의해 재설정됩니다. 예를 들어 객체를 복사할 때 Amazon S3는 복사된 객체의 생성일을 재설정합니다. 복사 요청에서 이러한 값을 설정할 필요가 없습니다.

객체를 복사할 때 일부 메타데이터 값을 업데이트할 수 있습니다. 예를 들어 원본 객체가 표준 스토리지를 사용하도록 구성된 경우 복사된 객체에 대해서는 RRS(Reduced redundancy storage)를 사용하도록 선택할 수 있습니다. 또한 원본 객체에 설정된 일부 사용자 정의 메타데이터 값을 변경할 수도 있습니다. 복사 과정에서 이처럼 사용자가 구성 가능한 객체 메타데이터(시스템 또는 사용자 정의 메타데이터)를 업데이트하려면 일부 메타데이터 값만 변경하려는 경우에도 요청의 원본 객체에 설정된 사용자가 구성 가능한 모든 메타데이터를 명시적으로 지정해야 합니다.

객체 메타데이터에 대한 자세한 내용은 객체 키와 메타데이터 단원을 참조하십시오.

참고

서로 다른 위치로 객체를 복사할 경우 대역폭 비용이 청구됩니다.

참고

원본 객체가 Amazon Glacier에 보관된 경우(객체의 스토리지 클래스가 GLACIER임) 먼저 임시 사본을 복원한 후 다른 버킷으로 객체를 복사할 수 있습니다. 객체 보관에 대한 자세한 내용은 GLACIER 스토리지 클래스로의 전환(객체 보관) 단원을 참조하십시오.

객체를 복사할 때 Amazon S3가 AWS Key Management Service(KMS) 암호화 키, Amazon S3가 관리하는 암호화 키 또는 고객 제공 암호화 키를 사용하여 대상 객체를 암호화한 후 저장하도록 요청할 수 있습니다. 그러려면 요청에 암호화 정보를 지정해야 합니다. 복사 원본이 고객 제공 키를 사용한 서버 측 암호화로 Amazon S3에 저장된 객체인 경우 요청에 암호화 정보를 제공해야 Amazon S3가 객체를 해독하여 복사할 수 있습니다. 자세한 내용은 암호화를 사용하여 데이터 보호를 참조하십시오.

관련 리소스

이 페이지에서: