Criar, exibir e gerenciar tópicos do sistema da Grade de Eventos usando a CLI do Azure

Artigo
06/01/2023

Este artigo mostra como criar e gerenciar tópicos do sistema usando a CLI do Azure. Para uma visão geral sobre tópicos do sistema, confira Tópicos do sistema.

Instalar extensão para CLI do Azure

Para Azure CLI, é necessária a extensão da Grade de Eventos.

No Cloud Shell:

Se você instalou a extensão anteriormente, atualize-a: az extension update -n eventgrid
Se você não instalou a extensão anteriormente, instale-a: az extension add -n eventgrid

Para uma instalação local:

Instale a CLI do Azure. Certifique-se de você tem a versão mais recente, verificando com o az --version.
Desinstale as versões anteriores da extensão: az extension remove -n eventgrid
Instalar a extensão eventgrid com az extension add -n eventgrid

Criar um tópico do sistema

Para criar um tópico do sistema primeiro em uma fonte do Azure e depois criar uma assinatura de evento para esse tópico, confira os seguintes tópicos de referência:

az eventgrid system-topic create

# Get the ID of the Azure source (for example: Azure Storage account)
storageid=$(az storage account show \
        --name <AZURE STORAGE ACCOUNT NAME> \
        --resource-group <AZURE RESOURCE GROUP NAME> \
            --query id --output tsv)

# Create the system topic on the Azure source (example: Azure Storage account)
az eventgrid system-topic create \
    -g <AZURE RESOURCE GROUP NAME> \
    --name <SPECIFY SYSTEM TOPIC NAME> \
    --location <LOCATION> \
    --topic-type microsoft.storage.storageaccounts \
    --source $storageid

Para obter uma lista de valores topic-type que você poderá usar para criar um tópico do sistema, execute o comando a seguir. Esses valores de tipo de tópico representam as fontes de eventos que dão suporte à criação de tópicos do sistema. Ignore Microsoft.EventGrid.Topics e Microsoft.EventGrid.Domains da lista.

az eventgrid topic-type  list --output json | grep -w id

az eventgrid system-topic event-subscription create

az eventgrid system-topic event-subscription create --name <SPECIFY EVENT SUBSCRIPTION NAME> \
    -g rg1 --system-topic-name <SYSTEM TOPIC NAME> \
    --endpoint <ENDPOINT URL>

Para criar um tópico do sistema (implicitamente) ao criar uma assinatura de evento para uma fonte do Azure, use o método az eventgrid event-subscription create. Aqui está um exemplo:

storageid=$(az storage account show --name <AZURE STORAGE ACCOUNT NAME> --resource-group <AZURE RESOURCE GROUP NAME> --query id --output tsv)
endpoint=<ENDPOINT URL>

az eventgrid event-subscription create \
  --source-resource-id $storageid \
  --name <EVENT SUBSCRIPTION NAME> \
  --endpoint $endpoint

Para obter um tutorial com instruções detalhadas, confira Assinar a conta de armazenamento.

Exibir todos os tópicos do sistema

Para ver todos os tópicos do sistema e os detalhes de um tópico do sistema selecionado, use os seguintes comandos:

az eventgrid system-topic list
```
az eventgrid system-topic list	 
```

az eventgrid system-topic show

az eventgrid system-topic show -g <AZURE RESOURCE GROUP NAME> -n <SYSTEM TOPIC NAME>

Excluir um tópico do sistema

Para excluir um tópico do sistema, use o seguinte comando:

az eventgrid system-topic delete

az eventgrid system-topic delete -g <AZURE RESOURCE GROUP NAME> --name <SYSTEM TOPIC NAME>

Próximas etapas

Confira a seção Tópicos do sistema na Grade de Eventos do Azure para saber mais sobre os tópicos do sistema e os tipos de tópico compatíveis com a Grade de Eventos do Azure.

Compartilhar via