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

  • Artigo

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:

  1. Instale a CLI do Azure. Certifique-se de que tem a versão mais recente ao verificar com az --version.
  2. Desinstalar versões anteriores da extensão: az extension remove -n eventgrid
  3. 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:

Eliminar um tópico de sistema

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

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.