本頁說明如何取得 Cloud Storage buckets 的中繼資料,但不包括 IAM 政策和 ACL。
如要瞭解如何取得值區的 IAM 政策,請參閱「查看值區的 IAM 政策」。
必要的角色
如要取得 Cloud Storage 值區中繼資料的必要權限,請要求管理員授予您該值區的 Storage 管理員 (roles/storage.admin
) 角色。
這個角色包含取得 Bucket 中繼資料所需的權限。 如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.buckets.get
storage.buckets.list
- 如果您打算使用 Trusted Cloud 控制台執行這個頁面的工作,才需要這項權限。
如需如何授予值區角色的操作說明,請參閱「搭配值區使用 IAM」。
顯示值區的中繼資料
控制台
- 在 Trusted Cloud 控制台,前往「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
透過GET
Bucket 要求呼叫 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 支援的中繼資料欄位清單,請參閱GET
Bucket 參考頁面。
回應類似下列範例:
<StorageClass>STANDARD</StorageClass>
。