取得值區的儲存空間版面配置

本頁說明如何判斷值區的儲存空間配置。儲存空間配置是指物件在值區中的整理方式,可以是扁平命名空間或階層式命名空間。對於與 bucket 互動的應用程式而言,版面配置十分重要,因為物件存取和操控方法會因版面配置而異。儲存空間配置也包含值區位置的相關資訊。

使用 getStorageLayout API 時,應用程式可以根據值區是否使用階層式命名空間調整行為,確保最佳相容性,並根據值區設定運用適當的功能。

取得值區的儲存空間版面配置

指令列

使用加上 --format 旗標的 gcloud alpha storage buckets describe 指令:

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

其中:

  • BUCKET_NAME 是相關值區的名稱。例如:my-bucket

如果成功且已啟用階層式命名空間,回應會類似以下範例:

  hierarchicalNamespace:
    enabled: true

JSON API

  1. 安裝並初始化 gcloud CLI,以便為 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