Suscripción a eventos de Administración de recursos de Azure en Event Grid (versión preliminar)

En este artículo se explican los pasos necesarios para suscribirse a eventos publicados por notificaciones de recursos de Azure: recursos Para obtener información detallada sobre estos eventos, consulte Notificaciones de recursos de Azure: eventos de recursos.

Creación de un tema del sistema de recursos

En esta sección se muestra cómo crear un tema del sistema de tipo microsoft.resourcenotifications.resources.

CLI de Azure

1. Establecer la cuenta en la suscripción de Azure en la que desea crear el tema del sistema.

   az account set –s AZURESUBSCRIPTIONID
   

2. Crear un tema del sistema de tipo microsoft.resourcenotifications.resources mediante el comando 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. Establecer la cuenta en la suscripción de Azure en la que desea crear el tema del sistema.

   Set-AzContext -Subscription AZURESUBSCRIPTIONID
   

2. Cree un tema del sistema de tipo microsoft.resourcenotifications.resources con el comando New-AzEventGridSystemTopic.

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

Azure Portal

1. Inicie sesión en Azure Portal.

2. En la barra de búsqueda, escriba Temas del sistema de Event Grid y selecciónelo en la lista desplegable.

3. En la página Temas del sistema de Event Grid, seleccione Crear en la barra de herramientas.

4. En la página Crear tema del sistema de Event Grid, seleccione Administración de recursos de Azure: versión preliminar para el Tipo de tema.

   

5. Seleccione el grupo de recursos en el que desea crear el tema del sistema.

6. Escriba un nombre para el tema del sistema.

7. Seleccionar Revisar y crear.

8. En la página Revisar y crear, seleccione Crear.

9. En la página de implementación correcta, seleccione Ir al recurso para ir a la página del tema del sistema. Verá los detalles sobre el tema del sistema en esta página.

Suscripción a los eventos

CLI de Azure

Cree una suscripción al evento para el tema anterior mediante el comando az eventgrid system-topic event-subscription create.

El siguiente comando de ejemplo crea una suscripción al evento para los eventos CreatedOrUpdated y Deleted. Si no especifica included-event-types, todos los tipos de eventos se incluyen de forma predeterminada.

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

Cree una suscripción al evento para el tema anterior mediante el comando New-AzEventGridSystemTopicEventSubscription.

El siguiente comando de ejemplo crea una suscripción al evento para los eventos CreatedOrUpdated y Deleted. Si no especifica IncludedEventType, todos los tipos de eventos se incluyen de forma predeterminada.

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. En la página Tema del sistema de Event Grid, seleccione Suscripción a evento en la barra de herramientas.

2. Confirme que los campos Topic Type (Tipo de tema), Source Resource (Recurso de origen) y Topic Name (Nombre del tema) se rellenan automáticamente.

3. Escriba un nombre para la suscripción a eventos.

4. En Filtro para tipos de evento, seleccione el evento, por ejemplo, CreatedOrUpdated o Deleted.

   

5. Seleccionar el tipo de punto de conexión.

6. Configure el controlador de eventos en función del tipo de punto de conexión seleccionado. En el ejemplo siguiente, se selecciona un centro de eventos de Azure.

   

7. Seleccione la pestaña Filtros para proporcionar el filtrado de asunto y el filtrado avanzado. Por ejemplo, para filtrar los eventos de los recursos de un grupo de recursos específico, siga estos pasos:

   1. Seleccione Habilitar el filtrado del asunto.

   2. En la sección Filtros de asunto, para Asunto comienza con, proporcione el valor del grupo de recursos en este formato: /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}.

      

8. Seleccione Create (Crear) para guardar la suscripción de eventos.

Eliminar la suscripción al evento y el tema del sistema

CLI de Azure

Para eliminar la suscripción al evento, use el comando az eventgrid system-topic event-subscription delete. Este es un ejemplo:

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

Para eliminar el tema del sistema, use el comando az eventgrid system-topic delete. Este es un ejemplo:

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

Azure PowerShell

Para eliminar una suscripción al evento, use el comando Remove-AzEventGridSystemTopicEventSubscription. Este es un ejemplo:

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

Para eliminar el tema del sistema, use el comando Remove-AzEventGridSystemTopic. Este es un ejemplo:

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

Azure Portal

1. Inicie sesión en Azure Portal.
2. En la barra de búsqueda, escriba Temas del sistema de Event Grid y presione ENTRAR.
3. Seleccione el tema del sistema.
4. En la página Event Grid System Topic (Tema del sistema de Event Grid), seleccione Delete (Eliminar) en la barra de herramientas.

Ejemplos de filtrado

Suscripción a notificaciones de creación, actualización y eliminación de máquinas virtuales en una suscripción de Azure

En esta sección se muestra el ejemplo de filtrado de suscripción a notificaciones de creación, actualización y eliminación de máquinas virtuales en una suscripción de Azure.

CLI de Azure

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. Elija los tipos de evento CreatedOrUpdated y Deleted.

2. En la pestaña Filtros de la suscripción al evento, elija los siguientes filtros avanzados.

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

Suscripción de un grupo de recursos concreto a notificaciones de creación, actualización y eliminación de máquinas virtuales

CLI de Azure

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

En la pestaña Filtros de la suscripción de eventos, habilite el filtrado del asunto y use el filtro de asunto siguiente:

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

A continuación, elija los siguientes filtros avanzados.

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

Suscripción de una ubicación concreta a notificaciones de creación y actualización de máquinas virtuales en una suscripción

CLI de Azure

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

En la pestaña Filtros de la suscripción de eventos, habilite el filtrado del asunto y use el filtro de asunto siguiente:

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

A continuación, elija los siguientes filtros avanzados.

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

y

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

Ponerse en contacto con nosotros

Si tiene alguna pregunta o comentarios sobre esta característica, no dude en ponerse en contacto con nosotros en arnsupport@microsoft.com.

Para ayudarle mejor con comentarios específicos sobre un determinado evento, proporcione la siguiente información:

Para los eventos que faltan:

• Nombre del tipo de tema del sistema
• Marca de tiempo aproximada en UTC de cuando se ejecutó la operación
• Identificador de recurso base para el que se generó la notificación
• Vaya al recurso en Azure Portal y seleccione la vista JSON en la esquina derecha. El identificador de recurso es el primer campo de la página de vista JSON.
• Tipo de evento esperado
• Operación ejecutada (por ejemplo, máquina virtual iniciada o detenida, cuenta de almacenamiento creada, etc.)
• Descripción del problema detectado (por ejemplo, máquina virtual iniciada y no se generó ningún evento Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
• Si es posible, proporcione el identificador de correlación de la operación ejecutada.

Para los eventos que se han retrasado o que tienen contenido inesperado:

• Nombre del tipo de tema del sistema
• Todo el contenido de la notificación, excepto data.resourceInfo.properties
• Descripción del problema detectado y los valores de campo afectados

Asegúrese de que no proporciona información de identificación del usuario final mientras comparte estos datos.

Pasos siguientes

Para obtener información detallada sobre estos eventos, consulte Notificaciones de recursos de Azure: eventos de recursos.