本文說明如何列出 Pub/Sub 主題。如要列出主題,您可以使用 Google Cloud 控制台、gcloud CLI、用戶端程式庫或 Pub/Sub API。
事前準備
必要角色和權限
如要取得列出主題及管理主題所需的權限,請要求管理員為您的主題或專案授予 Pub/Sub 編輯者(roles/pubsub.editor
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色包含列出主題和管理主題所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要列出主題及管理主題,您必須具備下列權限:
-
建立主題:
pubsub.topics.create
-
刪除主題:
pubsub.topics.delete
-
將訂閱項目從主題卸離:
pubsub.topics.detachSubscription
-
取得主題:
pubsub.topics.get
-
列出主題:
pubsub.topics.list
-
發布至主題:
pubsub.topics.publish
-
更新主題:
pubsub.topics.update
-
取得主題的身分與存取權管理政策:
pubsub.topics.getIamPolicy
-
設定主題的 IAM 政策:
pubsub.topics.setIamPolicy
您可以在專案層級和個別資源層級設定存取權控管。您可以在一個專案中建立訂閱項目,然後將其附加至位於其他專案的主題。請確認您具備每個專案的必要權限。
列出主題
控制台
在 Google Cloud 控制台中,前往 Pub/Sub 的「Topics」(主題)頁面。
「主題」頁面會列出所有可用的主題。
根據預設,控制台會傳回 50 個主題。您可以使用「每頁列數」下拉式切換按鈕,將這個值調高至最多 200 個主題。只有在專案中的主題超過 20 個時,控制台中才會顯示這個切換鈕。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
如要列出主題,請使用
gcloud pubsub topics list
指令:gcloud pubsub topics list
根據預設,每個查詢會傳回最多 100 個結果。您可以使用 page size 參數指定最多 1,000 個的替代值。例如,使用 Google Cloud CLI 時,請指定 --page-size=1000
。
REST
如要列出主題,請使用 projects.topics.list
方法:
要求:
要求必須透過 Authorization
標頭中的存取權權杖進行驗證。如要取得目前應用程式預設憑證的存取權杖:gcloud auth application-default print-access-token
。
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics Authorization: Bearer ACCESS_TOKEN
其中:
回應:
{ "topics": [ { "name": "projects/PROJECT_ID/topics/mytopic1", ... }, { "name": "projects/PROJECT_ID/topics/mytopic2", ... } ] }
C++
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 C++。詳情請參閱 Pub/Sub C++ API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
C#
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 C#。詳情請參閱 Pub/Sub C# API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Go。詳情請參閱 Pub/Sub Go API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Java。詳情請參閱 Pub/Sub Java API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
Node.js
PHP
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 PHP。詳情請參閱 Pub/Sub PHP API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Python。詳情請參閱 Pub/Sub Python API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Ruby。詳情請參閱 Pub/Sub Ruby API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。