버킷 메타데이터

메타데이터 가져오기

버킷 크기 가져오기

이 페이지에서는 버킷과 함께 Cloud Storage에 저장되는 메타데이터 필드를 설명합니다.

소개

Cloud Storage 버킷에는 연결된 메타데이터가 있습니다. 메타데이터는 버킷의 속성을 식별하고 액세스할 때 버킷을 처리하는 방법을 지정합니다.

메타데이터는 key: value 쌍으로 저장되며 value는 문자열, 배열, 중첩된 key:value 쌍을 포함하여 다양한 형식을 취할 수 있습니다. 예를 들어 버킷 이름은 문자열이고 버킷 객체 수명 주기 관리 구성은 각 규칙에 여러 하위 key: value 쌍이 포함된 규칙의 배열입니다.

메타데이터의 변경 가능성은 메타데이터마다 다릅니다.

  • 일부 메타데이터는 볼 수만 있습니다.

  • 일부 메타데이터는 버킷을 처음 만들 때만 설정할 수 있으며 수정 또는 삭제할 수 없습니다.

  • 일부 메타데이터는 추가하고 수정할 수 있지만 삭제할 수는 없습니다.

  • 일부 메타데이터는 언제든지 추가, 수정, 삭제할 수 있습니다.

수정할 수 없는 메타데이터

다음 메타데이터는 버킷 생성 중에 설정되며 수정하거나 삭제할 수 없습니다.

  • 버킷 이름

  • 버킷 위치

  • 버킷이 포함된 프로젝트

  • 메타 세대 번호

    • 버킷의 메타 세대 번호는 버킷의 메타데이터 상태를 고유하게 식별합니다. 메타 세대 번호는 버킷 생성 시 1이며 버킷의 메타데이터를 수정할 때마다 증가합니다.

수정 가능한 메타데이터

수정 가능한 버킷 메타데이터는 일반적으로 언제든지 값을 수정할 수 있는 메타데이터입니다. 조직 정책 제약조건이 적용되는 버킷과 같은 일부 경우에는 특정 메타데이터 값을 수정하는 데 제한사항이 있습니다.

메타데이터 개요 가이드 링크 참고
액세스제어 목록(ACL) ACL 만들기 및 관리 XML 사용자에게만 권장됩니다.
기본 ACL 기본 객체 ACL 설정
Identity and Access Management(IAM) 정책1 IAM 권한 사용
결제(요청자 지불) 요청자 지불 사용
교차 출처 리소스 공유(CORS) 구성 CORS 구성 설정 및 보기
기본 스토리지 클래스 기본 스토리지 클래스 변경 버킷 생성 중에 설정되며 수정할 수 있지만 삭제할 수는 없습니다.
기본 Cloud KMS 암호화 키 기본 Cloud KMS 키 사용
기본 이벤트 기반 보존 조치1 기본 이벤트 기반 보존 조치 속성 작업
공개 액세스 방지1 공개 액세스 방지 사용
균일한 버킷 수준 액세스1 균일한 버킷 수준 액세스 사용 버킷에 균일한 버킷 수준 액세스를 사용 설정한 뒤 90일 동안만 수정할 수 있습니다.
수명 주기 구성 정책 객체 수명 주기 관리
자동 클래스 자동 클래스 사용
터보 복제1 터보 복제 관리
사용량 로그 및 스토리지 로그 사용량 로그 구성
버킷 잠금2 보관 정책 사용 및 잠금 보관 정책을 잠그지 않는 경우에만 수정할 수 있습니다.
객체 보관 잠금 객체 보관 구성 사용 설정 및 사용 버킷 생성 중에만 설정할 수 있습니다.
객체 버전 관리 구성 객체 버전 관리 사용
버킷 라벨 버킷 라벨 사용
소프트 삭제 보관 기간 소프트 삭제 사용
웹사이트 구성 정적 웹사이트용 특수 페이지 할당

1 이 메타데이터는 XML API를 사용하여 보거나 관리할 수 없습니다.

2 XML API를 사용하여 버킷 생성 중에 이 메타데이터를 설정할 수 있지만 메타데이터를 보거나 관리할 수는 없습니다.

다음 단계