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

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

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

取得 bucket 的儲存空間版面配置

指令列

使用加上 --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.s3nsapis.fr/storage/v1/b/BUCKET_NAME/storageLayout"

    其中 BUCKET_NAME 是相關值區的名稱。例如：my-bucket。

    如果成功，回應會類似以下範例：

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

後續步驟