Push-levering met HTTP

  • Artikel

Dit artikel bouwt voort op Wat is Azure Event Grid? om essentiële informatie te verstrekken voordat u de pull- en pushlevering van Event Grid via HTTP gaat gebruiken. Hierin worden fundamentele concepten, resourcemodellen en ondersteunde berichtbezorgingsmodi behandeld. Aan het einde van dit document vindt u nuttige koppelingen naar artikelen die u helpen bij het gebruik van Event Grid en artikelen die uitgebreide conceptuele informatie bieden.

Belangrijk

Dit document helpt u aan de slag te gaan met Event Grid-mogelijkheden die gebruikmaken van het HTTP-protocol. Dit artikel is geschikt voor gebruikers die toepassingen in de cloud moeten integreren. Zie Overzicht van de MQTT-ondersteuning in Azure Event Grid als u gegevens van IoT-apparaten moet communiceren.

Basisconcepten

CloudEvents

Event Grid voldoet aan de open standaard CloudEvents 1.0-specificatie van CNCF met behulp van de HTTP-protocolbinding met JSON-indeling. Dit betekent dat uw oplossingen gebeurtenisberichten publiceren en gebruiken met behulp van een indeling zoals in het volgende voorbeeld:

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

Wat is een gebeurtenis?

Een gebeurtenis is de kleinste hoeveelheid informatie die volledig beschrijft wat er in een systeem is gebeurd. We verwijzen vaak naar een gebeurtenis zoals hierboven wordt weergegeven als een discrete gebeurtenis, omdat deze een uniek, zelfstandig feit vertegenwoordigt over een systeem dat een inzicht biedt dat kan worden uitgevoerd. Voorbeelden zijn: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Notitie

We gebruiken de termen discrete gebeurtenissen, cloudevents of alleen gebeurtenissen om te verwijzen naar die berichten die informeren over een wijziging van een systeemstatus.

Zie de Event Grid-terminologie voor meer informatie over gebeurtenissen.

Een ander soort gebeurtenis

De gebruikerscommunity verwijst ook naar gebeurtenissen naar dat type berichten die een gegevenspunt bevatten, zoals één lees vanaf een apparaat of één klik op een webpagina. Dit soort gebeurtenissen wordt meestal geanalyseerd in een tijdvenster of gebeurtenisstroomgrootte om inzichten af te leiden en een actie te ondernemen. In de documentatie van Event Grid verwijzen we naar dat soort gebeurtenis als gegevenspunt, streaminggegevens of telemetrie. Ze zijn een soort gegevens die de MQTT-ondersteuning van Event Grid en Azure Event Hubs doorgaans verwerken.

Onderwerpen en gebeurtenisabonnementen

Gebeurtenissen die naar Event Grid worden gepubliceerd, komen terecht op een onderwerp. Dit is een resource die alle gebeurtenissen logisch bevat. Een gebeurtenisabonnement is een configuratieresource die is gekoppeld aan één onderwerp. U gebruikt onder andere een gebeurtenisabonnement om selectiecriteria voor gebeurtenissen in te stellen om de gebeurtenisverzameling te definiëren die beschikbaar is voor een abonnee uit de totale set gebeurtenissen die aanwezig zijn in een onderwerp.

Diagram showing a topic and associated event subscriptions.

Push-levering

Push-levering wordt ondersteund voor de volgende resources. Klik op de koppelingen voor meer informatie over deze koppelingen.

  • Systeemonderwerpen. Gebruik systeemonderwerpen om (systeem)gebeurtenissen van Azure-services te ontvangen.
  • Aangepaste onderwerpen. Gebruik aangepaste onderwerpen wanneer u de gebeurtenissen van uw toepassing wilt publiceren.
  • Domeinen. Domeinen vertegenwoordigen een groep domeinonderwerpen die doorgaans zijn gekoppeld aan één toepassing waarvoor het verzenden van gebeurtenissen naar een andere groep gebruikers, organisaties of toepassingen vereist is. Een veelvoorkomende benadering is het koppelen van een domeinonderwerp aan een groep doeltoepassingen of gebruikers van een organisatie binnen dezelfde tenant. Een organisatie kan een team, een afdeling in bedrijf, een bedrijf, enzovoort zijn.
  • Partneronderwerpen. Gebruik partneronderwerpen als u gebeurtenissen van externe partners wilt gebruiken.

Configureer een gebeurtenisabonnement op een systeem-, aangepaste of partneronderwerp om een filtercriteria voor gebeurtenissen op te geven en een bestemming in te stellen op een van de ondersteunde gebeurtenis-handlers.

In het volgende diagram ziet u de resources die ondersteuning bieden voor pushlevering met een aantal ondersteunde gebeurtenis-handlers.

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

Notitie

Als u meer wilt weten over pushbezorging in Event Grid-naamruimten, raadpleegt u [namespace-push-delivery-overview.md].

Volgende stappen

In de volgende artikelen vindt u informatie over het gebruik van Event Grid of aanvullende informatie over concepten.