Azure Event Grid イベントに対するイベント ハンドラーとしてのイベント ハブ

  • [アーティクル]

イベント ハンドラーは、イベントの送信先となる場所です。 ハンドラーでは、イベントを処理するアクションが実行されます。 一部の Azure サービスは、イベントを処理するように自動的に構成されます。Azure Event Hubs はその 1 つです。

Event Grid からのイベントが速すぎて、ソリューションで処理しきれない場合は、Event Hubs を使用します。 イベントがイベント ハブに格納されたら、アプリケーションでは独自のスケジュールでイベント ハブからイベントを取得して処理できます。 イベント処理をスケーリングして、受信イベントを処理することができます。

チュートリアル

次の例を参照してください。

タイトル 説明
クイック スタート: Azure CLI を使用してカスタム イベントを Azure Event Hubs にルーティングする アプリケーションで処理するためにカスタム イベントをイベント ハブに送信します。
Resource Manager テンプレート:Event Grid カスタム トピックを作成し、イベント ハブにイベントを送信する カスタム トピックのサブスクリプションを作成する Resource Manager テンプレート。 Azure Event Hubs にイベントを送信します。

メッセージ ヘッダー

これらは、メッセージ ヘッダーで受け取るプロパティです。

プロパティ名 説明
aeg-subscription-name イベント サブスクリプションの名前。
aeg-delivery-count イベントに対して行われた試行の回数。
aeg-event-type

イベントの種類。

次のいずれかの値を指定できます。

  • SubscriptionValidation
  • Notification
  • SubscriptionDeletion
aeg-metadata-version

イベントのメタデータ バージョン。

Event Grid のイベント スキーマの場合、このプロパティはメタデータのバージョンを表し、クラウド イベント スキーマの場合は仕様のバージョンを表します。

aeg-data-version

イベントのデータ バージョン。

Event Grid のイベント スキーマの場合、このプロパティはデータのバージョンを表し、クラウド イベント スキーマの場合は適用されません。
aeg-output-event-id Event Grid イベントの ID。

REST の例 (PUT 用)

イベント ハブ

{
  "properties": 
  {
    "destination": 
    {
      "endpointType": "EventHub",
      "properties": 
      {
        "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

イベント ハブ - マネージド ID を使用した配信

{
  "properties": {
    "deliveryWithResourceIdentity": 
    {
      "identity": 
      {
        "type": "SystemAssigned"
      },
      "destination": 
      {
        "endpointType": "EventHub",
        "properties": 
        {
          "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
        }
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

配信プロパティ

イベント サブスクリプションを使用すると、配信されたイベントに含まれる HTTP ヘッダーを設定できます。 この機能を使用すると、宛先に必要なカスタム ヘッダーを設定できます。 Azure Event Hubs に配信されるイベントにカスタム ヘッダーを設定できます。

イベントをイベント ハブ内の特定のパーティションに発行する必要がある場合は、イベント サブスクリプションに PartitionKey プロパティを設定して、対象のイベント ハブ パーティションを識別するパーティション キーを指定します。

ヘッダー名 ヘッダーの種類
PartitionKey 静的または動的

詳細については、「カスタム配信のプロパティ」を参照してください。

次のステップ

サポートされているイベント ハンドラーの一覧については、「イベント ハンドラー」を参照してください。