サブスクリプション 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. コンソールで、Pub/Sub の [Subscriptions ] ページに移動します。 Google Cloud

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

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

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

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

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

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

gcloud

  1. コンソールで Cloud Shell をアクティブにします。 Google Cloud

    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 を更新し、削除する SMT を除外する新しい message-transforms-file を作成します。

次のステップ