バケットのメタデータ

メタデータを取得する

バケットサイズを取得する

このページでは、バケットとともに 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 日間のみ編集できます。
ライフサイクル構成ポリシー オブジェクト ライフサイクルを管理する
Autoclass Autoclass を使用する
ターボ レプリケーション1 ターボ レプリケーションを管理する
使用状況ログとストレージログ 使用状況ログの構成
バケットロック2 保持ポリシーの使用とロック 保持ポリシーをロックする場合のみ編集できます。
オブジェクト保持ロック オブジェクト保持構成の有効化と使用 バケットの作成中にのみ設定できます。
オブジェクトのバージョニング構成 オブジェクトのバージョニングを使用する
バケットラベル バケットラベルの使用
削除（復元可能）の保持期間 削除（復元可能）を使用する
ウェブサイトの構成 静的ウェブサイトの特殊ページを割り当てる

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

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

次のステップ