버킷 메타데이터

예시로 이동

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

소개

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

일부 메타데이터가 key: value 쌍으로 존재합니다. 예를 들어 버킷 이름은 JSON API의 메타데이터 항목 name: my-bucket-name으로 표현됩니다. XML API는 버킷 위치의 <LocationConstraint>US</LocationConstraint>과 같이 메타데이터를 <elements></elements>로 표시합니다.

다른 메타데이터에는 키와 연결된 데이터 배열이 있을 수 있습니다. 예를 들어 수명 주기 관리 메타데이터에는 버킷의 현재 및 향후 객체에 적용되는 규칙 집합이 포함될 수 있습니다.

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

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

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

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

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

수정할 수 없는 메타데이터

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

  • 버킷 이름

  • 버킷 위치

  • 버킷이 포함된 프로젝트

  • 메타 세대 번호

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

수정 가능한 메타데이터

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

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

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

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

버킷 라벨

버킷 라벨을 사용하면 버킷의 메타데이터 일부로 저장되는 임의의 키-값 쌍을 만들 수 있습니다. 라벨을 사용하여 가상 머신 인스턴스영구 디스크와 같은 다른 Google Cloud 리소스와 함께 버킷을 구성할 수 있습니다. 예를 들어 alpha, beta, delta 값을 가진 team이라는 키가 필요하고, 이 키를 특정 Google Cloud 리소스와 연결된 팀을 나타내는 데 사용한다고 가정합니다. 원하는 리소스에 team:alpha, team:beta, team:delta 라벨을 적용하여 이를 수행할 수 있습니다.

버킷 라벨 사용 시 다음 사항에 유의하세요.

  • 키 및 값은 각각 63자보다 길 수 없습니다.
  • 키 및 값은 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다.
  • 라벨 키는 소문자로 시작해야 하며 국제 문자는 허용됩니다.
  • 라벨 키는 비워 둘 수 없습니다.
  • 각 버킷에는 최대 64개의 라벨을 적극적으로 적용할 수 있습니다.
  • 버킷 메타데이터의 경우와 마찬가지로, 버킷 라벨은 개별 객체 또는 객체 메타데이터와 연결되지 않습니다.

청구에서 라벨을 사용하여 리소스를 구성하는 일반적인 예는 BigQuery 쿼리로 청구 내보내기 예를 참조하세요.

다음 단계