在 Pub/Sub 中,主題是具名資源,代表訊息來源。您必須先建立主題,然後才能發布或訂閱該主題。Pub/Sub 支援兩種主題:標準主題和匯入主題。
本文說明如何建立 Pub/Sub 標準主題。如要進一步瞭解匯入主題和如何建立匯入主題,請參閱「關於匯入主題」。
如要建立主題,可以使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API。
事前準備
瞭解 Pub/Sub 服務和相關術語。
瞭解發布程序。
必要角色和權限
如要取得建立主題所需的權限,請要求管理員授予您專案的 Pub/Sub 編輯者(roles/pubsub.editor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色具備建立主題所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
如要建立主題,您必須具備下列權限:
-
授予這項權限,即可在專案中建立主題:
pubsub.topics.create
您可以在專案層級和個別資源層級設定存取控管。您可以在一個專案中建立訂閱項目,並將其附加至位於其他專案的主題。請確認您具備每個專案的必要權限。
主題的屬性
建立或更新主題時,必須指定主題的屬性。
新增預設訂閱項目
為 Pub/Sub 主題新增預設訂閱項目。 主題建立後,您可以為該主題建立其他訂閱項目。 預設訂閱項目具有下列屬性:
- 「
-sub」的訂閱 ID - 提取傳送類型
- 訊息保留時間為七天
- 持續處於非活躍狀態達 31 天即失效
- 確認期限為 10 秒
- 立即重試政策
使用結構定義
結構定義是訊息資料欄位必須遵循的格式。結構定義是發布者和訂閱者之間的合約,Pub/Sub 會強制執行。主題結構定義有助於標準化訊息類型和權限,讓機構中的不同團隊都能使用這些訊息。Pub/Sub 會為訊息類型和權限建立中央授權單位。如要使用結構定義建立主題,請參閱結構定義總覽。
啟用擷取功能
啟用這項屬性後,您就能將外部來源的串流資料擷取至主題,以便使用 Google Cloud的功能。如要建立匯入主題以供擷取,請參閱下列內容: