Event Grid-systeemonderwerpen maken, weergeven en beheren met behulp van Azure CLI

  • Artikel

In dit artikel wordt beschreven hoe u systeemonderwerpen maakt en beheert met behulp van Azure CLI. Zie Systeemonderwerpen voor een overzicht van systeemonderwerpen.

Extensie voor Azure CLI installeren

Voor Azure CLI hebt u de Event Grid-extensie nodig.

In Cloud Shell:

  • Als u de extensie eerder hebt geïnstalleerd, werkt u deze bij: az extension update -n eventgrid
  • Als u de extensie nog niet eerder hebt geïnstalleerd, installeert u deze: az extension add -n eventgrid

Voor een lokale installatie:

  1. Installeer de Azure CLI. Zorg ervoor dat u de nieuwste versie hebt door dit te controleren met az --version.
  2. Verwijder eerdere versies van de extensie: az extension remove -n eventgrid
  3. Installeer de eventgrid-extensie met az extension add -n eventgrid

Een systeemonderwerp maken

  • Als u eerst een systeemonderwerp wilt maken in een Azure-bron en vervolgens een gebeurtenisabonnement voor dat onderwerp wilt maken, raadpleegt u de volgende naslagonderwerpen:

    • 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

      Voer de volgende opdracht uit voor een lijst topic-type met waarden die u kunt gebruiken om een systeemonderwerp te maken. Deze onderwerptypewaarden vertegenwoordigen de gebeurtenisbronnen die ondersteuning bieden voor het maken van systeemonderwerpen. Microsoft.EventGrid.Topics Negeer en Microsoft.EventGrid.Domains uit de lijst.

      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>

  • Als u (impliciet) een systeemonderwerp wilt maken bij het maken van een gebeurtenisabonnement voor een Azure-bron, gebruikt u de methode az eventgrid event-subscription create . Hier volgt een voorbeeld:

    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

    Zie Abonneren op opslagaccount voor een zelfstudie met stapsgewijze instructies.

Alle systeemonderwerpen weergeven

Als u alle systeemonderwerpen en details van een geselecteerd systeemonderwerp wilt weergeven, gebruikt u de volgende opdrachten:

Een systeemonderwerp verwijderen

Gebruik de volgende opdracht om een systeemonderwerp te verwijderen:

Volgende stappen

Zie de sectie Systeemonderwerpen in Azure Event Grid voor meer informatie over systeemonderwerpen en onderwerptypen die door Azure Event Grid worden ondersteund.