このページでは、Cloud Storage バケットのメタデータ(IAM ポリシーと ACL を除く)に関する情報の取得方法について説明します。
バケットの IAM ポリシーを取得する方法については、バケットの IAM ポリシーを表示するをご覧ください。
必要なロール
Cloud Storage バケットのメタデータを取得するために必要な権限を取得するには、バケットに対するストレージ管理者(roles/storage.admin
)ロールを付与するよう管理者に依頼してください。
このロールには、バケットのメタデータを取得するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
storage.buckets.get
storage.buckets.list
- この権限は、Google Cloud コンソールを使用してこのページのタスクを実行する場合にのみ必要です。
これらの権限は、他の事前定義ロールやカスタムロールを使用して取得することもできます。
バケットに対してロールを付与する手順については、バケットで IAM を使用するをご覧ください。
バケットのメタデータを表示する
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットリストで、メタデータを表示するバケットの名前をクリックします。
[構成] タブをクリックすると、含まれるリージョン、ストレージ クラス、権限、レプリケーション タイプなどのバケットの詳細が表示されます。
コマンドライン
gcloud storage buckets describe
コマンドを使用します。
gcloud storage buckets describe gs://BUCKET_NAME
ここで
BUCKET_NAME
は、メタデータを表示するバケットの名前です。例:my-awesome-bucket
正常に終了すると、レスポンスは次の例のようになります。
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
クライアント ライブラリ
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Terraform
バケットのメタデータを表示するには、Terraform リソースを使用します。
REST API
JSON API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。cURL
を使用して、GET
Bucket リクエストで JSON API を呼び出します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
BUCKET_NAME
は、該当するバケットの名前です。例:my-bucket
fields
クエリ文字列パラメータを使用してメタデータの結果を絞り込むこともできます。次に例を示します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
ここで、
FIELD#
は、結果に含めるバケットのプロパティです。たとえば、projectNumber
やstorageClass
です。
次の例のようなレスポンスになります。
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
XML API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。cURL
を使用して、GET
Bucket リクエストで XML API を呼び出します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
ここで
BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
QUERY_PARAMETER
は、返すメタデータ フィールドです。たとえば、バケットのストレージ クラスを取得するためのstorageClass
です。XML API で一度に使用できるクエリ パラメータは 1 つのみです。XML API でサポートされているメタデータ フィールドの一覧については、GET
リファレンス ページをご覧ください。
次の例:
<StorageClass>STANDARD</StorageClass>
のようなレスポンスになります。
次のステップ
使ってみる
Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Storage のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
Cloud Storage を無料で試す