Abonnieren von Azure-Ressourcenverwaltungsereignissen in Event Grid

In diesem Artikel werden die Schritte zum Abonnieren von Ereignissen erläutert, die von Azure-Ressourcenbenachrichtigungen für Ressourcen veröffentlicht werden. Ausführliche Informationen zu diesen Ereignissen finden Sie unter Azure-Ressourcenbenachrichtigungen: Ereignisse für Ressourcen.

Erstellen des Systemthemas „Ressourcen“

In diesem Abschnitt erfahren Sie, wie Sie ein Systemthema vom Typ microsoft.resourcenotifications.resources erstellen.

Azure-Befehlszeilenschnittstelle

1. Legen Sie das Konto auf das Azure-Abonnement fest, in dem Sie das Systemthema erstellen möchten.

   az account set –s AZURESUBSCRIPTIONID
   

2. Erstellen Sie mithilfe des Befehls az eventgrid system-topic create ein Systemthema vom Typ microsoft.resourcenotifications.resources.

   az eventgrid system-topic create \
               --name SYSTEMTOPICNAME \
               --resource-group RESOURCEGROUPNAME \
               --source /subscriptions/AZURESUBSCRIPTIONID \
               --topic-type microsoft.resourcenotifications.resources \
               --location Global        
   

Azure PowerShell

1. Legen Sie das Konto auf das Azure-Abonnement fest, in dem Sie das Systemthema erstellen möchten.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Erstellen Sie mithilfe des Befehls New-AzEventGridSystemTopic ein Systemthema vom Typ microsoft.resourcenotifications.resources.

   New-AzEventGridSystemTopic -name SYSTEMTOPICNAME `
                   -resourcegroup RESOURCEGROUPNAME `
                   -source /subscriptions/AZURESUBSCRIPTIONID `
                   -topictype microsoft.resourcenotifications.resources `
                   -location global    
   

Azure portal

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie in der Suchleiste Event Grid-Systemthemen ein, und wählen Sie diesen Eintrag in der Liste aus.

3. Wählen Sie auf der Symbolleiste der Seite Event Grid-Systemthemen die Option Erstellen aus.

4. Wählen Sie auf der Seite Event Grid-Systemthema erstellen die Option Azure-Ressourcenverwaltung – Vorschau als Thementyp aus.

   

5. Wählen Sie die Ressourcengruppe aus, in der Sie das Systemthema erstellen möchten.

6. Geben Sie unter Name einen Namen für das Systemthema ein.

7. Klicken Sie auf Überprüfen + erstellen.

8. Wählen Sie auf der Seite Überprüfen + erstellen die Option Erstellen aus.

9. Wählen Sie auf der Seite, auf der die erfolgreiche Bereitstellung bestätigt wird, die Option Zu Ressource wechseln aus, um zur Seite für Ihr Systemthema zu navigieren. Auf dieser Seite werden die Details zu Ihrem Systemthema angezeigt.

Abonnieren von Ereignissen

Azure-Befehlszeilenschnittstelle

Erstellen Sie mit dem Befehl az eventgrid system-topic event-subscription create ein Ereignisabonnement für das obige Thema.

Mit dem folgenden Beispielbefehl wird ein Ereignisabonnement für die Ereignisse CreatedOrUpdated und Deleted erstellt. Wenn Sie included-event-types nicht angeben, sind standardmäßig alle Ereignistypen enthalten.

az eventgrid system-topic event-subscription create \
                --name EVENTSUBSCRIPTIONNAME \
                --resource-group RESOURCEGROUPNAME \
                --system-topic-name SYSTEMTOPICNAME \
                –-included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
                --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB \
                --endpoint-type eventhub        

Azure PowerShell

Erstellen Sie mit dem Befehl New-AzEventGridSystemTopicEventSubscription ein Ereignisabonnement für das obige Thema.

Mit dem folgenden Beispielbefehl wird ein Ereignisabonnement für die Ereignisse CreatedOrUpdated und Deleted erstellt. Wenn Sie IncludedEventType nicht angeben, sind standardmäßig alle Ereignistypen enthalten.

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME `
                -ResourceGroupName RESOURCEGROUPNAME `
                -SystemtopicName SYSTEMTOPICNAME `
                -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
                -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB `
                -EndpointType eventhub

Azure portal

1. Wählen Sie auf der Seite Event Grid-Systemthema auf der Symbolleiste die Option + Ereignisabonnement aus.

2. Bestätigen Sie, dass die Felder Thementyp, Quellressource und Themenname automatisch ausgefüllt sind.

3. Geben Sie einen Namen für das Ereignisabonnement ein.

4. Wählen Sie unter Ereignistypen filtern das Ereignis aus, z. B. CreatedOrUpdated oder Deleted.

   

5. Wählen Sie den Endpunkttyp aus.

6. Konfigurieren Sie den Ereignishandler basierend auf dem ausgewählten Endpunkttyp. Im folgenden Beispiel wird ein Azure Event Hub ausgewählt.

   

7. Wählen Sie die Registerkarte Filter aus, um Betrefffilter und erweiterte Filter festzulegen. Um nach Ereignissen von Ressourcen in einer bestimmten Ressourcengruppe zu filtern, führen Sie beispielsweise die folgenden Schritte aus:

   1. Wählen Sie Betrefffilter aktivieren aus.

   2. Geben Sie im Abschnitt Betrefffilter für Betreff beginnt mit den Wert der Ressourcengruppe im folgenden Format an: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Wählen Sie dann Erstellen aus, um das Ereignisabonnement zu erstellen.

Löschen eines Ereignisabonnements und Systemthemas

Azure-Befehlszeilenschnittstelle

Verwenden Sie zum Löschen des Ereignisabonnements den Befehl az eventgrid system-topic event-subscription delete. Hier sehen Sie ein Beispiel:

az eventgrid system-topic event-subscription delete --name firstEventSubscription --resourcegroup sampletestrg --system-topic-name arnSystemTopicResources

Verwenden Sie zum Löschen des Systemthemas den Befehl az eventgrid system-topic delete. Hier sehen Sie ein Beispiel:

az eventgrid system-topic delete --name arnSystemTopicResources --resource-group sampletestrg

Azure PowerShell

Verwenden Sie zum Löschen eines Ereignisabonnements den Befehl Remove-AzEventGridSystemTopicEventSubscription. Hier sehen Sie ein Beispiel:

Remove-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription -ResourceGroupName sampletestrg -SystemTopicName arnSystemTopicResources

Verwenden Sie zum Löschen des Systemthemas den Befehl Remove-AzEventGridSystemTopic. Hier sehen Sie ein Beispiel:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Azure portal

1. Melden Sie sich beim Azure-Portal an.
2. Geben Sie in der Suchleiste Event Grid-Systemthemen ein, und drücken Sie die EINGABETASTE.
3. Wählen Sie das Systemthema aus.
4. Wählen Sie auf der Symbolleiste der Seite Event Grid-Systemthema die Option Löschen aus.

Beispiele für Filter

Abonnieren von Erstellen, Aktualisieren und Löschen von Benachrichtigungen für VMs in einem Azure-Abonnement

In diesem Abschnitt wird ein Beispiel für das Filtern zum Abonnieren der Aktionen Erstellen, Aktualisieren und Löschen von Benachrichtigungen für VMs in einem Azure-Abonnement gezeigt.

Azure-Befehlszeilenschnittstelle

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources 
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

Azure PowerShell

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Azure portal

1. Wählen Sie die Ereignistypen CreatedOrUpdated und Deleted aus.

2. Wählen Sie auf der Registerkarte Filter des Ereignisabonnements die folgenden erweiterten Filter aus.

   Key = "data.resourceInfo.type"
   Operator = "StringEndsWith" 
   Value = "virtualMachines"
   

Abonnieren von Benachrichtigungen für das Erstellen, Aktualisieren und Löschen von VMs für eine bestimmte Ressourcengruppe

Azure-Befehlszeilenschnittstelle

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
	--advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

Azure PowerShell

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Azure portal

Aktivieren Sie auf der Registerkarte Filter des Ereignisabonnements die Themenfilterung, und verwenden Sie den folgenden Themenfilter:

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

Wählen Sie dann die folgenden erweiterten Filter aus.

Key = "data.resourceInfo.type"
Operator = "String ends with"
Value = "virtualMachines"

Abonnieren von Benachrichtigungen für das Erstellen und Aktualisieren für einen bestimmten Standort in einem Abonnement

Azure-Befehlszeilenschnittstelle

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
    --advanced-filter data.resourceInfo.location StringIn eastus 
    –-advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

Azure PowerShell

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringIn"; key = "data.resourceInfo.location"; value ="eastus"}, @{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

Azure portal

Aktivieren Sie auf der Registerkarte Filter des Ereignisabonnements die Themenfilterung, und verwenden Sie den folgenden Themenfilter:

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

Wählen Sie dann die folgenden erweiterten Filter aus.

Key = "data.resourceInfo.location",
Operator = "String is in"
Value = "eastus"

AND

Key = "data.resourceInfo.type", Operator = "String ends with" Value = "virtualMachines"

Kontakt

Wenn Sie Fragen oder Feedback zu diesem Feature haben, zögern Sie nicht, uns unter arnsupport@microsoft.com zu kontaktieren.

Um Ihnen besser mit spezifischem Feedback zu einem bestimmten Ereignis zu helfen, geben Sie die folgenden Informationen an:

Für fehlende Ereignisse:

• Name des Systemthematyps
• Ungefährer Zeitstempel in UTC, zu dem der Vorgang ausgeführt wurde
• Basisressourcen-ID, für die die Benachrichtigung generiert wurde
• Navigieren Sie im Azure-Portal zu Ihrer Ressource, und wählen Sie die JSON-Ansicht ganz rechts aus. Die Ressourcen-ID ist das erste Feld auf der JSON-Ansichtsseite.
• Erwarteter Ereignistyp
• Vorgang ausgeführt (z. B. VM gestartet oder beendet, Speicherkonto erstellt usw.)
• Beschreibung des aufgetretenen Problems (z. B. VM gestartet und kein Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-Ereignis generiert)
• Geben Sie nach Möglichkeit die Korrelations-ID des ausgeführten Vorgangs an.

Für ein Ereignis, das verzögert wurde oder unerwartete Inhalte aufweist

• Name des Systemthematyps
• Vollständiger Inhalt der Benachrichtigung ohne data.resourceInfo.properties
• Beschreibung des aufgetretenen Problems und die betroffenen Feldwerte

Stellen Sie sicher, dass Sie keine personenbezogenen Informationen zu den Endbenutzer*innen einschließen, wenn Sie diese Daten freigeben.

Nächste Schritte

Ausführliche Informationen zu diesen Ereignissen finden Sie unter Azure-Ressourcenbenachrichtigungen: Ereignisse für Ressourcen.