Erstellen, Anzeigen und Verwalten von Systemthemen in Azure Event Grid mithilfe der Azure CLI

In diesem Artikel wird beschrieben, wie Sie Systemthemen mithilfe der Azure CLI im Azure-Portal erstellen und verwalten. Eine Übersicht zu Systemthemen finden Sie unter Systemthemen.

Installieren der Erweiterung für Azure CLI

Für die Azure CLI benötigen Sie die Event Grid-Erweiterung.

In Cloud Shell:

• Wenn Sie die Erweiterung bereits installiert haben, aktualisieren Sie sie mit az extension update -n eventgrid.
• Wenn Sie die Erweiterung noch nicht installiert haben, installieren Sie sie: az extension add -n eventgrid

Für eine lokale Installation:

1. Installieren Sie die Azure-Befehlszeilenschnittstelle. Vergewissern Sie sich mit az --version, dass Sie über die aktuelle Version verfügen.
2. Deinstallieren Sie frühere Versionen der Erweiterung mit az extension remove -n eventgrid.
3. Installieren Sie die eventgrid-Erweiterung mit az extension add -n eventgrid.

Erstellen eines Systemthemas

• Wenn Sie zunächst ein Systemthema in einer Azure-Quelle und anschließend ein Ereignisabonnement für das Thema erstellen möchten, lesen Sie die folgenden Referenzartikel:

  • 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
    

    Wenn Sie eine Liste der Werte von topic-type abrufen möchten, mit denen Sie ein Systemthema erstellen können, führen Sie den folgenden Befehl aus. Diese topic-type-Werte stellen die Ereignisquellen dar, die die Erstellung von Systemthemen unterstützen. Die Listenwerte Microsoft.EventGrid.Topics und Microsoft.EventGrid.Domains können Sie ignorieren.

    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>		  
    

• Wenn Sie ein Systemthema (implizit) beim Erstellen eines Ereignisabonnements für eine Azure-Quelle erstellen möchten, verwenden Sie die Methode az eventgrid event-subscription create. Hier sehen Sie ein Beispiel:

  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
  

  Ein Tutorial mit einer ausführlichen Anleitung finden Sie unter Abonnieren eines Speicherkontos.

Anzeigen aller Systemthemen

Wenn Sie alle Systemthemen sowie die Details zu einem bestimmten System anzeigen möchten, führen Sie die folgenden Befehle aus:

• 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>	 
  

Löscht ein Systemthema

Wenn Sie ein Thema löschen möchten, führen Sie den folgenden Befehl aus:

• az eventgrid system-topic delete

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

Nächste Schritte

Im Abschnitt Systemthemen in Azure Event Grid erfahren Sie mehr über Systemthemen und Thementypen, die von Azure Event Grid unterstützt werden.