Consultar subscrições do Event Grid

Este artigo descreve como listar as subscrições do Event Grid na sua subscrição do Azure. Ao consultar as suas subscrições existentes do Event Grid, é importante compreender os diferentes tipos de subscrições. Forneces parâmetros diferentes consoante o tipo de subscrição que queres obter.

Observação

Recomendamos que utilize o módulo Azure Az PowerShell para interagir com o Azure. Para começar, veja Install Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, veja Migrate Azure PowerShell from AzureRM to Az.

Grupos de recursos e subscrições Azure

As subscrições e grupos de recursos do Azure não são recursos do Azure. Portanto, as subscrições Event Grid a grupos de recursos ou subscrições Azure não têm as mesmas propriedades que as subscrições Event Grid para recursos Azure. As subscrições do Event Grid a grupos de recursos ou subscrições Azure são consideradas globais.

Para obter subscrições do Event Grid para uma subscrição Azure e os seus grupos de recursos, não precisa de fornecer quaisquer parâmetros. Certifica-te de que selecionaste a subscrição do Azure que queres consultar. Os exemplos seguintes não recebem subscrições do Event Grid para tópicos personalizados ou recursos do Azure.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Para obter subscrições do Event Grid para uma subscrição do Azure, forneça o tipo de tópico Microsoft.Resources.Subscriptions.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Para obter subscrições Event Grid para todos os grupos de recursos dentro de uma subscrição Azure, forneça o tipo de tópico Microsoft.Resources.ResourceGroups.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Para obter subscrições do Event Grid para um grupo de recursos especificado, forneça o nome desse grupo como parâmetro.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

Get-AzEventGridSubscription -ResourceGroupName myResourceGroup

Tópicos personalizados e recursos do Azure

Tópicos personalizados do Event Grid são recursos Azure. Por isso, consulta subscrições do Event Grid para tópicos personalizados e outros recursos, como a conta de armazenamento Blob, da mesma forma. Para obter subscrições do Event Grid para tópicos personalizados, deve fornecer parâmetros que identifiquem o recurso ou a localização do recurso. Não é possível consultar de forma geral as subscrições do Event Grid para obter recursos em toda a tua subscrição do Azure.

Para obter subscrições do Event Grid para tópicos personalizados e outros recursos num local, forneça o nome do local.

Para a CLI do Azure, utilize:

az eventgrid event-subscription list --location westus2

Para o PowerShell, utilize:

Get-AzEventGridSubscription -Location westus2

Para obter subscrições de tópicos personalizados para uma localização, forneça a localização e o tipo de tema Microsoft.EventGrid.Topics.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Para obter subscrições de contas de armazenamento para uma localização, forneça a localização e o tipo de tópico Microsoft.Storage.StorageAccounts.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Para obter subscrições do Event Grid para um tema personalizado, forneça o nome do tema personalizado e o nome do seu grupo de recursos.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

Get-AzEventGridSubscription -TopicName myCustomTopic -ResourceGroupName myResourceGroup

Para obter subscrições do Event Grid para um determinado recurso, forneça o ID do recurso.

Para a CLI do Azure, utilize:

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

Para o PowerShell, utilize:

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

Passos seguintes

• Para obter informações sobre entrega e tentativas de eventos, entrega e repetição de mensagens da Grade de Eventos.
• Para obter uma introdução ao Event Grid, veja Sobre o Azure Event Grid.
• Para começar rapidamente a usar a Grade de Eventos, consulte Criar e rotear eventos personalizados com a Grade de Eventos do Azure.