バケットのメタデータ

メタデータを取得する

バケット サイズの取得

このページでは、バケットとともに Cloud Storage に保存されるメタデータ フィールドについて説明します。

はじめに

Cloud Storage バケットにはメタデータが関連付けられます。メタデータはバケットのプロパティを示し、バケットにアクセスしたときの処理方法を指定します。

メタデータは、key: value ペアとして保存されます。value には、文字列、配列、ネストされた key:value ペアなど、さまざまなデータ型があります。たとえば、バケット名は文字列であるものの、バケット オブジェクトのライフサイクル管理の構成はルールの配列です。各ルールには、複数の子 key: value ペアが含まれています。

メタデータの変更可能性は一定ではありません。

  • 表示のみ可能なものがあります。

  • 最初に作成したときにのみ設定が可能で、編集や削除はできないバケットがあります。

  • 追加と編集はできますが、削除はできないものがあります。

  • いつでも追加、編集、削除できるものがあります。

編集不可能なメタデータ

次のメタデータは、バケットの作成時に設定され、編集や削除はできません。

  • バケット名

  • バケットのロケーション

  • バケットが属しているプロジェクト

  • 世代番号

    • バケットの世代番号は、複数のバケット バージョンが同じ名前を共有している場合でも、バケットのバージョンを一意に識別します。

    • バケットの生成値は変更されません。

    • 後続のバージョンで世代番号が増えるとは限りません。新しいバージョンにのみ一意の世代番号が割り当てられます。

    • 無関係なバケットの世代番号には関係がありません。

  • metageneration 番号を受信します。

    • バケットの metageneration 番号は、バケットのメタデータの状態を一意に識別します。metageneration 番号は、バケットの作成時に 1 であり、バケットのメタデータを変更するたびに増加します。

編集可能なメタデータ

編集可能なバケット メタデータとは、その値をいつでも変更できるメタデータです。組織のポリシーの制約の対象となるバケットなど、特定のメタデータ値の変更に対する制限がある場合があります。

メタデータの概要 ガイドへのリンク 注
アクセス制御リスト（ACL） ACL の作成と管理 XML ユーザーにのみ推奨。
デフォルト ACL デフォルト オブジェクト ACL を設定する
Identity and Access Management（IAM）ポリシー1 IAM 権限の使用
課金（リクエスト元による支払い） リクエスト元による支払いを使用する
クロスオリジン リソース シェアリング（CORS）の構成 CORS 構成を設定、表示する
Default storage class デフォルトのストレージ クラスを変更する バケットの作成中に設定されます。編集は可能ですが、削除はできません。
デフォルトの Cloud KMS 暗号鍵 デフォルトの Cloud KMS 鍵を使用する
デフォルトのイベントベースの記録保持1 デフォルトのイベントベースの保留プロパティを使用する
公開アクセスの防止1 公開アクセス防止を使用する
一元的なバケットレベルのアクセス1 均一なバケットレベルのアクセスの使用 バケットで均一なバケットレベルのアクセスを有効にしてから最初の 90 日間のみ編集できます。
ライフサイクル構成ポリシー オブジェクト ライフサイクルを管理する
Autoclass Autoclass を使用する
ターボ レプリケーション1 ターボ レプリケーションの管理
使用状況ログとストレージログ 使用状況ログの構成
バケットロック2 保持ポリシーの使用とロック 保持ポリシーをロックする場合のみ編集できます。
オブジェクト保持ロック オブジェクト保持構成の有効化と使用 一度バケットで有効にすると、無効にすることはできません。
オブジェクトのバージョニング構成 オブジェクトのバージョニングを使用する
バケットラベル バケットラベルの使用
削除（復元可能）の保持期間 削除（復元可能）を使用する
ウェブサイトの構成 静的ウェブサイトの特殊ページを割り当てる

1 このメタデータは XML API を使用して表示または管理できません。

2 このメタデータは、バケットの作成時に XML API を使用して設定できます。ただし、メタデータの表示や管理はできません。

次のステップ