Consultar assinaturas de Grade de Eventos

Este artigo descreve como listar as assinaturas de Grade de Eventos em sua assinatura do Azure. Ao consultar as assinaturas existentes de Grade de Eventos, é importante entender os diferentes tipos de assinaturas. Você fornecer parâmetros diferentes com base no tipo de assinatura que deseja obter.

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Grupos de recursos e assinaturas do Azure

Os grupos de recursos e as assinaturas do Azure não são recursos do Azure. Portanto, as assinaturas da Grade de Eventos para grupos de recursos ou assinaturas do Azure não têm as mesmas propriedades que as assinaturas da Grade de Eventos para recursos do Azure. As assinaturas da Grade de Eventos para grupos de recursos ou assinaturas do Azure são consideradas globais.

Para obter assinaturas da Grade de Eventos para uma assinatura do Azure e seus grupos de recursos, você não precisa fornecer nenhum parâmetro. Certifique-se de que tenha selecionado a assinatura do Azure que você deseja consultar. Os exemplos a seguir não obtêm assinaturas da Grade de Eventos para tópicos personalizados ou recursos do Azure.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Para obter assinaturas da Grade de Eventos para uma assinatura do Azure, forneça o tipo de tópico Microsoft.Resources.Subscriptions.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Para obter assinaturas da Grade de Eventos para todos os grupos de recursos em uma assinatura do Azure, forneça o tipo de tópico Microsoft.Resources.ResourceGroups.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Para obter assinaturas da Grade de Eventos para um grupo de recursos especificado, forneça o nome do grupo de recursos como um parâmetro.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

Get-AzEventGridSubscription -ResourceGroupName myResourceGroup

Tópicos personalizados e recursos do Azure

Os tópicos personalizados da Grade de Eventos são recursos do Azure. Portanto, consulte as assinaturas da Grade de Eventos para tópicos personalizados e outros recursos, como a conta de armazenamento de Blobs, da mesma forma. Para obter assinaturas da Grade de Eventos para tópicos personalizados, você deve fornecer parâmetros que identifiquem o recurso ou a localização do recurso. Não é possível consultar amplamente as assinaturas da Grade de Eventos para recursos em sua assinatura do Azure.

Para obter assinaturas da Grade de Eventos para tópicos personalizados e outros recursos em um local, forneça o nome do local.

Para a CLI do Azure, use:

az eventgrid event-subscription list --location westus2

Para o PowerShell, use:

Get-AzEventGridSubscription -Location westus2

Para obter assinaturas de tópicos personalizados para um local, forneça o local e o tipo de tópico de Microsoft.EventGrid.Topics.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Para obter as assinaturas para contas de armazenamento para um local, forneça o local e o tipo de tópico de Microsoft.Storage.StorageAccounts.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Para obter assinaturas da Grade de Eventos para um tópico personalizado, forneça o nome do tópico personalizado e o nome do seu grupo de recursos.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

Get-AzEventGridSubscription -TopicName myCustomTopic -ResourceGroupName myResourceGroup

Para obter assinaturas da Grade de Eventos para um recurso específico, forneça a ID do recurso.

Para a CLI do Azure, use:

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

Para o PowerShell, use:

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

Próximas etapas

• Para obter informações sobre a entrega de eventos e repetições, Entrega e repetição de mensagens da Grade de Eventos.
• Para ver uma introdução à Grade de Eventos, confira About Event Grid (Sobre a Grade de Eventos).
• Para começar a usar rapidamente a Grade de Eventos, confira Create and route custom events with Azure Event Grid (Criar e rotear eventos personalizados com a Grade de Eventos do Azure).