刪除訂閱項目 SMT

本文說明如何從現有的 Pub/Sub 訂閱項目刪除單一訊息轉換 (SMT)。

如要刪除訂閱項目 SMT，可以使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API。

必要角色和權限

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

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

所需權限

如要刪除訂閱項目 SMT，您必須具備下列權限：

  • 授予訂閱項目的刪除訂閱項目權限： pubsub.subscriptions.delete
  • 授予檢視專案訂閱項目的權限。只有在使用 Google Cloud 控制台時，才需要這項權限： pubsub.subscriptions.view

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

您可以在專案層級和個別資源層級設定存取權控管。

刪除訂閱 SMT

如要刪除訂閱 SMT，請按照下列步驟操作：

控制台

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

    前往「訂閱」頁面

  2. 按一下要刪除 SMT 的訂閱項目。

  3. 在訂閱詳細資料頁面中，按一下「編輯」。

    「轉換」分頁會列出附加至訂閱項目的所有 SMT。

  4. 按一下要刪除的 SMT 的刪除按鈕。

  5. 按一下「Update」。

gcloud

  1. 在 Google Cloud 控制台中啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 主控台底部會開啟一個 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。

  2. 這個指令會刪除與指定訂閱項目相關聯的所有 SMT。

    執行加上 --clear-message-transforms 旗標的 gcloud pubsub subscriptions update 指令：

    gcloud pubsub subscriptions update SUBSCRIPTION_ID \
    --clear-message-transforms

    更改下列內容：

    • SUBSCRIPTION_ID：要更新的訂閱項目 ID 或名稱。

    如要移除單一 SMT，請參閱「更新訂閱項目 SMT」，並建立新的 message-transforms-file，排除要刪除的 SMT。

後續步驟