Amazon S3 콘솔에서 객체 메타데이터 편집

Amazon S3 콘솔에서 객체 메타데이터 편집 (Editing object metadata in the Amazon S3 console)

Amazon S3 콘솔의 복사(Copy) 작업을 사용하면 기존 S3 객체의 메타데이터를 편집할 수 있어요. 메타데이터를 편집하려면 객체를 같은 대상 위치에 복사하면서 적용할 새 메타데이터를 지정하면 돼요. 그러면 객체의 기존 메타데이터가 새 값으로 교체돼요. 객체를 업로드할 때 Amazon S3가 설정하는 메타데이터도 있어요. 예를 들어 Content-Length와 Last-Modified는 시스템 정의 객체 메타데이터 필드로, 사용자가 수정할 수 없어요.

출처: 문서

본문

객체를 업로드할 때 사용자 정의 메타데이터를 설정하고, 요구 사항이 바뀌면 교체할 수도 있어요. 예를 들어 처음에 STANDARD 스토리지 클래스에 저장한 객체 세트가 있다고 해 볼게요. 시간이 지나 이 데이터를 굳이 고가용성으로 유지할 필요가 없어진다면, x-amz-storage-class 키 값을 STANDARD에서 GLACIER로 바꿔 스토리지 클래스를 변경할 수 있어요.

참고 복사(Copy) 작업으로 시스템 정의 또는 사용자 정의 객체 메타데이터를 교체할 때는 다음을 고려하세요.

  • 유지하고 싶은 기존 메타데이터, 추가하고 싶은 메타데이터, 편집하고 싶은 메타데이터를 모두 지정해야 해요.
  • 객체가 5GB 미만이면 S3 콘솔의 복사(Copy) 작업을 사용해 객체 메타데이터를 교체할 수 있어요. 객체가 5GB보다 크면 AWS CLI 또는 AWS SDK를 사용해 멀티파트 업로드로 객체를 복사할 때 객체 메타데이터를 교체할 수 있어요. 자세한 내용은 멀티파트 업로드를 사용한 객체 복사를 참고하세요.
  • 메타데이터 교체에 필요한 추가 권한 목록은 Amazon S3 API 작업에 필요한 권한을 참고하세요. 이 권한을 부여하는 예시 정책은 Amazon S3 아이덴티티 기반 정책 예시를 참고하세요.
  • 이 작업은 업데이트된 설정과 마지막 수정 날짜를 가진 객체의 *사본(copy)*을 만들어요. S3 버전 관리가 활성화되어 있으면 객체의 새 버전이 생성되고, 기존 객체는 이전 버전이 돼요. S3 버전 관리가 활성화되어 있지 않으면 새 사본이 원본 객체를 대체해요. 속성을 변경하는 IAM 역할과 연결된 AWS 계정도 새 객체(또는 객체 버전)의 소유자가 돼요.
  • 메타데이터를 편집하면 기존 키 이름의 값도 교체돼요.
  • 고객 제공 암호화 키(SSE-C)로 암호화된 객체는 콘솔로 복사할 수 없어요. AWS CLI, AWS SDK 또는 Amazon S3 REST API를 사용해야 해요.
  • Amazon S3 콘솔로 객체를 복사할 때 "Copied metadata can't be verified." 오류 메시지가 나타날 수 있어요. 콘솔은 헤더를 사용해 객체의 메타데이터를 검색하고 설정해요. 네트워크나 브라우저 구성이 네트워크 요청을 수정한다면 이 동작 때문에 복사된 객체에 의도하지 않은 메타데이터(예: 수정된 Cache-Control 헤더)가 기록될 수 있어요. Amazon S3는 이 의도하지 않은 메타데이터를 검증할 수 없어요. 이 문제를 해결하려면 Cache-Control 같은 헤더를 수정하지 않도록 네트워크와 브라우저 구성을 확인하세요. 자세한 내용은 공동 책임 모델을 참고하세요.

경고 폴더의 메타데이터를 교체할 때는 복사(Copy) 작업이 끝날 때까지 폴더에 새 객체를 추가하지 마세요. 그렇지 않으면 새 객체도 함께 편집될 수 있어요.

다음 주제는 Amazon S3 콘솔의 복사(Copy) 작업을 사용해 객체 메타데이터를 교체하는 방법을 설명해요.

참고 객체에 주석을 추가, 보기, 삭제하려면 객체의 속성(Properties) 탭에 있는 주석(Annotations) 섹션을 사용하세요. 자세한 내용은 주석 관리를 참고하세요.

S3 객체의 일부 시스템 정의 메타데이터는 교체할 수 있어요. 수정할 수 있는 시스템 정의 메타데이터와 값 목록은 시스템 정의 객체 메타데이터를 참고하세요.

객체의 시스템 정의 메타데이터 교체하기 (To replace system-defined metadata of an object)

  • AWS Management Console에 로그인하고 https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔을 엽니다.
  • 왼쪽 탐색 창에서 범용 버킷(General purpose buckets) 또는 **디렉터리 버킷(Directory buckets)**을 선택해요.
  • 버킷 목록에서 변경할 객체가 들어 있는 버킷 이름을 선택해요.
  • 변경할 객체의 확인란을 선택해요.
  • 작업(Actions) 메뉴에서 나타나는 옵션 목록 중 **복사(Copy)**를 선택해요.
  • 대상 경로를 지정하려면 **S3 찾아보기(Browse S3)**를 선택하고 원본 객체와 같은 대상으로 이동한 다음 대상 확인란을 선택하고 **대상 선택(Choose destination)**을 선택해요. 또는 대상 경로를 직접 입력해요.
  • 버킷 버전 관리를 활성화하지 않은 경우, 객체를 실수로 덮어쓰거나 삭제하지 않도록 버킷 버전 관리를 활성화하라는 경고가 표시돼요. 이 버킷의 모든 객체 버전을 유지하려면 **버킷 버전 관리 활성화(Enable Bucket Versioning)**를 선택해요. **대상 세부 정보(Destination details)**에서 기본 암호화와 Object Lock 속성도 확인할 수 있어요.
  • **추가 복사 설정(Additional copy settings)**에서 **설정 지정(Specify settings)**을 선택해 메타데이터(Metadata) 설정을 지정해요.
  • 메타데이터(Metadata) 섹션까지 스크롤한 다음 **모든 메타데이터 교체(Replace all metadata)**를 선택해요.
  • **메타데이터 추가(Add metadata)**를 선택해요.
  • 메타데이터 **유형(Type)**에서 **시스템 정의(System-defined)**를 선택해요.
  • 고유한 **키(Key)**와 메타데이터 **값(Value)**을 지정해요.
  • 추가 메타데이터를 편집하려면 **메타데이터 추가(Add metadata)**를 선택해요. 유형-키-값 세트를 제거하려면 **제거(Remove)**를 선택할 수도 있어요.
  • **복사(Copy)**를 선택해요. Amazon S3가 메타데이터 변경 사항을 저장해요.

객체의 사용자 정의 메타데이터 교체하기 (To replace user-defined metadata of an object)

사용자 정의 메타데이터는 메타데이터 접두사 x-amz-meta-와 사용자가 정한 이름을 결합해 커스텀 키를 만들어 교체할 수 있어요. 예를 들어 커스텀 이름 alt-name을 추가하면 메타데이터 키는 x-amz-meta-alt-name이 돼요.

사용자 정의 메타데이터는 총 2KB까지 가능해요. 사용자 정의 메타데이터의 총 크기를 계산하려면 각 키와 값의 UTF-8 인코딩 바이트 수를 모두 더하면 돼요. 키와 값 모두 US-ASCII 표준을 따라야 해요. 자세한 내용은 사용자 정의 메타데이터를 참고하세요.

  • AWS Management Console에 로그인하고 https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔을 엽니다.
  • 탐색 창에서 **버킷(Buckets)**을 선택한 다음 범용 버킷(General purpose buckets) 또는 디렉터리 버킷(Directory buckets) 탭을 선택해요. 변경할 객체가 들어 있는 Amazon S3 버킷 또는 폴더로 이동해요.
  • 변경할 객체의 확인란을 선택해요.
  • 작업(Actions) 메뉴에서 나타나는 옵션 목록 중 **복사(Copy)**를 선택해요.
  • 대상 경로를 지정하려면 **S3 찾아보기(Browse S3)**를 선택하고 원본 객체와 같은 대상으로 이동한 다음 대상 확인란을 선택하고 **대상 선택(Choose destination)**을 선택해요. 또는 대상 경로를 직접 입력해요.
  • 버킷 버전 관리를 활성화하지 않은 경우, 객체를 실수로 덮어쓰거나 삭제하지 않도록 버킷 버전 관리를 활성화하라는 경고가 표시돼요. 이 버킷의 모든 객체 버전을 유지하려면 **버킷 버전 관리 활성화(Enable Bucket Versioning)**를 선택해요. **대상 세부 정보(Destination details)**에서 기본 암호화와 Object Lock 속성도 확인할 수 있어요.
  • **추가 복사 설정(Additional copy settings)**에서 **설정 지정(Specify settings)**을 선택해 메타데이터(Metadata) 설정을 지정해요.
  • 메타데이터(Metadata) 섹션까지 스크롤한 다음 **모든 메타데이터 교체(Replace all metadata)**를 선택해요.
  • **메타데이터 추가(Add metadata)**를 선택해요.
  • 메타데이터 **유형(Type)**에서 **사용자 정의(User-defined)**를 선택해요.
  • x-amz-meta- 뒤에 고유한 커스텀 **키(Key)**를 입력해요. 메타데이터 **값(Value)**도 입력해요.
  • 추가 메타데이터를 추가하려면 **메타데이터 추가(Add metadata)**를 선택해요. 유형-키-값 세트를 제거하려면 **제거(Remove)**를 선택할 수도 있어요.
  • **복사(Copy)**를 선택해요. Amazon S3가 메타데이터 변경 사항을 저장해요.

더 알아보기 (Learn more)