本頁說明如何取得 Cloud Storage buckets 的中繼資料,但不包括 IAM 政策和 ACL。
如要瞭解如何取得值區的 IAM 政策,請參閱「查看值區的 IAM 政策」。
必要的角色
如要取得 Cloud Storage 值區中繼資料的必要權限,請要求管理員授予您該值區的 Storage 管理員 (roles/storage.admin) 角色。
這個角色包含取得 Bucket 中繼資料所需的權限。 如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.buckets.getstorage.buckets.list- 如果您打算使用 Cloud de Confiance 控制台執行這個頁面的工作,才需要這項權限。
如需授予值區角色的操作說明,請參閱「設定及管理值區的身分與存取權管理政策」。
顯示值區的中繼資料
控制台
- 在 Cloud de Confiance 控制台,前往「Cloud Storage bucket」頁面。
在值區清單中,按一下要查看中繼資料的值區名稱。
按一下「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,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Terraform
您可以使用 Terraform 資源查看 bucket 的中繼資料。
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization標頭產生存取權杖。使用
cURL透過GETBucket 要求呼叫 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
其中
BUCKET_NAME是相關值區的名稱。例如:my-bucket。如有需要,您可以使用
fields查詢字串參數,縮小中繼資料結果範圍。例如:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
其中
FIELD#是要納入結果的 bucket 屬性。例如projectNumber和storageClass。
回應類似下列範例:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
XML API
安裝並初始化 gcloud CLI,以便為
Authorization標頭產生存取權杖。使用
cURL透過GET值區要求呼叫 XML API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?QUERY_PARAMETER"
其中:
BUCKET_NAME是相關值區的名稱。例如:my-bucket。QUERY_PARAMETER是要傳回的中繼資料欄位。例如:storageClass用於取得值區的儲存空間級別。XML API 一次只能使用一個查詢參數。如需 XML API 支援的中繼資料欄位清單,請參閱GETBucket 參考頁面。
回應類似下列範例:
<StorageClass>STANDARD</StorageClass>。