本頁說明如何判斷值區的儲存空間配置。儲存空間配置是指物件在值區中的整理方式,可以是扁平命名空間或階層式命名空間。對於與 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
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。使用
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