Livraison push avec HTTP

  • Article

Cet article s’appuie sur Qu’est-ce que Azure Event Grid ? pour fournir des informations essentielles avant de commencer à utiliser la livraison par extraction (pull-and-push) d’Event Grid sur HTTP. Il couvre les concepts fondamentaux, les modèles de ressources et les modes de livraison de messages pris en charge. À la fin de ce document, vous trouverez des liens utiles vers des articles qui vous guideront dans l’utilisation d’Event Grid et d’autres articles contenant des informations conceptuelles détaillées.

Important

Ce document vous aide à démarrer avec les fonctionnalités Event Grid qui utilisent le protocole HTTP. Cet article convient aux utilisateurs qui ont besoin d’intégrer des applications dans le cloud. Si vous avez besoin de communiquer des données d’appareil IoT, consultez Vue d’ensemble de la prise en charge de MQTT dans Azure Event Grid.

Concepts principaux

CloudEvents

Event Grid est conforme à la spécification CloudEvents 1.0 standard ouverte de la CNCF à l’aide de la liaison de protocole HTTP au format JSON. Cela signifie que vos solutions publient et consomment des messages d’événements comme dans le format suivant :

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

Qu’est-ce qu’un événement ?

Un événement correspond à la plus petite quantité d’informations décrivant intégralement quelque chose qui s’est produit dans le système. Nous faisons souvent référence à un événement comme indiqué ci-dessus en tant qu’événement discret, car il représente un fait distinct et autonome sur un système qui fournit un aperçu qui peut être actionnable. Exemples : com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Notes

Nous utilisons indifféremment les termes événements discrets, événements cloud ou simplement événements pour faire référence aux messages qui informent sur un changement d’état système.

Pour plus d’informations sur les événements, consultez la terminologie Event Grid.

Un autre type d’événement

La communauté d’utilisateurs fait également référence aux événements de ce type de messages qui portent un point de données, tels qu’une seule lecture à partir d’un appareil ou un simple clic sur une page d’application web. Ce type d’événement est généralement analysé sur une fenêtre de temps ou une taille de flux d’événements pour dériver des insights et effectuer une action. Dans la documentation d’Event Grid, nous faisons référence à ce type d’événement comme point de données, données de streaming ou télémétrie. Il s’agit d’un type de données que MQTT d’Event Grid prend généralement en charge et Azure Event Hubs gère.

Rubriques et abonnements aux événements

Les événements publiés dans Event Grid atterrissent sur une rubrique, qui est une ressource qui contient logiquement tous les événements. Un abonnement aux événements est une ressource de configuration associée à une seule rubrique. Entre autres, vous utilisez un abonnement aux événements pour définir des critères de sélection d’événements afin de définir la collection d’événements disponible pour un abonné sur l’ensemble total d’événements présents dans une rubrique.

Diagram showing a topic and associated event subscriptions.

Livraison push

La livraison push est prise en charge pour les ressources suivantes. Utilisez les liens pour en savoir plus sur chaque scénario.

  • Rubriques système. Utilisez les rubriques système pour recevoir des événements (système) des services Azure.
  • Rubriques personnalisées. Utilisez des rubriques personnalisées lorsque vous souhaitez publier les événements de votre application.
  • Domaines. Les domaines représentent un groupe de rubriques de domaine généralement associées à une application unique qui nécessite l’envoi d’événements à différents groupes d’utilisateurs, d’organisations ou d’applications. Une approche courante consiste à associer une rubrique de domaine à un groupe d’applications cibles ou d’utilisateurs d’une organisation au sein du même locataire. Une organisation peut être une équipe, une division de l’entreprise, une entreprise, etc.
  • Rubriques de partenaire. Utilisez des rubriques de partenaires lorsque vous souhaitez consommer des événements provenant de partenaires tiers.

Configurez un abonnement aux événements sur une rubrique système, personnalisée ou partenaire afin de spécifier des critères de filtrage pour les événements et de définir une destination sur l’un des gestionnaires d’événements pris en charge.

Le diagramme suivant illustre les ressources qui prennent en charge la livraison push avec certains des gestionnaires d’événements pris en charge.

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Remarque

Si vous souhaitez en savoir plus sur la remise push sur les espaces de noms Event Grid, consultez [namespace-push-delivery-overview.md].

Étapes suivantes

Les articles suivants vous fournissent des informations sur l’utilisation d’Event Grid ou des informations supplémentaires sur les concepts.