取得值區的儲存空間版面配置 (original) (raw)

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

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

需要角色

如要取得 Cloud Storage bucket 的儲存空間配置，請要求管理員授予 bucket 的 Storage 物件使用者 (roles/storage.objectUser) 角色。

該角色包含 storage.objects.list 權限，這是取得值區儲存空間配置所需的權限。

您或許還可透過其他自訂角色或預先定義的角色取得這項權限。如要查看哪些角色與哪些權限相關聯，請參閱 Cloud Storage 的 IAM 角色。

如需如何授予值區角色的操作說明，請參閱「搭配值區使用 IAM」。

取得 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.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