Azure Functions で Event Grid トリガーとバインドを使用する方法

Azure Functions には、トリガーとバインドを使用した Azure Event Grid との組み込みの統合が用意されています。 この記事では、Event Grid トリガーとバインドを構成し、ローカルで評価する方法について示します。 Event Grid トリガーと出力バインドの定義と例の詳細については、次のいずれかの参照記事をご覧ください。

• Azure Event Grid バインドの概要
• Azure Functions の Azure Event Grid トリガー
• Azure Functions の Azure Event Grid 出力バインディング

イベント サブスクリプションの作成

Event Grid HTTP 要求の受信を開始するには、Event Grid によって発生したイベントのサブスクリプションが必要です。 イベント サブスクリプションでは、関数を呼び出すエンドポイントの URL を指定します。 Azure portal で関数の [統合] タブからイベント サブスクリプションを作成すると、URL が提供されます。 イベント サブスクリプションをプログラムで作成する場合、または Event Grid からイベント サブスクリプションを作成する場合は、エンドポイントを指定する必要があります。 エンドポイントの URL にはシステム キーが含まれており、これは Functions 管理者 REST API から取得する必要があります。

Webhook エンドポイント URL を取得する

Event Grid でトリガーされる関数の URL エンドポイントは、Functions ランタイムのバージョンによって異なります。 バージョン固有の URL パターンの例を次に示します。

https://{functionappname}.azurewebsites.net/runtime/webhooks/eventgrid?functionName={functionname}&code={systemkey}

https://{functionappname}.azurewebsites.net/admin/extensions/EventGridExtensionConfig?functionName={functionname}&code={systemkey}

システム キーを取得する

作成した URL エンドポイントには、システム キーの値が含まれます。 システム キーは、Event Grid Webhook に固有の承認キーで、Event Grid トリガーのエンドポイント URL への要求に含める必要があります。 次のセクションでは、システム キーを取得する方法について説明します。

ポータルの [関数]>[アプリ キー] から関数アプリのマスター キーを取得することもできます。

詳細については、「Azure Functions でのアクセス キーの使用」を参照してください。

関数アプリからシステム キーを取得するには、次の管理者 API (HTTP GET) を使用します。

http://{functionappname}.azurewebsites.net/admin/host/systemkeys/eventgrid_extension?code={masterkey}

http://{functionappname}.azurewebsites.net/admin/host/systemkeys/eventgridextensionconfig_extension?code={masterkey}

この REST API は管理者 API なので、お使いの関数アプリのマスター キーが必要です。 システム キー (Event Grid トリガー関数を呼び出す場合) とマスター キー (関数アプリで管理タスクを実行する場合) を混同しないでください。 Event Grid トピックをサブスクライブするときは、システム キーを使います。

システム キーを提供する応答の例を次に示します。

{
  "name": "eventgridextensionconfig_extension",
  "value": "{the system key for the function}",
  "links": [
    {
      "rel": "self",
      "href": "{the URL for the function, without the system key}"
    }
  ]
}

サブスクリプションを作成する

イベント サブスクリプションは、Azure portalから、または Azure CLI を使用して作成できます。

az eventgrid resource event-subscription create -g myResourceGroup \
    --provider-namespace Microsoft.Storage --resource-type storageAccounts \
    --resource-name myblobstorage12345 --name myFuncSub \
    --included-event-types Microsoft.Storage.BlobCreated \
    --subject-begins-with /blobServices/default/containers/images/blobs/ \
    --endpoint https://mystoragetriggeredfunction.azurewebsites.net/runtime/webhooks/eventgrid?functionName=imageresizefunc&code=<key>

サブスクリプションを作成する方法について詳しくは、BLOB ストレージのクイック スタートまたは他の Event Grid クイック スタートのページをご覧ください。

ビューアー Web アプリでのローカル テスト

Event Grid トリガーをローカルにテストするには、クラウド内の送信元からローカル コンピューターに配信された Event Grid の HTTP 要求を取得する必要があります。 これを行う方法の 1 つは、オンラインで要求をキャプチャし、ローカル コンピューター上でそれを手動で再送信することです。

1. イベント メッセージをキャプチャするビューアー Web アプリを作成します。
2. ビューアー アプリにイベントを送信する Event Grid サブスクリプションを作成します。
3. 要求を生成し、ビューアー アプリから要求本文をコピーします。
4. Event Grid トリガー関数の localhost URL に要求を手動で投稿します。

HTTP ポスト要求を送信するには、次のいずれかの HTTP テスト ツールが必要です。

• Visual Studio Code を Visual Studio Marketplace からの拡張機能と一緒に使用する
• PowerShell Invoke-RestMethod
• Microsoft Edge - ネットワーク コンソール ツール
• Bruno
• curl

テストが完了したら、エンドポイントを更新することで、同じサブスクリプションを運用環境に使うことができます。 az eventgrid event-subscription update Azure CLI コマンドを使用します。

ビューアー Web アプリを作成する

イベント メッセージのキャプチャを簡素化するために、イベント メッセージを表示する構築済みの Web アプリをデプロイすることができます。 デプロイされたソリューションには、App Service プラン、App Service Web アプリ、および GitHub からのソース コードが含まれています。

[Deploy to Azure](Azure にデプロイ) を選択して、ソリューションをサブスクリプションにデプロイします。 Azure portal で、パラメーターの値を指定します。

デプロイが完了するまでに数分かかる場合があります。 デプロイが成功した後で、Web アプリを表示して、実行されていることを確認します。 Web ブラウザーで https://<your-site-name>.azurewebsites.net にアクセスします

サイトは表示されますが、イベントはまだ送信されていません。

Event Grid のサブスクリプションを作成する

テストする種類の Event Grid サブスクリプションを作成し、イベント通知のエンドポイントとして Web アプリからの URL を指定します。 Web アプリのエンドポイントには、サフィックス /api/updates/ が含まれている必要があります。 したがって、完全な URL は https://<your-site-name>.azurewebsites.net/api/updates となります。

Azure Portal を使ってサブスクリプションを作成する方法については、Event Grid のドキュメントの「カスタム イベントの作成 - Azure Portal」を参照してください。

要求を生成する

Web アプリ エンドポイントへの HTTP トラフィックを生成するイベントをトリガーします。 たとえば、BLOB ストレージ サブスクリプションを作成した場合は、BLOB をアップロードまたは削除します。 要求が Web アプリに表示されたら、要求本文をコピーします。

最初に、サブスクリプション検証要求を受信します。検証要求はすべて無視し、イベント要求をコピーします。

要求を手動で投稿する

Event Grid 関数をローカルで実行します。 Content-Type および aeg-event-type のヘッダーは手動で設定する必要がありますが、他のすべての値は既定値のままにすることができます。

HTTP テスト ツールを使用して HTTP POST 要求を作成する:

• Content-Type: application/json ヘッダーを設定します。

• aeg-event-type: Notification ヘッダーを設定します。

• 要求本文に RequestBin のデータを貼り付けます。

• Event Grid トリガーを手動で開始する HTTP POST 要求をエンドポイントに送信します。

  • v2.x+
  • v1.x

  http://localhost:7071/runtime/webhooks/eventgrid?functionName={FUNCTION_NAME}
  

functionName パラメーターには、FunctionName 属性で指定されている名前を指定する必要があります。

Event Grid トリガー関数が実行されて、次の例のようなログが表示されます。

次のステップ

Event Grid と Functions の詳細については、次の記事をご覧ください。

• Azure Functions における Azure Event Grid のバインド
• チュートリアル:Event Grid を使用して、アップロードされたイメージのサイズ変更を自動化する