S'abonner à des événements Azure Resource Management dans Event Grid

Cet article explique les étapes à suivre pour s’abonner aux événements publiés par les notifications de ressources Azure - Ressources. Pour plus d’informations sur ces événements, consultez Notifications des ressources Azure - Événements de ressources.

Créer une rubrique système de ressources

Cette section vous montre comment créer une rubrique système de type microsoft.resourcenotifications.resources.

Azure CLI

1. Définissez le compte sur l’abonnement Azure dans lequel vous souhaitez créer la rubrique système.

   az account set –s AZURESUBSCRIPTIONID
   

2. Créez une rubrique système de type microsoft.resourcenotifications.resources à l’aide de la commande 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. Définissez le compte sur l’abonnement Azure dans lequel vous souhaitez créer la rubrique système.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Créez une rubrique système de type microsoft.resourcenotifications.resources à l’aide de la commande New-AzEventGridSystemTopic.

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

Azure portal

1. Connectez-vous au portail Azure.

2. Dans la barre de recherche, tapez Rubriques système Event Grid, puis sélectionnez-la dans la liste déroulante.

3. Sur la page Rubriques système Event Grid, sélectionnez Créer dans la barre d’outils.

4. Sur la page Créer une rubrique système Event Grid, sélectionnez Gestion des ressources Azure - Préversion pour le type de rubrique.

   

5. Sélectionnez le groupe de ressources dans lequel vous souhaitez créer la rubrique système.

6. Entrez un nom pour la rubrique système.

7. Sélectionner Vérifier + créer

8. Dans la page Vérifier + créer, sélectionnez Créer.

9. Sur la page de déploiement réussi, sélectionnez Accéder à la ressource pour accéder à la page de votre rubrique système. Vous voyez les détails de votre rubrique système sur cette page.

S’abonner à des événements

Azure CLI

Créez un abonnement aux événements pour la rubrique ci-dessus à l’aide de la commande az eventgrid system-topic event-subscription create.

L’exemple de commande suivant crée un abonnement à un événement pour les événements CreatedOrUpdated et Deleted. Si vous ne spécifiez pas included-event-types, tous les types d’événements sont inclus par défaut.

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

Créez un abonnement aux événements pour la rubrique ci-dessus à l’aide de la commande New-AzEventGridSystemTopicEventSubscription.

L’exemple de commande suivant crée un abonnement à un événement pour les événements CreatedOrUpdated et Deleted. Si vous ne spécifiez pas IncludedEventType, tous les types d’événements sont inclus par défaut.

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. Sur la page Rubrique système Event Grid, sélectionnez Abonnement à un événement dans la barre d’outils.

2. Vérifiez que les sections Type de rubrique, Ressource source et Nom de rubrique sont automatiquement renseignées.

3. Entrez un nom pour l’abonnement aux événements.

4. Pour Filtrer sur les types d’événements, sélectionnez l’événement, par exemple, CreatedOrUpdated ou Deleted.

   

5. Sélectionnez un type de point de terminaison.

6. Configurez le gestionnaire d’événements en fonction du type de point de terminaison que vous avez sélectionné. Dans l’exemple suivant, un hub d’événements Azure est sélectionné.

   

7. Sélectionnez l’onglet Filtres pour fournir le filtrage d’objet et le filtrage avancé. Par exemple, pour filtrer les événements à partir de ressources dans un groupe de ressources spécifique, procédez comme suit :

   1. Sélectionnez Activer le filtrage d’objet.

   2. Dans la section Filtres d’objet, pour L’objet commence par, indiquez la valeur du groupe de ressources au format suivant : /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Sélectionnez ensuite Créer pour créer l’abonnement à un événement.

Supprimer un abonnement aux événements et une rubrique système

Azure CLI

Pour supprimer l’abonnement aux événements, utilisez la commande az eventgrid system-topic event-subscription delete. Voici un exemple :

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

Pour supprimer la rubrique système, utilisez la commande az eventgrid system-topic delete. Voici un exemple :

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

Azure PowerShell

Pour supprimer un abonnement aux événements, utilisez la commande Remove-AzEventGridSystemTopicEventSubscription. Voici un exemple :

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

Pour supprimer la rubrique système, utilisez la commande Remove-AzEventGridSystemTopic. Voici un exemple :

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Azure portal

1. Connectez-vous au portail Azure.
2. Dans la barre de recherche, tapez Rubriques système Event Grid, puis appuyez sur Entrée.
3. Sélectionnez la rubrique système.
4. Dans la page Rubrique système Event Grid, sélectionnez Supprimer dans la barre d’outils.

Exemples de filtrage

S’abonner aux notifications de création, mise à jour, suppression de machines virtuelles dans un abonnement Azure

Cette section présente un exemple de filtrage d’abonnement aux notification de création, mise à jour et suppression de machines virtuelles dans un abonnement Azure.

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. Choisissez des types d’événements CreatedOrUpdated et Deleted.

2. Sous l’onglet Filtres de l’abonnement aux événements, choisissez les filtres avancés suivants.

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

S’abonner aux notifications de création, mise à jour et suppression de machine virtuelle selon un groupe de ressources particulier

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

Dans l’onglet Filtres de l’abonnement à un événement, activez le filtrage d’objet et utilisez le filtre d’objet suivant :

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

Choisissez ensuite les filtres avancés suivants.

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

S’abonner aux notifications de création et de mise à jour de machines virtuelles selon un emplacement particulier dans un 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

Dans l’onglet Filtres de l’abonnement à un événement, activez le filtrage d’objet et utilisez le filtre d’objet suivant :

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

Choisissez ensuite les filtres avancés suivants.

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

AND

Clé = « data.resourceInfo.type », Opérateur = « String ends with » Valeur = « virtualMachines »

Nous contacter

Si vous avez des questions ou des commentaires sur cette fonctionnalité, n’hésitez pas à nous contacter à arnsupport@microsoft.com.

Pour obtenir des commentaires spécifiques sur un événement donné, fournissez les informations suivantes :

Pour des événements manquants :

• Nom du type de la rubrique système
• Horodatage approximatif au format UTC de l’exécution de l’opération
• ID de ressource de base pour lequel la notification a été générée
• Accédez à votre ressource dans le portail Azure et sélectionnez la vue JSON en haut à droite. L’ID de ressource est le premier champ de la page de vue JSON.
• Type d’événement attendu
• Opération exécutée (par exemple, machine virtuelle démarrée ou arrêtée, compte de stockage créé, etc.)
• Description du problème rencontré (par exemple, machine virtuelle démarrée et aucun événement Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged généré)
• Si possible, indiquez l’ID de corrélation de l’opération exécutée

Pour un événement qui a été retardé ou qui a un contenu inattendu

• Nom du type de la rubrique système
• Contenu entier de la notification sans data.resourceInfo.properties
• Description du problème rencontré et valeurs de champ impactées

Vérifiez que vous ne fournissez aucune information d’identification de l’utilisateur final quand vous partagez ces données.

Étapes suivantes

Pour plus d’informations sur ces événements, consultez Notifications des ressources Azure - Événements de ressources.