バケットのストレージ レイアウトを取得する

このページでは、バケットのストレージ レイアウトを決定する方法について説明します。ストレージ レイアウトとは、バケット内のオブジェクトがフラットな名前空間または階層型名前空間のどちらで整理されるかを指します。オブジェクトのアクセス方法と操作方法はレイアウトによって異なるため、バケットを操作するアプリではレイアウトが重要になります。ストレージ レイアウトには、バケットの場所に関する情報も含まれます。

getStorageLayout API を使用すると、バケットが階層型名前空間を使用するかどうかに基づいて動作を調整し、バケットの構成に基づいて最適な互換性を確保して適切な機能を利用できます。

バケットのストレージ レイアウトを取得する

JSON API

  1. Authorization ヘッダーのアクセス トークンを生成するには、gcloud CLI のインストールと初期化を行います。

    OAuth 2.0 Playground を使用してアクセス トークンを作成し、Authorization ヘッダーに含めることもできます。

  2. cURL を使用して、getStorageLayout リクエストで JSON API を呼び出します。

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

    BUCKET_NAME は、該当するバケットの名前です。例: my-bucket。

    成功した場合は、次の例のようなレスポンスになります。

      {
      "kind": "storage#storageLayout",
      "bucket": "my-bucket",
      "location": "us-central1",
      "locationType": "region",
      "hierarchicalNamespace":{enabled: true},
  }

次のステップ

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Storage のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Cloud Storage を無料で試す