Event Hub en tant que gestionnaire d’événements pour des événements Azure Event Grid

Article
09/19/2023

Un gestionnaire d’événements désigne l’endroit où l’événement est envoyé. Le gestionnaire effectue une action pour traiter l’événement. Plusieurs services Azure sont automatiquement configurés pour gérer des événements, et Azure Event Hubs est l’un d’eux.

Utilisez Event Hubs si votre solution reçoit des événements d’Event Grid plus vite qu’elle ne peut les traiter. Une fois que les événements se trouvent dans un concentrateur d’événements, votre application peut traiter ces événements selon sa propre planification. Vous pouvez mettre à l’échelle votre système de traitement des événements de façon à gérer les événements entrants.

Tutoriels

Regardez les exemples suivants :

Intitulé	Description
Démarrage rapide : Acheminer des événements personnalisés vers Azure Event Hubs avec Azure CLI	Envoie un événement personnalisé à un hub d’événements afin qu’il soit traité par une application.
Modèle Resource Manager : Créer une rubrique personnalisée Event Grid et envoyer des événements à un concentrateur d’événements	Modèle Resource Manager qui crée un abonnement pour une rubrique personnalisée. Il envoie les événements vers Azure Event Hubs.

En-têtes de message

Les propriétés que vous recevez dans les en-têtes de message sont les suivantes :

Nom de la propriété	Description
aeg-subscription-name	Nom de l’abonnement aux événements.
aeg-delivery-count	Nombre de tentatives effectuées pour l’événement.
aeg-event-type	Type de l’événement. Ce peut être l’une des valeurs suivantes : SubscriptionValidation Notification SubscriptionDeletion
aeg-metadata-version	Version de métadonnées de l’événement. Pour un schéma d’événement Event Grid, cette propriété représente la version des métadonnées et, pour un schéma d’événements cloud, elle représente la version des spécifications.
aeg-data-version	Version de données de l’événement. Pour un schéma d’événement Event Grid, cette propriété représente la version des données et, pour un schéma d’événements cloud, elle ne s’applique pas.
aeg-output-event-id	ID de l’événement Event Grid.

Exemples REST (pour PUT)

Event Hub

{
  "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"
  }
}

Event Hub : remise avec une identité managée

{
  "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"
  }
}

Propriétés de remise

Les abonnements aux événements vous permettent de définir des en-têtes HTTP qui sont inclus dans les événements remis. Cette fonctionnalité vous permet de définir des en-têtes personnalisés dont la destination a besoin. Vous pouvez définir des en-têtes personnalisés sur les événements remis à Azure Event Hubs.

Si vous devez publier des événements dans une partition spécifique au sein d’un Event Hub, définissez une propriété PartitionKey sur votre abonnement aux événements pour spécifier la clé de partition qui identifie la partition Event Hub cible.

Nom de l’en-tête	Type d’en-tête
`PartitionKey`	Statique ou dynamique

Pour plus d'informations, consultez Propriétés de remise personnalisées.

Étapes suivantes

Pour obtenir la liste des gestionnaires d’événements pris en charge, consultez l’article Gestionnaires d’événements.

Partager via