Abonneren op Azure Resource Management-gebeurtenissen in Event Grid

In dit artikel worden de stappen uitgelegd die nodig zijn om u te abonneren op gebeurtenissen die zijn gepubliceerd door Azure Resource Notifications - Resources. Zie Azure Resource Notifications - Resources events voor gedetailleerde informatie over deze gebeurtenissen.

Resourcesysteemonderwerp maken

In deze sectie wordt beschreven hoe u een systeemonderwerp van het type microsoft.resourcenotifications.resourcesmaakt.

Azure-CLI

1. Stel het account in op het Azure-abonnement waar u het systeemonderwerp wilt maken.

   az account set –s AZURESUBSCRIPTIONID
   

2. Maak een systeemonderwerp van het type microsoft.resourcenotifications.resources met behulp van de az eventgrid system-topic create opdracht.

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

Azure PowerShell

1. Stel het account in op het Azure-abonnement waar u het systeemonderwerp wilt maken.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Maak een systeemonderwerp van het type microsoft.resourcenotifications.resources met behulp van de opdracht New-AzEventGridSystemTopic .

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

Azure-portal

1. Meld u aan bij de Azure Portal.

2. Typ in de zoekbalk Event Grid System Topics en selecteer deze in de vervolgkeuzelijst.

3. Selecteer Op de pagina Event Grid-systeemonderwerpen de optie Maken op de werkbalk.

4. Selecteer Op de pagina Event Grid-systeemonderwerp maken Azure Resource Management - Preview voor onderwerptype.

   

5. Selecteer de resourcegroep waarin u het systeemonderwerp wilt maken.

6. Voer een naam in voor het systeemonderwerp.

7. Selecteer Controleren en maken.

8. Selecteer Maken op de pagina Beoordelen en maken.

9. Selecteer op de pagina geslaagde implementatie naar de resource gaan om naar de pagina voor uw systeemonderwerp te navigeren. U ziet de details over uw systeemonderwerp op deze pagina.

Abonneren op gebeurtenissen

Azure-CLI

Maak een gebeurtenisabonnement voor het bovenstaande onderwerp met behulp van de az eventgrid system-topic event-subscription create opdracht.

Met de volgende voorbeeldopdracht maakt u een gebeurtenisabonnement voor zowel CreatedOrUpdated - als Verwijderde gebeurtenissen. Als u dit niet opgeeft included-event-types, worden standaard alle gebeurtenistypen opgenomen.

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

Maak een gebeurtenisabonnement voor het bovenstaande onderwerp met behulp van de opdracht New-AzEventGridSystemTopicEventSubscription .

Met de volgende voorbeeldopdracht maakt u een gebeurtenisabonnement voor zowel CreatedOrUpdated - als Verwijderde gebeurtenissen. Als u dit niet opgeeft IncludedEventType, worden standaard alle gebeurtenistypen opgenomen.

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. Selecteer gebeurtenisabonnement op de werkbalk op de pagina Event Grid-systeemonderwerp.

2. Controleer of het onderwerptype, de bronresource en de onderwerpnaam automatisch worden ingevuld.

3. Voer een naam in voor het gebeurtenisabonnement.

4. Als u wilt filteren op gebeurtenistypen, selecteert u de gebeurtenis, bijvoorbeeld CreatedOrUpdated of Verwijderd.

   

5. Selecteer het eindpunttype.

6. Configureer gebeurtenishandler op basis van het eindpunttype dat u hebt geselecteerd. In het volgende voorbeeld wordt een Azure Event Hub geselecteerd.

   

7. Selecteer het tabblad Filters om onderwerpfilters en geavanceerde filters op te geven. Als u bijvoorbeeld wilt filteren op gebeurtenissen uit resources in een specifieke resourcegroep, voert u de volgende stappen uit:

   1. Selecteer Onderwerpfiltering inschakelen.

   2. Geef in de sectie Onderwerpfilters voor Onderwerp de waarde op van de resourcegroep in deze indeling: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

      

8. Selecteer vervolgens Maken om het gebeurtenisabonnement te maken.

Gebeurtenisabonnement en systeemonderwerp verwijderen

Azure-CLI

Gebruik de az eventgrid system-topic event-subscription delete opdracht om het gebeurtenisabonnement te verwijderen. Hier volgt een voorbeeld:

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

Gebruik de az eventgrid system-topic delete opdracht om het systeemonderwerp te verwijderen. Hier volgt een voorbeeld:

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

Azure PowerShell

Als u een gebeurtenisabonnement wilt verwijderen, gebruikt u de Remove-AzEventGridSystemTopicEventSubscription opdracht. Hier volgt een voorbeeld:

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

Gebruik de Remove-AzEventGridSystemTopic opdracht om het systeemonderwerp te verwijderen. Hier volgt een voorbeeld:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Azure-portal

1. Meld u aan bij het Azure-portaal.
2. Typ in de zoekbalk Event Grid System Topics en druk op Enter.
3. Selecteer het systeemonderwerp.
4. Selecteer Verwijderen op de pagina Event Grid-systeemonderwerp op de werkbalk.

Voorbeelden van filteren

Abonneren om meldingen voor virtuele machines in een Azure-abonnement te maken, bij te werken, te verwijderen

In deze sectie ziet u het filtervoorbeeld van het abonneren op het maken, bijwerken en verwijderen van meldingen voor virtuele machines in een Azure-abonnement.

Azure-CLI

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. Kies CreatedOrUpdated en Verwijderde gebeurtenistypen.

2. Kies op het tabblad Filters van het gebeurtenisabonnement de volgende geavanceerde filters.

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

Abonneren op meldingen voor het maken, bijwerken en verwijderen van vm's door een bepaalde resourcegroep

Azure-CLI

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

Schakel op het tabblad Filters van het gebeurtenisabonnement het onderwerpfilter in en gebruik het volgende onderwerpfilter:

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

Kies vervolgens de volgende geavanceerde filters.

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

Abonneren op vm-meldingen maken en bijwerken op een bepaalde locatie binnen een abonnement

Azure-CLI

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

Schakel op het tabblad Filters van het gebeurtenisabonnement het onderwerpfilter in en gebruik het volgende onderwerpfilter:

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

Kies vervolgens de volgende geavanceerde filters.

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

EN

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

Contact opnemen

Als u vragen of feedback over deze functie hebt, aarzel dan niet om ons te bereiken op arnsupport@microsoft.com.

Geef de volgende informatie op om u beter te helpen met specifieke feedback over een bepaalde gebeurtenis:

Voor ontbrekende gebeurtenissen:

• Naam van systeemonderwerptype
• Geschatte tijdstempel in UTC toen de bewerking werd uitgevoerd
• Basisresource-id waarvoor de melding is gegenereerd
• Navigeer naar uw resource in Azure Portal en selecteer de JSON-weergave uiterst rechts. Resource-id is het eerste veld op de JSON-weergavepagina.
• Verwacht gebeurtenistype
• De bewerking is uitgevoerd (bijvoorbeeld vm gestart of gestopt, opslagaccount gemaakt, enzovoort)
• Beschrijving van het probleem dat is opgetreden (bijvoorbeeld dat de VM is gestart en er geen gebeurtenis Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged is gegenereerd)
• Geef indien mogelijk de correlatie-id op van de uitgevoerde bewerking

Voor gebeurtenissen die zijn vertraagd of onverwachte inhoud hebben

• Naam van systeemonderwerptype
• Volledige inhoud van de melding met uitzondering van data.resourceInfo.properties
• Beschrijving van probleem opgetreden en beïnvloede veldwaarden

Zorg ervoor dat u geen identificeerbare informatie voor eindgebruikers opgeeft terwijl u deze gegevens deelt.

Volgende stappen

Zie Azure Resource Notifications - Resources events voor gedetailleerde informatie over deze gebeurtenissen.