Benutzerdefinierte Themen in Azure Event Grid

Ein Event Grid-Thema stellt einen Endpunkt bereit, an den die Ereignisquelle Ereignisse sendet. Der Herausgeber erstellt ein Event Grid-Thema und legt fest, ob eine Ereignisquelle ein oder mehrere Themen benötigt. Ein Event Grid-Thema wird für eine Sammlung ähnlicher Ereignisse verwendet. Um auf bestimmte Arten von Ereignissen zu reagieren, legen Abonnenten fest, welche Themen sie abonnieren.

Benutzerdefinierte Themen sind Anwendungs- und Drittanbieterthemen. Wenn Sie ein benutzerdefiniertes Thema erstellen oder Zugriff darauf erhalten, wird es in Ihrem Abonnement angezeigt. Benutzerdefinierte Themen unterstützen Pushübermittlung. Die Informationen unter Wann Pull- oder Pushübermittlung verwendet werden sollte helfen Ihnen bei der Entscheidung, ob Pushübermittlung angesichts Ihrer Anforderungen der richtige Ansatz ist.

Beim Entwerfen Ihrer Anwendung müssen Sie entscheiden, wie viele Themen erstellt werden sollen. Für relativ große Lösungen erstellen Sie für jede Kategorie verwandter Ereignisse ein benutzerdefiniertes Thema. Betrachten Sie beispielsweise eine Anwendung, die Benutzerkonten verwaltet, und eine andere Anwendung für Kundenaufträge. Es ist unwahrscheinlich, dass alle Ereignisabonnenten Ereignisse von beiden Anwendungen wünschen. Um Anliegen zu trennen, erstellen Sie zwei Themen: ein Thema für jede Anwendung. Lassen Sie Ereignishandler das Thema entsprechend ihren Anforderungen abonnieren. Für kleine Lösungen empfiehlt es sich ggf., alle Ereignisse an ein Thema zu senden. Ereignisabonnenten können nach den gewünschten Ereignistypen filtern.

Ereignisschema

Benutzerdefinierte Themen unterstützen zwei Arten von Ereignisschemas: Cloudereignisse und das Event Grid-Schema.

Cloudereignisschema

Zusätzlich zu seinem Standardereignisschema unterstützt Azure Event Grid nativ Ereignisse in der JSON-Implementierung von CloudEvents 1.0 und in der HTTP-Bindung. CloudEvents ist eine offene Spezifikation zur Beschreibung von Ereignisdaten.

CloudEvents vereinfacht die Interoperabilität, indem ein allgemeines Ereignisschema für die Veröffentlichung bereitgestellt wird und Ereignisse genutzt werden. Dieses Schema ermöglicht einheitliche Tools, Standardmethoden zum Routing und Behandeln von Ereignissen und eine gängige Methode zum Deserialisieren Ihrer Ereignisse. Mit einem allgemeinen Schema können Sie Arbeit leichter plattformübergreifend integrieren.

Hinweis

Weitere Informationen finden Sie unter Cloudereignisschema.

Event Grid-Ereignisschema

Wenn Sie ein Event Grid-Ereignisschema verwenden, können Sie ihre anwendungsspezifischen Eigenschaften im data-Objekt angeben.

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

Hinweis

Weitere Informationen finden Sie unter Event Grid-Ereignisschema.

Die folgenden Abschnitte enthalten Links zu Tutorials zur Erstellung von benutzerdefinierten Themen mit dem Azure-Portal, der CLI, PowerShell und ARM-Vorlagen (Azure Resource Manager).

Tutorials zum Azure-Portal

Titel	BESCHREIBUNG
Schnellstart: Erstellen und Weiterleiten benutzerdefinierter Ereignisse mit dem Azure-Portal	Zeigt die Verwendung des Portals zum Senden von benutzerdefinierten Ereignissen.
Schnellstart: Weiterleiten von benutzerdefinierten Ereignissen an Azure Queue Storage	Beschreibt das Senden von benutzerdefinierten Ereignisse an eine Queue Storage-Instanz.
Gewusst wie: Posten eines Ereignisses in einem benutzerdefinierten Thema	Zeigt das Posten eines Ereignisses in einem benutzerdefinierten Thema.

Tutorials zur Azure CLI

Titel	BESCHREIBUNG
Schnellstart: Erstellen und Weiterleiten benutzerdefinierter Ereignisse mit Azure CLI	Zeigt die Verwendung von Azure CLI zum Senden von benutzerdefinierten Ereignissen.
Azure CLI: Erstellen eines benutzerdefinierten Event Grid-Themas	Beispielskript, mit dem ein benutzerdefiniertes Thema erstellt wird. Das Skript ruft den Endpunkt und einen Schlüssel ab.
Azure CLI: Abonnieren von Ereignissen für ein benutzerdefiniertes Thema	Beispielskript, mit dem ein Abonnement für ein benutzerdefiniertes Thema erstellt wird. Sendet Ereignisse an einen WebHook.

Tutorials zu Azure PowerShell

Titel	BESCHREIBUNG
Schnellstart: Erstellen und Weiterleiten benutzerdefinierter Ereignisse mit Azure PowerShell	Zeigt die Verwendung von Azure PowerShell zum Senden von benutzerdefinierten Ereignissen.
PowerShell: Erstellen eines benutzerdefinierten Event Grid-Themas	Beispielskript, mit dem ein benutzerdefiniertes Thema erstellt wird. Das Skript ruft den Endpunkt und einen Schlüssel ab.
PowerShell: Abonnieren von Ereignissen für ein benutzerdefiniertes Thema	Beispielskript, mit dem ein Abonnement für ein benutzerdefiniertes Thema erstellt wird. Sendet Ereignisse an einen WebHook.

Tutorials zu ARM-Vorlagen

Titel	BESCHREIBUNG
Resource Manager-Vorlage: Benutzerdefiniertes Thema und WebHook-Endpunkt	Eine Resource Manager-Vorlage, mit der ein benutzerdefiniertes Thema und ein Abonnement für dieses benutzerdefinierte Thema erstellt werden. Sendet Ereignisse an einen WebHook.
Resource Manager-Vorlage: Benutzerdefiniertes Thema und Event Hubs-Endpunkt	Eine Resource Manager-Vorlage, mit der ein Abonnement für ein benutzerdefiniertes Thema erstellt wird. Sendet Ereignisse an Azure Event Hubs.

Hinweis

Azure Digital Twins kann Ereignisbenachrichtigungen an benutzerdefinierte Themen routen, die Sie mit Event Grid erstellen. Weitere Informationen finden Sie in der Dokumentation zu Azure Digital Twins im Abschnitt zu Endpunkten und Ereignisrouten.

Nächste Schritte

Weitere Informationen finden Sie in folgenden Artikeln:

• Systemthemen
• Domänen