Criar, ver e gerir tópicos do sistema do Event Grid com a CLI do Azure

Artigo
06/01/2023

Este artigo mostra-lhe como criar e gerir tópicos de sistema com a CLI do Azure. Para obter uma descrição geral dos tópicos do sistema, veja Tópicos do sistema.

Instalar a extensão da CLI do Azure

Para a CLI do Azure, precisa da extensão do Event Grid.

Em Cloud Shell:

Se tiver instalado a extensão anteriormente, atualize-a: az extension update -n eventgrid
Se ainda não instalou a extensão, instale-a: az extension add -n eventgrid

Para uma instalação local:

Instale a CLI do Azure. Certifique-se de que tem a versão mais recente ao verificar com az --version.
Desinstalar 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 de sistema

Para criar primeiro um tópico de sistema numa origem do Azure e, em seguida, criar uma subscrição de evento para esse tópico, veja 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 topic-type valores que pode utilizar para criar um tópico de sistema, execute o seguinte comando. Estes valores de tipo de tópico representam as origens de eventos que suportam a criação de tópicos de sistema. Ignore Microsoft.EventGrid.Topics e Microsoft.EventGrid.Domains na 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 de sistema (implicitamente) ao criar uma subscrição de eventos para uma origem do Azure, utilize o método az eventgrid event-subscription create . Eis 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 passo a passo, veja Subscrever a conta de armazenamento.

Ver todos os tópicos do sistema

Para ver todos os tópicos e detalhes do sistema de um tópico de sistema selecionado, utilize 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>

Eliminar um tópico de sistema

Para eliminar um tópico de sistema, utilize o seguinte comando:

az eventgrid system-topic delete

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

Passos seguintes

Veja a secção Tópicos do sistema na Azure Event Grid para saber mais sobre os tópicos de sistema e os tipos de tópicos suportados pelo Azure Event Grid.

Partilhar via