Partager via

Rubriques personnalisées dans Azure Event Grid

  • Article

Une rubrique Event Grid fournit un point de terminaison où la source envoie des événements. L’éditeur crée une rubrique Event Grid et décide si une source d’événements a besoin d’une ou plusieurs rubriques. Une rubrique est utilisée pour une collection d’événements connexes. Pour répondre à certains types d’événements, les abonnés décident des rubriques auxquelles ils souhaitent s’abonner.

Les rubriques personnalisées sont des rubriques tierces et applicatives. Quand vous créez une rubrique personnalisée ou que l’accès à une rubrique personnalisée vous est octroyé, celle-ci est visible dans votre abonnement. Les rubriques personnalisées prennent en charge la livraison push. Consultez quand utiliser la livraison de type pull ou push pour vous aider à déterminer si la livraison push est la bonne approche en fonction de vos besoins.

Lorsque vous concevez votre application, vous pouvez choisir le nombre de rubriques à créer. Pour les solutions volumineuses, créez une rubrique personnalisée pour chaque catégorie d’événements associés. Par exemple, considérez une application qui gère les comptes d’utilisateur et une autre application sur les commandes des clients. Il est peu probable que tous les abonnés aux événements souhaitent des événements des deux applications. Pour séparer les problèmes, créez deux rubriques : une pour chaque application. Laissez les gestionnaires d’événements s’abonner à la rubrique en fonction de leurs besoins. Pour les solutions de petite taille, vous pouvez à la place envoyer tous les événements à une seule rubrique. Les abonnés à des événements peuvent filtrer les types d’événements qu’ils souhaitent.

Schéma d’événement

Les rubriques personnalisées prennent en charge deux types de schémas d’événements : les événements cloud et le schéma Event Grid.

Schéma d’événement cloud

En plus de son schéma d’événement par défaut, Azure Event Grid prend en charge en mode natif les événements dans l’implémentation JSON de CloudEvents v1.0 et la liaison de protocole HTTP. CloudEvents est une spécification ouverte qui décrit les données d’événement.

CloudEvents simplifie l’interopérabilité en proposant un schéma d’événement commun pour la publication et la consommation des événements. Ce schéma permet des outils uniformes, des méthodes standard de routage et de gestion des événements et un moyen courant de désérialiser vos événements. Avec un schéma commun, vous pouvez plus facilement intégrer le travail entre plusieurs plateformes.

Notes

Pour plus d’informations, consultez Schéma d’événement Cloud.

Schéma d’événement Event Grid

Quand vous utilisez le schéma d’événement Event Grid, vous pouvez spécifier des propriétés spécifiques à votre application dans l’objet data .

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

Notes

Pour plus d’informations, consultez Schéma d’événement Event Grid.

Les sections suivantes contiennent des liens vers des tutoriels permettant de créer des rubriques personnalisées à l’aide du portail Azure, de l’interface CLI, de PowerShell et de modèles Azure Resource Manager (ARM).

Tutoriels pour le portail Azure

Intitulé Description
Démarrage rapide : Créer et acheminer des événements personnalisés avec le portail Azure Montre comment utiliser le portail pour envoyer des événements personnalisés.
Démarrage rapide : Acheminer des événements personnalisés vers le stockage File d’attente Azure Décrit comment envoyer des événements personnalisés à un stockage File d’attente.
Guide pratique pour publier dans une rubrique personnalisée Montre comment publier un événement dans une rubrique personnalisée.

Tutoriels pour Azure CLI

Intitulé Description
Démarrage rapide : Créer et acheminer des événements personnalisés avec Azure CLI Montre comment utiliser Azure CLI pour envoyer des événements personnalisés.
Azure CLI : Créer une rubrique personnalisée Event Grid Exemple de script qui crée une rubrique personnalisée. Le script récupère le point de terminaison et une clé.
Azure CLI : S’abonner aux événements d’une rubrique personnalisée Exemple de script qui crée un abonnement pour une rubrique personnalisée. Il envoie les événements vers un webhook.

Tutoriels pour Azure PowerShell

Intitulé Description
Démarrage rapide : Créer et acheminer des événements personnalisés avec PowerShell Montre comment utiliser Azure PowerShell pour envoyer des événements personnalisés.
PowerShell : Créer une rubrique personnalisée Event Grid Exemple de script qui crée une rubrique personnalisée. Le script récupère le point de terminaison et une clé.
PowerShell : S’abonner aux événements d’une rubrique personnalisée Exemple de script qui crée un abonnement pour une rubrique personnalisée. Il envoie les événements vers un webhook.

Tutoriels pour les modèles ARM

Intitulé Description
Modèle Resource Manager : rubrique personnalisée et point de terminaison webhook Modèle Resource Manager qui crée une rubrique personnalisée et un abonnement pour celle-ci. Il envoie les événements vers un webhook.
Modèle Resource Manager : rubrique personnalisée et point de terminaison Event Hubs Modèle Resource Manager qui crée un abonnement pour une rubrique personnalisée. Il envoie les événements vers Azure Event Hubs.

Notes

Azure Digital Twins peut acheminer les notifications d’événements vers des rubriques personnalisées que vous créez avec Event Grid. Pour plus d’informations, consultez Points de terminaison et routes d’événement dans la documentation Azure Digital Twins.

Étapes suivantes

Voir les articles suivants :