Prenumerera på Azure Resource Management-händelser i Event Grid

Den här artikeln beskriver de steg som krävs för att prenumerera på händelser som publicerats av Azure Resource Notifications – Resources. Detaljerad information om dessa händelser finns i Azure Resource Notifications – Resources events (Azure Resource Notifications – Resources events).

Avsnittet Skapa resurssystem

Det här avsnittet visar hur du skapar ett systemämne av typen microsoft.resourcenotifications.resources.

Azure CLI

1. Ange kontot till den Azure-prenumeration där du vill skapa systemämnet.

   az account set –s AZURESUBSCRIPTIONID
   

2. Skapa ett systemämne av typen microsoft.resourcenotifications.resources med kommandot az eventgrid system-topic create .

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

Azure PowerShell

1. Ange kontot till den Azure-prenumeration där du vill skapa systemämnet.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Skapa ett systemämne av typen microsoft.resourcenotifications.resources med kommandot New-AzEventGridSystemTopic .

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

Azure-portalen

1. Logga in på Azure-portalen.

2. I sökfältet skriver du Event Grid System Topics och väljer det i listrutan.

3. På sidan Systemämnen för Event Grid väljer du Skapa i verktygsfältet.

4. På sidan Skapa Event Grid-systemämne väljer du Azure Resource Management – Förhandsversion för ämnestyp.

   

5. Välj den resursgrupp där du vill skapa systemämnet.

6. Ange ett namn för systemämnet.

7. Välj Granska + skapa

8. På sidan Granska + skapa väljer du Skapa.

9. På sidan för lyckad distribution väljer du Gå till resurs för att navigera till sidan för systemavsnittet. Du ser information om ditt systemavsnitt på den här sidan.

Prenumerera på händelser

Azure CLI

Skapa en händelseprenumeration för ämnet ovan med kommandot az eventgrid system-topic event-subscription create .

Följande exempelkommando skapar en händelseprenumeration för både CreateOrUpdated - och Deleted-händelser . Om du inte anger included-event-typesinkluderas alla händelsetyper som standard.

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

Skapa en händelseprenumeration för ämnet ovan med kommandot New-AzEventGridSystemTopicEventSubscription .

Följande exempelkommando skapar en händelseprenumeration för både CreateOrUpdated - och Deleted-händelser . Om du inte anger IncludedEventTypeinkluderas alla händelsetyper som standard.

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-portalen

1. På sidan Systemämne för Event Grid väljer du Händelseprenumeration i verktygsfältet.

2. Bekräfta att ämnestypen, källresursen och ämnesnamnet fylls i automatiskt.

3. Ange ett namn för händelseprenumerationen.

4. För Filtrera till händelsetyper väljer du händelsen, till exempel CreatedOrUpdated eller Deleted.

   

5. Välj slutpunktstyp.

6. Konfigurera händelsehanterare utan den slutpunktstyp som du har valt. I följande exempel väljs en Azure-händelsehubb.

   

7. Välj fliken Filter för att ange ämnesfiltrering och avancerad filtrering. Om du till exempel vill filtrera efter händelser från resurser i en specifik resursgrupp följer du dessa steg:

   1. Välj Aktivera ämnesfiltrering.

   2. I avsnittet Ämnesfilter för Ämne börjar med anger du värdet för resursgruppen i det här formatet: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Välj sedan Skapa för att skapa händelseprenumerationen.

Ta bort händelseprenumeration och systemämne

Azure CLI

Om du vill ta bort händelseprenumerationen använder du az eventgrid system-topic event-subscription delete kommandot . Här är ett exempel:

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

Om du vill ta bort systemämnet använder du az eventgrid system-topic delete kommandot . Här är ett exempel:

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

Azure PowerShell

Om du vill ta bort en händelseprenumeration använder du Remove-AzEventGridSystemTopicEventSubscription kommandot . Här är ett exempel:

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

Om du vill ta bort systemämnet använder du Remove-AzEventGridSystemTopic kommandot . Här är ett exempel:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Azure-portalen

1. Logga in på Azure-portalen.
2. I sökfältet skriver du Event Grid System Topics och trycker på RETUR.
3. Välj systemämnet.
4. På sidan Systemämne för Event Grid väljer du Ta bort i verktygsfältet.

Filtreringsexempel

Prenumerera på att skapa, uppdatera, ta bort meddelanden för virtuella datorer i en Azure-prenumeration

Det här avsnittet visar filtreringsexempel på att prenumerera på att skapa, uppdatera och ta bort meddelanden för virtuella datorer i en Azure-prenumeration.

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-portalen

1. Välj Händelsetyperna CreateOrUpdated och Deleted .

2. På fliken Filter i händelseprenumerationen väljer du följande avancerade filter.

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

Prenumerera på meddelanden om att skapa, uppdatera och ta bort virtuella datorer av en viss resursgrupp

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-portalen

På fliken Filter i händelseprenumerationen aktiverar du ämnesfiltrering och använder följande ämnesfilter:

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

Välj sedan följande avancerade filter.

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

Prenumerera på skapa och uppdatera meddelanden för virtuella datorer efter en viss plats i en prenumeration

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-portalen

På fliken Filter i händelseprenumerationen aktiverar du ämnesfiltrering och använder följande ämnesfilter:

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

Välj sedan följande avancerade filter.

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

OCH

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

Kontakta oss

Om du har frågor eller feedback om den här funktionen kan du kontakta oss på arnsupport@microsoft.com.

Ange följande information för att bättre hjälpa dig med specifik feedback om en viss händelse:

För saknade händelser:

• Namn på systemämnestyp
• Ungefärlig tidsstämpel i UTC när åtgärden kördes
• Basresurs-ID som meddelandet genererades för
• Gå till resursen i Azure-portalen och välj JSON-vy längst till höger. Resurs-ID är det första fältet på JSON-vysidan.
• Förväntad händelsetyp
• Åtgärden utfördes (till exempel startad eller stoppad virtuell dator, lagringskonto som skapats osv.)
• Beskrivning av påträffade problem (till exempel startad virtuell dator och ingen Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-händelse genererad)
• Ange om möjligt korrelations-ID för den utförda åtgärden

För händelse som har fördröjts eller har oväntat innehåll

• Namn på systemämnestyp
• Hela innehållet i meddelandet exklusive data.resourceInfo.properties
• Beskrivning av problem som påträffas och påverkade fältvärden

Se till att du inte tillhandahåller någon identifierbar information för slutanvändare när du delar dessa data.

Nästa steg

Detaljerad information om dessa händelser finns i Azure Resource Notifications – Resources events (Azure Resource Notifications – Resources events).