チュートリアル:Azure Event Grid 経由で受信した Azure Service Bus のイベントに Azure Logic Apps を使用して応答する

[アーティクル]
10/26/2023

このチュートリアルでは、Azure Logic Apps を使用して、Azure Event Grid 経由で受信した Azure Service Bus イベントに応答する方法について説明します。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

Service Bus 名前空間を作成する

このチュートリアルの手順に従ってください。クイックスタート: Azure portal を使用して Service Bus トピックとそのサブスクリプションを作成する」で確認し、次のタスクを実行します:

Premium Service Bus 名前空間を作成します。
接続文字列を取得します。
Service Bus トピックを作成します。
トピックへのサブスクリプションを作成します。このチュートリアルで必要なサブスクリプションは 1 つだけです。そのため、サブスクリプション S2 および S3 を作成する必要はありません。

Service Bus トピックにメッセージを送信する

この手順では、サンプルアプリケーションを使用して、前の手順で作成した Service Bus トピックにメッセージを送信します。

GitHub azure-service-bus リポジトリをクローンするか、zip ファイルをダウンロードし、解凍してファイルを抽出します。
Visual Studio で \samples\DotNet\Azure.Messaging.ServiceBus\ServiceBusEventGridIntegrationV2 フォルダーに移動し、SBEventGridIntegration.sln ファイルを開きます。
ソリューションエクスプローラーウィンドウで、 [MessageSender] プロジェクトを展開し、 [Program.cs] を選択します。
<SERVICE BUS NAMESPACE - CONNECTION STRING> を Service Bus 名前空間への接続文字列で置き換え、<TOPIC NAME> をトピックの名前で置き換えます。
```
const string ServiceBusConnectionString = "<SERVICE BUS NAMESPACE - CONNECTION STRING>";
const string TopicName = "<TOPIC NAME>";
```
5 つのテストメッセージを Service Bus トピックに送信するプログラム (const int numberOfMessages = 5;) をビルドして実行します。

Logic Apps を使用してメッセージを受信する

この手順では、Service Bus イベントを Azure Event Grid 経由で受信する Azure ロジックアプリを作成します。

[+ リソースの作成] 、 [統合] 、 [ロジックアプリ] の順に選択します。
[ロジックアプリの作成] ページで、次の手順のようにします。
1. Azure サブスクリプションを選択します。
2. [リソースグループ] では [既存のものを使用] を選択し、以前に作成済みの、他のリソース (Azure 関数、Service Bus 名前空間など) に使用したリソースグループを選択します。
3. ロジックアプリの名前を入力します。
4. ロジックアプリの [リージョン] を選択します。
5. [プランの種類] で [従量課金] を選択します。
6. [確認および作成] を選択します。
7. [確認および作成] ページで [作成] を選択してロジックアプリを作成します。
[デプロイ完了] ページで、[リソースに移動] を選択し、[ロジックアプリ] ページに移動します。
[Logic Apps デザイナー] ページの [テンプレート] で、 [空のロジックアプリ] を選択します。

Event Grid 経由で Service Bus からメッセージを受信するステップを追加する

[ロジックアプリ] ページで、左側のメニューの [ロジックアプリデザイナー] を選択します。
右側のペインの [テンプレート] で [空のロジックアプリ] を選択します。
デザイナーで、次の手順を実行します。
1. Event Grid を検索します。
2. [リソースイベントが発生したとき - Azure Event Grid] を選択します。
[サインイン] を選択します。
[アカウントへのサインイン] ページで、Azure へのサインインに使用するアカウントを選択します。 1.
[When a resource event occurs](リソースイベントが発生したとき) ページで、次の手順を実行します。
1. Azure サブスクリプションを選択します。
2. [リソースの種類] で、 [Microsoft.ServiceBus.Namespaces] を選択します。
3. [リソース名] で、Service Bus 名前空間を選択します。
4. [新しいパラメーターの追加] を選択し、 [サフィックスフィルター] を選択してから、フォーカスをドロップダウンリストの外に移動します。
5. [サフィックスフィルター] で、Service Bus トピックのサブスクリプションの名前を入力します。
デザイナーで [+ 新しいステップ] を選択し、次の手順を実行します。
1. Service Bus を検索します。
2. 一覧から [Service Bus] を選択します。
3. [アクション] 一覧から [メッセージを取得します] を選択します。
4. [トピックサブスクリプションからメッセージを取得する (ピークロック)] を選択します。
5. 次のステップを実行します。
  1. 接続名を入力します。たとえば、「トピックサブスクリプションからのメッセージの取得」などです。
  2. [認証の種類] が [アクセスキー] に設定されていることを確認します。
  3. [接続文字列] で、接続文字列をコピーし、前に保存した Service Bus 名前空間に貼り付けます。
  4. ［作成］ を選択します
6. トピックとサブスクリプションを選択します。

受信したメッセージを処理して完了するステップを追加する

このステップでは、受信したメッセージをメールで送信し、メッセージを完了するステップを追加します。実際のシナリオでは、メッセージを完了する前にロジックアプリでメッセージを処理します。

foreach ループを追加する

[+ New step (+ 新しいステップ)] を選択します。
[コントロール] を選択して選択します。
[アクション] の一覧で [For each] を選択します。
[以前の手順から出力を選択] (必要に応じてテキストボックス内をクリック)では、 [Get messages from a topic subscription (peek-lock)](トピックサブスクリプションからメッセージを取得 (peek-lock)) の下の [本文] を選択します。

メッセージ本文を含む電子メールを送信するステップを For each ループ内に追加する

For each ループ内で、 [アクションの追加] を選択します。
[コネクタとアクションを検索する] ボックスで、「Office 365」と入力します。
検索結果で、「Office 365 Outlook」を選択します。
アクションの一覧で、 [メールの送信 (V2)] を選択します。
[サインイン] を選択し、手順に従って Office 365 Outlook への接続を作成します。
[メールの送信 (V2)] ウィンドウで、次の手順に従います。
[本文] のテキストボックス内を選択し、次の手順に従います。
1. [宛先] にはメールアドレスを入力します。
2. [件名] には、「Message received from Service Bus topic's subscription」と入力します。
3. [式] に切り替えます。
4. 次の式を入力します。
```
base64ToString(items('For_each')?['ContentData'])
```
5. [OK] を選択します。

For each ループに別のアクションを追加してメッセージを完了する

For each ループ内で、 [アクションの追加] を選択します。
1. [最近使った項目] 一覧から [Service Bus] を選択します。
2. アクションの一覧から [トピックサブスクリプション内のメッセージを完了する] を選択します。
3. Service Bus トピックを選択します。
4. トピックに対するサブスクリプションを選択します。
5. [メッセージのロックトークン] で、 [動的なコンテンツ] から [ロックトークン] を選択します。
Logic Apps デザイナーのツールバーの [保存] を選択して、ロジックアプリを保存します。

アプリをテストする

まだテストメッセージをトピックに送信していない場合は、「Service Bus トピックにメッセージを送信する」セクションの手順に従って、トピックにメッセージを送信します。
ロジックアプリの [概要] ページに切り替えてから、一番下のペインで [実行の履歴] タブに切り替えます。トピックに送信されたロジックアプリの実行のメッセージが表示されます。ロジックアプリの実行が確認できるまでに数分かかる場合があります。ツールバーの [Refresh](最新の情報に更新) を選択して、ページを最新の情報に更新してください。
ロジックアプリの実行を選択して詳細を確認します。 for ループで 5 つのメッセージが処理されていることに注目してください。
ロジックアプリによって受信された各メッセージの電子メールを受け取ります。

トラブルシューティング

しばらく待って最新の情報に更新しても呼び出しが表示されない場合は、次の手順に従います。

メッセージが Service Bus トピックに到達したことを確認します。 [Service Bus トピック] ページの受信メッセージカウンターに注目してください。この場合、MessageSender アプリケーションを 1 回実行したので、5 件のメッセージが表示されています。
Service Bus サブスクリプションにアクティブなメッセージがないことを確認します。このページにイベントが 1 つも表示されない場合、 [Service Bus Subscription](Service Bus サブスクリプション) ページに [アクティブなメッセージ数] が表示されていないことを確認してください。このカウンターの数値がゼロより大きい場合は、なんらかの理由により、サブスクリプションのメッセージがハンドラー関数 (イベントサブスクリプションハンドラー) に転送されていません。イベントサブスクリプションが適切に設定されていることを確認してください。
また、Service Bus 名前空間の [イベント] ページに配信済みイベントが表示されます。
イベントが配信されたことは、 [イベントサブスクリプション] ページでも確認できます。このページには、 [イベント] ページでイベントサブスクリプションを選択することによってアクセスできます。