サブスクリプション SMT を削除する

このドキュメントでは、既存の Pub/Sub サブスクリプションから単一メッセージ変換（SMT）を削除する方法について説明します。

サブスクリプション SMT を削除するには、 Google Cloud コンソール、Google Cloud CLI、クライアント ライブラリ、または Pub/Sub API を使用します。

必要なロールと権限

サブスクリプション SMT の削除に必要な権限を取得するには、管理者にプロジェクトに対する Pub/Sub 編集者 （roles/pubsub.editor）IAM ロールを付与するよう依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、サブスクリプション SMT の削除に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

サブスクリプション SMT を削除するには、次の権限が必要です。

  • サブスクリプションに対するサブスクリプションの削除権限を付与します。 pubsub.subscriptions.delete
  • プロジェクトに対するビューのサブスクリプション権限を付与します。この権限は、 Google Cloud コンソールを使用している場合にのみ必要です。 pubsub.subscriptions.view

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

アクセス制御は、プロジェクト レベルと個々のリソースレベルで構成できます。

サブスクリプション SMT を削除する

サブスクリプション SMT を削除する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、Pub/Sub の [サブスクリプション ] ページに移動します。

    サブスクリプションに移動

  2. SMT を削除するサブスクリプションをクリックします。

  3. サブスクリプションの詳細ページで、[編集] をクリックします。

    [変換] タブには、サブスクリプションに接続されているすべての SMT が一覧表示されます。

  4. 削除する SMT の削除ボタンをクリックします。

  5. [更新] をクリックします。

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. このコマンドは、指定されたサブスクリプションに関連付けられているすべての SMT を削除します。

    --clear-message-transforms フラグを指定して gcloud pubsub subscriptions update コマンドを実行します。

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

    次のように置き換えます。

    • SUBSCRIPTION_ID: 更新するサブスクリプションの ID または名前。

    代わりに単一の SMT を削除するには、サブスクリプション SMT を更新するを参照し、削除する SMT を除外する新しい message-transforms-file を作成します。

次のステップ