Consulta de suscripciones de Event Grid

En este artículo se describe cómo enumerar las suscripciones de Event Grid en la suscripción de Azure. Al consultar las suscripciones de Event Grid existentes, es importante comprender los distintos tipos de suscripciones. Proporcione parámetros diferentes en función del tipo de suscripción que desee obtener.

Nota:

Se recomienda usar el módulo de PowerShell de Azure Az para interactuar con Azure. Para comenzar, consulte Instalación de Azure PowerShell. Para obtener información sobre cómo migrar al módulo Az PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

Grupos de recursos y suscripciones de Azure

Las suscripciones y los grupos de recursos de Azure no son recursos de Azure. Por lo tanto, las suscripciones de Event Grid a grupos de recursos o suscripciones de Azure no tienen las mismas propiedades que las suscripciones de Event Grid a los recursos de Azure. Las suscripciones de Event Grid a grupos de recursos o suscripciones de Azure se consideran globales.

Para obtener suscripciones de Event Grid para una suscripción de Azure y sus grupos de recursos, no es necesario proporcionar ningún parámetro. Asegúrese de que ha seleccionado la suscripción de Azure que desea consultar. En los ejemplos siguientes no se obtienen suscripciones de Event Grid para temas personalizados ni recursos de Azure.

Para Azure CLI, utilice:

az account set -s "My Azure Subscription"
az eventgrid event-subscription list

Para PowerShell, usar:

Set-AzContext -Subscription "My Azure Subscription"
Get-AzEventGridSubscription

Para obtener suscripciones de Event Grid para una suscripción de Azure, proporcione el tipo de tema Microsoft.Resources.Subscriptions.

Para Azure CLI, utilice:

az eventgrid event-subscription list --topic-type-name "Microsoft.Resources.Subscriptions" --location global

Para PowerShell, usar:

Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.Subscriptions"

Para obtener suscripciones de Event Grid para todos los grupos de recursos dentro de una suscripción de Azure, proporcione el tipo de tema Microsoft.Resources.ResourceGroups.

Para Azure CLI, utilice:

az eventgrid event-subscription list --topic-type-name "Microsoft.Resources.ResourceGroups" --location global

Para PowerShell, usar:

Get-AzEventGridSubscription -TopicTypeName "Microsoft.Resources.ResourceGroups"

Para obtener suscripciones de Event Grid para un grupo de recursos especificado, proporcione el nombre del grupo de recursos como parámetro.

Para Azure CLI, utilice:

az eventgrid event-subscription list --resource-group myResourceGroup --location global

Para PowerShell, usar:

Get-AzEventGridSubscription -ResourceGroupName myResourceGroup

Temas personalizados y recursos de Azure

Los temas personalizados de Event Grid son recursos de Azure. Por lo tanto, puede consultar suscripciones de Event Grid para temas personalizados y otros recursos, como la cuenta de Blob Storage, de la misma manera. Para obtener suscripciones de Event Grid para temas personalizados, debe proporcionar parámetros que identifiquen el recurso o identifiquen la ubicación del recurso. No es posible realizar consultas amplias de suscripciones de Event Grid para recursos en toda la suscripción de Azure.

Para obtener suscripciones de Event Grid para temas personalizados y otros recursos en una ubicación, proporcione el nombre de la ubicación.

Para Azure CLI, utilice:

az eventgrid event-subscription list --location westus2

Para PowerShell, usar:

Get-AzEventGridSubscription -Location westus2

Para obtener suscripciones a temas personalizados para una ubicación, proporcione la ubicación y el tipo de tema Microsoft.EventGrid.Topics.

Para Azure CLI, utilice:

az eventgrid event-subscription list --topic-type-name "Microsoft.EventGrid.Topics" --location "westus2"

Para PowerShell, usar:

Get-AzEventGridSubscription -TopicTypeName "Microsoft.EventGrid.Topics" -Location westus2

Para obtener suscripciones a cuentas de almacenamiento para una ubicación, proporcione la ubicación y el tipo de tema Microsoft.Storage.StorageAccounts.

Para Azure CLI, utilice:

az eventgrid event-subscription list --topic-type "Microsoft.Storage.StorageAccounts" --location westus2

Para PowerShell, usar:

Get-AzEventGridSubscription -TopicTypeName "Microsoft.Storage.StorageAccounts" -Location westus2

Para obtener suscripciones de Event Grid para un tema personalizado, proporcione el nombre del tema personalizado y el nombre de su grupo de recursos.

Para Azure CLI, utilice:

az eventgrid event-subscription list --topic-name myCustomTopic --resource-group myResourceGroup

Para PowerShell, usar:

Get-AzEventGridSubscription -TopicName myCustomTopic -ResourceGroupName myResourceGroup

Para obtener suscripciones de Event Grid para un recurso determinado, proporcione el identificador de recurso.

Para Azure CLI, utilice:

resourceid=$(az storage account show -g myResourceGroup -n myStorageAccount --query id --output tsv)
az eventgrid event-subscription list --resource-id $resourceid

Para PowerShell, usar:

$resourceid = (Get-AzResource -Name mystorage -ResourceGroupName myResourceGroup).ResourceId
Get-AzEventGridSubscription -ResourceId $resourceid

Pasos siguientes

• Para obtener información acerca de los reintentos y las entregas de eventos, consulte Entrega y reintentos de entrega de mensajes en Event Grid.
• Para obtener una introducción a Event Grid, vea Acerca de Event Grid.
• Para comenzar a usar rápidamente Event Grid, vea Creación y enrutamiento de eventos personalizados con Azure Event Grid.