Share via


Creare, visualizzare e gestire gli argomenti del sistema griglia di eventi usando l'interfaccia della riga di comando di Azure

Questo articolo illustra come creare e gestire gli argomenti di sistema usando l'interfaccia della riga di comando di Azure. Per una panoramica degli argomenti di sistema, vedere Argomenti di sistema.

Installare l'estensione per l'interfaccia della riga di comando di Azure

Per l'interfaccia della riga di comando di Azure, è necessaria l'estensione Griglia di eventi.

In Cloud Shell:

  • Se l'estensione è stata installata in precedenza, aggiornarla: az extension update -n eventgrid
  • Se l'estensione non è stata installata in precedenza, installarla: az extension add -n eventgrid

Per un'installazione locale:

  1. Installare l'interfaccia della riga di comando di Azure Assicurarsi di avere la versione più recente installata controllando con az --version.
  2. Disinstallare le versioni precedenti dell'estensione: az extension remove -n eventgrid
  3. Installare l'estensione eventgrid con az extension add -n eventgrid

Creare un argomento di sistema

  • Per creare prima un argomento di sistema in un'origine di Azure e quindi creare una sottoscrizione di eventi per tale argomento, vedere gli argomenti di riferimento seguenti:

    • 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
      

      Per un elenco di topic-type valori che è possibile usare per creare un argomento di sistema, eseguire il comando seguente. Questi valori dei tipi di argomento rappresentano le origini eventi che supportano la creazione di argomenti di sistema. Ignorare Microsoft.EventGrid.Topics e Microsoft.EventGrid.Domains dall'elenco.

      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>		  
      
  • Per creare un argomento di sistema (in modo implicito) quando si crea una sottoscrizione di eventi per un'origine di Azure, usare il metodo az eventgrid event-subscription create . Ecco un esempio:

    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
    

    Per un'esercitazione con istruzioni dettagliate, vedere Sottoscrivere l'account di archiviazione.

Visualizzare tutti gli argomenti di sistema

Per visualizzare tutti gli argomenti di sistema e i dettagli di un argomento di sistema selezionato, usare i comandi seguenti:

Eliminare un argomento di sistema

Per eliminare un argomento di sistema, usare il comando seguente:

Passaggi successivi

Per altre informazioni sugli argomenti di sistema e sui tipi di argomento supportati da Griglia di eventi di Azure, vedere la sezione Argomenti di sistema in Griglia di eventi di Azure.