Freigeben über

Systemthemen in Azure Event Grid

  • Artikel

Ein Systemthema in Event Grid stellt ein oder mehrere Ereignisse dar, die von Azure-Diensten veröffentlicht wurden, beispielsweise von Azure Storage oder Azure Event Hubs. Beispielsweise kann ein Systemthema alle Blobereignisse oder nur für ein bestimmtes Speicherkonto veröffentlichte Bloberstellungs- und Bloblöschungsereignisse darstellen. Wenn in diesem Beispiel ein Blob in das Speicherkonto hochgeladen wird, veröffentlicht der Dienst Azure Storage ein Bloberstellungsereignis im Systemthema in Event Grid. Event Grid leitet dieses Ereignis dann an die Abonnenten des Themas weiter, die es empfangen und verarbeiten.

Hinweis

Nur Azure-Dienste können Ereignisse in Systemthemen veröffentlichen. Im Gegensatz zu benutzerdefinierten Themen oder Ereignisdomänen erhalten Sie daher keinen Endpunkt- oder Zugriffsschlüssel für das Veröffentlichen von Ereignissen.

Systemthemen unterstützende Azure-Dienste

Dies ist eine aktuelle Liste der Azure-Dienste, die das Erstellen von Systemthemen über sich unterstützen.

Systemthemen als Azure-Ressourcen

Systemthemen sind als Azure-Ressourcen sichtbar und bieten die folgenden Funktionen:

Hinweis

  • Nur ein Azure Event Grid-Systemthema ist pro Quelle zulässig (z. B. Abonnement, Ressourcengruppe usw.).
  • Eine Ressourcengruppe ist für Systemthemen auf Abonnementebene erforderlich, und sie kann nicht geändert werden, bis sie gelöscht oder in ein anderes Abonnement verschoben wird.
  • Event Grid erstellt eine Systemthemaressource im gleichen Azure-Abonnement, das die Ereignisquelle besitzt. Wenn Sie beispielsweise ein Systemthema für das Speicherkonto ContosoStorage in einem Azure-Abonnement ContosoSubscription erstellen, erstellt Event Grid das Systemthema im ContosoSubscription. Es ist nicht möglich, ein Systemthema in einem Azure-Abonnement zu erstellen, das sich vom Azure-Abonnement der Ereignisquelle unterscheidet.

Lebenszyklus von Systemthemen

Sie können ein Systemthema auf zwei Arten erstellen:

  • Erstellen Sie ein Ereignisabonnement für eine Azure-Ressource als Erweiterungsressource. Hierbei wird automatisch ein Systemthema mit einem Namen im folgenden Format erstellt: <Azure resource name>-<GUID>. Das auf diese Weise erstellte Systemthema wird automatisch gelöscht, wenn das letzte Ereignisabonnement für das Thema gelöscht wird.

  • Erstellen Sie ein Systemthema für eine Azure-Ressource und dann ein Ereignisabonnement für dieses Systemthema. Wenn Sie diese Methode verwenden, können Sie einen Namen für das Systemthema angeben. Das Systemthema wird nicht automatisch gelöscht, wenn das letzte Ereignisabonnement gelöscht wird. Sie müssen es manuell löschen.

    Wenn Sie das Azure-Portal verwenden, verwenden Sie immer diese Methode. Wenn Sie ein Ereignisabonnement über die Seite Ereignisse einer Azure-Ressource erstellen, wird zuerst das Systemthema erstellt und anschließend das Abonnement für das Thema. Über die Seite Event Grid System Topics (Event Grid-Systemthemen) können Sie explizit zuerst ein Systemthema erstellen und dann ein Abonnement für dieses Thema.

Wenn Sie die CLI, REST oder eine Azure Resource Manager-Vorlage verwenden, können Sie jede der oben genannten Methoden verwenden.

Wichtig

Sie sollten zuerst ein Systemthema erstellen und dann ein Abonnement für das Thema, da dies die aktuellste Methode zum Erstellen von Systemthemen ist.

Fehler bei der Erstellung von Systemthemen

Beim Erstellen von Systemthemen tritt ein Fehler auf, wenn Sie Azure-Richtlinien so eingerichtet haben, dass der Dienst Event Grid keine Systemthemen erstellen kann. Möglicherweise verfügen Sie z. B. über eine Richtlinie, die nur das Erstellen von bestimmten Ressourcentypen (z. B. Azure Storage, Azure Event Hubs usw.) im Abonnement zulässt.

In solchen Fällen bleibt die Ereignisflussfunktionalität erhalten. Die Metrik- und Diagnosefunktionalitäten von Systemthemen sind jedoch nicht verfügbar.

Wenn Sie diese Funktionalität benötigen, erlauben Sie die Erstellung von Ressourcen des Typs Systemthema und erstellen Sie das fehlende Systemthema wie im Abschnitt Lebenszyklus von Systemthemen beschrieben.

Ort und Ressourcengruppe für ein Systemthema

Für Azure-Ereignisquellen, die sich in einer bestimmten Region bzw. einem bestimmten Speicherort befinden, wird das Systemthema am gleichen Speicherort erstellt wie die Azure-Ereignisquelle. Wenn Sie beispielsweise ein Ereignisabonnement für Azure Blob Storage in der Region „USA, Osten“ erstellen, wird das Systemthema in „USA, Osten“ erstellt. Für globale Azure-Ereignisquellen wie Azure-Abonnements, Ressourcengruppen oder Azure Maps erstellt Event Grid das Systemthema an einem globalen Speicherort.

Im Allgemeinen wird das Systemthema in derselben Ressourcengruppe erstellt, in der sich auch die Azure-Ereignisquelle befindet. Für Ereignisabonnements, die im Bereich des Azure-Abonnements erstellt wurden, wird das Systemthema in der Ressourcengruppe Default-EventGrid in der Region USA, Westen 2 erstellt. Wenn die Ressourcengruppe nicht vorhanden ist, wird diese von Azure Event Grid vor dem Systemthema erstellt.

Nächste Schritte

Weitere Informationen finden Sie in folgenden Artikeln: