Consultar subscrições da Grelha de Eventos
Este artigo descreve como listar as assinaturas da Grade de Eventos em sua assinatura do Azure. Ao consultar suas assinaturas existentes da Grade de Eventos, é importante entender os diferentes tipos de assinaturas. Você fornece parâmetros diferentes com base no tipo de assinatura que deseja obter.
Nota
Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.
Grupos de recursos e assinaturas do Azure
As subscrições e grupos de recursos do Azure não são recursos do Azure. Portanto, as assinaturas de Grade de Eventos para grupos de recursos ou assinaturas do Azure não têm as mesmas propriedades que as assinaturas de Grade de Eventos para recursos do Azure. As subscrições da Grelha de Eventos para grupos de recursos ou subscrições 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 parâmetros. Certifique-se de que selecionou a subscrição do Azure que pretende 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, 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 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, 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 assinaturas de 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, 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 assinaturas de 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, 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
Os tópicos personalizados da Grade de Eventos são recursos do Azure. Portanto, você consulta assinaturas de Grade de Eventos para tópicos personalizados e outros recursos, como conta de armazenamento de Blob, da mesma maneira. Para obter assinaturas de Grade de Eventos para tópicos personalizados, você deve fornecer parâmetros que identifiquem o recurso ou o local do recurso. Não é possível consultar amplamente 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, utilize:
az eventgrid event-subscription list --location westus2
Para o PowerShell, utilize:
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, 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 assinaturas de 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, 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 assinaturas da Grade de Eventos para um tópico personalizado, forneça o nome do tópico personalizado e o nome de 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 assinaturas da Grade de Eventos para um recurso específico, forneça a 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
Próximos passos
- 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.