本頁面說明如何取得 Cloud Storage 值區的中繼資料相關資訊,但不含 IAM 政策和存取控制清單。
如要瞭解如何取得值區的 IAM 政策,請參閱「查看值區的 IAM 政策」。
必要的角色
如要取得取得 Cloud Storage 值區中繼資料所需的權限,請要求管理員為您授予該值區的 Storage 管理員 (roles/storage.admin
) 角色。
這個角色包含取得資料夾中繼資料所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.buckets.get
storage.buckets.list
- 只有在您打算使用 Google Cloud 控制台執行此頁面上的任務時,才需要這項權限。
如需值區角色授予作業的操作說明,請參閱「搭配使用值區與 IAM」。
顯示值區的中繼資料
控制台
- 在 Google Cloud 控制台,前往 Cloud Storage「Buckets」頁面。
在值區清單中,按一下要查看中繼資料的值區名稱。
按一下「Configuration」(設定) 分頁標籤,即可查看值區詳細資料,例如所包含的區域、儲存空間類別、權限和複寫類型。
指令列
使用 gcloud storage buckets describe
指令:
gcloud storage buckets describe gs://BUCKET_NAME
其中:
BUCKET_NAME
是值區名稱,其中包含您要查看其中繼資料的值區。例如:my-awesome-bucket
。
如果成功,回應會類似以下範例:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Terraform
您可以使用 Terraform 資源查看 bucket 的中繼資料。
REST API
JSON API
使用
cURL
透過GET
值區要求呼叫 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
其中
BUCKET_NAME
是相關值區的名稱。例如:my-bucket
。您可以選擇使用
fields
查詢字串參數,縮小中繼資料結果的範圍。例如:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
其中
FIELD#
是您要納入結果的值區屬性。例如projectNumber
和storageClass
。
回應類似下列範例:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
XML API
使用
cURL
透過GET
值區要求呼叫 XML API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
其中:
BUCKET_NAME
是相關值區的名稱。例如:my-bucket
。QUERY_PARAMETER
是您要傳回的中繼資料欄位。例如storageClass
用於取得值區的儲存空間級別。使用 XML API 時,一次只能使用一個查詢參數。如需 XML API 支援的中繼資料欄位清單,請參閱GET
值區參考頁面。
回應類似下列範例:
<StorageClass>STANDARD</StorageClass>
。
後續步驟
- 參閱值區中繼資料總覽。
- 列出值區中的物件。
- 取得值區大小。
- 取得物件中繼資料。
- 變更值區的預設儲存空間級別。
歡迎試用
如果您未曾使用過 Google Cloud,歡迎建立帳戶,親自體驗實際使用 Cloud Storage 的成效。新客戶可以獲得價值 $300 美元的免費抵免額,可用於執行、測試及部署工作負載。
免費試用 Cloud Storage