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

Este artigo mostra como criar e gerenciar tópicos do sistema usando a CLI do Azure. Para obter uma visão geral dos tópicos do sistema, consulte os tópicos do sistema.

Instalar a extensão para a CLI do Azure

Para a CLI do Azure, você precisa da 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ê ainda não instalou a extensão anteriormente, instale-a: az extension add -n eventgrid

Para uma instalação local:

1. Instale a CLI do Azure. Verifique se você tem a versão mais recente verificando com az --version.
2. Desinstale as 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 do sistema

• Para criar um tópico do sistema em uma fonte do Azure primeiro e, em seguida, criar uma assinatura de evento para esse tópico, consulte 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 você pode usar para criar um tópico do sistema, execute o comando a seguir. Esses valores de tipo de tópico representam as fontes de evento 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 . Veja 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 um tutorial com instruções passo a passo, consulte Subscrever a conta de armazenamento.

Exibir todos os tópicos do sistema

Para exibir todos os tópicos de sistema e os detalhes de um tópico de 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 

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