チュートリアル: カスタムトピックを使用して Azure Event Grid の MQTT メッセージを Azure Functions にルーティングする - Azure portal

[アーティクル]
03/19/2024

このチュートリアルでは、次の手順に従って、Event Grid のカスタムトピックを使用して、Azure Event Grid 名前空間で受信した MQTT メッセージを Azure 関数にルーティングする方法について学習します。

Azure サブスクリプションを持っていない場合は、無料試用版にサインアップできます。

Event Grid トリガーを使用して Azure 関数を作成する

Visual Studio Code を使用した Azure 関数の作成に関するページの手順に従いますが、HTTP トリガー を使用する代わりに、Azure Event Grid トリガーを使用します。次の例のようなコードが表示されます。

using System;
using Azure.Messaging;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public class MyEventGridTriggerFunc
    {
        private readonly ILogger<MyEventGridTriggerFunc> _logger;

        public MyEventGridTriggerFunc(ILogger<MyEventGridTriggerFunc> logger)
        {
            _logger = logger;
        }

        [Function(nameof(MyEventGridTriggerFunc))]
        public void Run([EventGridTrigger] CloudEvent cloudEvent)
        {
            _logger.LogInformation("Event type: {type}, Event subject: {subject}", cloudEvent.Type, cloudEvent.Subject);
        }
    }
}

この Azure 関数は、このチュートリアルの後半でトピックのサブスクリプションのイベントハンドラーとして使用します。

Note

すべてのリソースを同じリージョンに作成します。
このチュートリアルは、.NET 8.0 (分離) ランタイムスタックを使用する Azure 関数でテストされています。

Event Grid トピックを作成する (カスタムトピック)

Event Grid トピックを作成します。ポータルを使用したカスタムトピックの作成に関するページを参照してください。 Event Grid トピックを作成する場合、[詳細] タブの [イベントスキーマ]で、[クラウドイベントスキーマ v1.0] を選択します。

[トピックの作成] ウィザードの [詳細] ページを示すスクリーンショット。

Note

このチュートリアルのすべての場所でクラウドイベントスキーマを使用します。

関数を使用してトピックにサブスクリプションを追加する

この手順では、前に作成した Azure 関数を使用して、Event Grid トピックのサブスクリプションを作成します。

[Event Grid トピック] ページの左側のナビゲーションバーで [サブスクリプション] を選択します。
[イベントサブスクリプションの作成] ページで、次の手順を行います。
1. イベントサブスクリプションの名前を入力します。
2. [イベントスキーマ] で、[クラウドイベントスキーマ v1.0] を選択します。
3. [エンドポイントの種類] で、[Azure Functions] を選択します。
4. [エンドポイントの構成] を選択します。
[Azure 関数の選択] ページで、次の手順を行います。
1. [サブスクリプション] で、自分の Azure サブスクリプションを選択します。
2. [リソースグループ] で、Azure 関数を含むリソースグループを選択します。
3. [関数アプリ] で、関数を含む関数アプリを選択します。
4. [スロット] で、[運用] を選択します。
5. [関数] で、お使いの Azure 関数を選択します。
6. 次に、ページの下部にある [選択を確認] を選択します。
[イベントサブスクリプションの作成] ページで、 [作成] を選択します。
[イベントサブスクリプション] ページに、作成したサブスクリプションが表示されます。

名前空間、クライアント、トピック空間、アクセス許可バインドを作成する

クイックスタート: Azure portal で Event Grid 名前空間を使用した MQTT メッセージの発行とサブスクライブに関するページの手順に従って、次の操作を行います。

Event Grid 名前空間を作成します。
2 つのクライアントを作成します。
トピック空間を作成します。
パブリッシャーとサブスクライバーのアクセス許可バインドを作成します。
MQTTX アプリを使用してテストし、クライアントがメッセージを送受信できることを確認します。

名前空間のマネージド ID を有効にする

このセクションでは、Event Grid 名前空間のシステム割り当てマネージド ID を有効にします。次に、メッセージをカスタムトピックにルーティングできるように、先ほど作成した Event Grid カスタムトピックへの送信アクセス許可を ID に付与します。そのためには、マネージド ID をカスタムトピックの Event Grid データ送信者のロールに追加します。

[Event Grid 名前空間] ページの左側のナビゲーションメニューで [ID] を選択します。
Event Grid カスタムトピックの [Event Grid トピック] に移動します。
左側のナビゲーションバーで [アクセスの制御] を選択します。
[アクセスの制御] ページで [追加] を選択し、[ロールの割り当ての追加] を選択します。
[ロールの割り当ての追加] ウィザードの [ロール] ページで、[Event Grid データ送信者] ロールを選択し、ページの下部にある [次へ] を選択します。
[ロール割り当ての追加] ウィザードの [メンバー] ページで、[マネージド ID] を選択し、[メンバーの選択] を選択します。
[マネージド ID の選択] ページで、次の手順を行います。
1. Azure サブスクリプションを選択します。
2. [マネージド ID] には、[Event Grid 名前空間] を選択します。
3. Event Grid 名前空間と同じ名前のマネージド ID を選択します。
4. ページの下部にある [選択] を選択します。
[ロールの割り当ての追加] ページで、ページの下部にある [次へ] を選択します。
[確認と割り当て] ページで設定を確認し、ページの下部にある [確認と割り当て] を選択します。