建立提取訂閱項目

本文說明如何建立提取訂閱項目。您可以使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API 建立提取訂閱項目。

事前準備

必要角色和權限

如要取得建立提取訂閱項目所需的權限，請要求管理員授予您專案的 Pub/Sub 編輯者 (roles/pubsub.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備建立提取訂閱項目所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要建立提取訂閱項目，必須具備下列權限：

  • pubsub.subscriptions.create 專案
  • pubsub.topics.attachSubscription 這個主題

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

跨專案訂閱

如果您在一個專案中建立訂閱項目，訂閱另一個專案中的主題，則必須在建立訂閱項目的專案中具備 pubsub.subscriptions.create 權限，並在主題中具備 pubsub.topics.attachSubscription 權限。

建立提取訂閱項目

控制台

如要建立提取訂閱項目，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Subscriptions」(訂閱項目) 頁面。

    前往「訂閱項目」頁面

  2. 按一下「Create Subscription」 (建立訂閱項目)。

  3. 在「Subscription ID」(訂閱 ID) 欄位中輸入名稱。

    如要瞭解如何命名訂閱項目，請參閱「主題或訂閱項目命名規範」。

  4. 在「Pub/Sub topic」(Pub/Sub 主題) 清單中，選取訂閱項目要讀取的主題。

  5. 在「傳送類型」中，選取「提取」。

  6. 選用：在「轉換」部分，新增一或多個單一訊息轉換 (SMT)。詳情請參閱「使用 SMT 建立訂閱項目」。

  7. 選用：在「篩選器」欄位中輸入篩選運算式，篩選訂閱項目中的訊息。詳情請參閱「篩選訂閱項目中的訊息」。

  8. 在「重試政策」部分，選取所需選項。詳情請參閱「訂閱重試政策」。

  9. 選用：啟用dead-letter 主題，接收無法傳送的訊息。

    1. 勾選「無效信件」核取方塊。

    2. 在「無效信件主題」清單中，選取或建立無效信件主題。

    3. 在「傳送嘗試次數上限」欄位中，輸入傳送嘗試次數上限。

  10. 選用：在「傳送屬性」部分，啟用或停用下列傳送選項：

  11. 選用步驟：在「Acknowledgement deadline」(確認期限) 部分，設定訂閱者處理及確認訊息的期限。詳情請參閱「使用租約管理功能延長確認時間」。

  12. 選用步驟：在「Lifetime options」(保留期限選項) 部分，設定訂閱方案保留訊息的時間長度。

    1. 在「訊息保留時間」部分，指定未確認訊息的保留時間。

    2. 如要保留已確認和未確認訊息，請選取「保留已確認訊息」核取方塊。

    詳情請參閱「設定訂閱項目的訊息保留時間」。