Aangepaste onderwerpen in Azure Event Grid

Een Event Grid-onderwerp biedt een eindpunt waar de bron gebeurtenissen verzendt. De uitgever maakt een Event Grid-onderwerp en bepaalt of een gebeurtenisbron één onderwerp of meer dan één onderwerp nodig heeft. Een onderwerp wordt gebruikt voor een verzameling gerelateerde gebeurtenissen. Abonnees bepalen op welke onderwerpen u zich wilt abonneren om te reageren op bepaalde typen gebeurtenissen.

Aangepaste onderwerpen zijn onderwerpen van toepassingen en derden. Wanneer u een aangepast onderwerp maakt of toegang krijgt tot een aangepast onderwerp, ziet u dat aangepaste onderwerp in uw abonnement. Aangepaste onderwerpen ondersteunen pushlevering. Raadpleeg wanneer u pull- of pushlevering gebruikt om u te helpen bepalen of pushlevering de juiste aanpak is op basis van uw vereisten.

Bij het ontwerpen van uw toepassing moet u bepalen hoeveel onderwerpen u moet maken. Voor relatief grote oplossingen maakt u een aangepast onderwerp voor elke categorie gerelateerde gebeurtenissen. Denk bijvoorbeeld aan een toepassing waarmee gebruikersaccounts en een andere toepassing over klantorders worden beheerd. Het is onwaarschijnlijk dat alle gebeurtenisabonnees gebeurtenissen van beide toepassingen willen. Als u problemen wilt scheiden, maakt u twee onderwerpen: één voor elke toepassing. Laat gebeurtenis-handlers zich abonneren op het onderwerp volgens hun vereisten. Voor kleine oplossingen wilt u mogelijk alle gebeurtenissen naar één onderwerp verzenden. Gebeurtenisabonnees kunnen filteren op de gewenste gebeurtenistypen.

Gebeurtenisschema

Aangepaste onderwerpen ondersteunen twee soorten gebeurtenisschema's: Cloud-gebeurtenissen en Event Grid-schema.

Cloudgebeurtenisschema

Naast het standaard gebeurtenisschema biedt Azure Event Grid systeemeigen ondersteuning voor gebeurtenissen in de JSON-implementatie van CloudEvents v1.0 en HTTP-protocolbinding. CloudEvents is een open specificatie voor het beschrijven van gebeurtenisgegevens.

CloudEvents vereenvoudigt de interoperabiliteit door een gemeenschappelijk gebeurtenisschema te bieden voor het publiceren en gebruiken van gebeurtenissen. Dit schema biedt uniforme tooling, standaard manieren om gebeurtenissen te routeren en te verwerken, en een algemene manier om uw gebeurtenissen te deserialiseren. Met een gemeenschappelijk schema kunt u eenvoudiger werk op verschillende platforms integreren.

Notitie

Zie Het gebeurtenisschema van de cloud voor meer informatie.

Event Grid-gebeurtenisschema

Wanneer u een Event Grid-gebeurtenisschema gebruikt, kunt u uw toepassingsspecifieke eigenschappen opgeven in het gegevensobject .

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

Notitie

Zie Event Grid-gebeurtenisschema voor meer informatie.

De volgende secties bevatten koppelingen naar zelfstudies voor het maken van aangepaste onderwerpen met behulp van Azure Portal-, CLI-, PowerShell- en Arm-sjablonen (Azure Resource Manager).

Zelfstudies voor Azure Portal

Title	Beschrijving
Quickstart: Aangepaste gebeurtenissen maken en routeren met Azure Portal	Laat zien hoe u de portal gebruikt om aangepaste gebeurtenissen te verzenden.
Quickstart: aangepaste gebeurtenissen routeren naar Azure Queue Storage	Hierin wordt beschreven hoe u aangepaste gebeurtenissen verzendt naar een Queue Storage.
Procedure: posten naar aangepast onderwerp	Laat zien hoe u een gebeurtenis in een aangepast onderwerp plaatst.

Zelfstudies voor Azure CLI

Title	Beschrijving
Quickstart: Aangepaste gebeurtenissen maken en routeren met Azure CLI	Laat zien hoe u Azure CLI gebruikt om aangepaste gebeurtenissen te verzenden.
Azure CLI: aangepast Event Grid-onderwerp maken	Voorbeeldscript waarmee een aangepast onderwerp wordt gemaakt. Het script haalt het eindpunt en een sleutel op.
Azure CLI: abonneren op gebeurtenissen voor een aangepast onderwerp	Voorbeeldscript waarmee een abonnement voor een aangepast onderwerp wordt gemaakt. Er worden gebeurtenissen naar een WebHook verzonden.

Zelfstudies voor Azure PowerShell

Title	Beschrijving
Quickstart: Aangepaste gebeurtenissen maken en routeren met Azure PowerShell	Laat zien hoe u Azure PowerShell gebruikt om aangepaste gebeurtenissen te verzenden.
PowerShell: aangepast Event Grid-onderwerp maken	Voorbeeldscript waarmee een aangepast onderwerp wordt gemaakt. Het script haalt het eindpunt en een sleutel op.
PowerShell: abonneren op gebeurtenissen voor een aangepast onderwerp	Voorbeeldscript waarmee een abonnement voor een aangepast onderwerp wordt gemaakt. Er worden gebeurtenissen naar een WebHook verzonden.

Zelfstudies voor ARM-sjablonen

Title	Beschrijving
Resource Manager-sjabloon: aangepast onderwerp en WebHook-eindpunt	Een Resource Manager-sjabloon waarmee een aangepast onderwerp en abonnement voor dat aangepaste onderwerp wordt gemaakt. Er worden gebeurtenissen naar een WebHook verzonden.
Resource Manager-sjabloon: aangepast onderwerp en Event Hubs-eindpunt	Een Resource Manager-sjabloon waarmee een abonnement voor een aangepast onderwerp wordt gemaakt. Er worden gebeurtenissen verzonden naar een Azure Event Hubs.

Notitie

Azure Digital Twins kan gebeurtenismeldingen routeren naar aangepaste onderwerpen die u met Event Grid maakt. Zie Eindpunten en gebeurtenisroutes in de documentatie van Azure Digital Twins voor meer informatie.

Volgende stappen

Zie de volgende artikelen:

• Systeemonderwerpen
• Domeinen