Freigeben über

Erstellen, Anzeigen und Verwalten von Ereignisrastersystemthemen mit Azure CLI

In diesem Artikel erfahren Sie, wie Sie Systemthemen mit Azure CLI erstellen und verwalten. Eine Übersicht über Systemthemen finden Sie unter "Systemthemen".

Installieren der Erweiterung für Azure CLI

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

In Cloud Shell:

  • Wenn Sie die Erweiterung zuvor installiert haben, aktualisieren Sie sie: 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. Stellen Sie sicher, dass Sie über die neueste Version verfügen, indem Sie mit az --version überprüfen.
  2. Deinstallieren Sie frühere Versionen der Erweiterung: az extension remove -n eventgrid
  3. Installieren Sie die eventgrid-Erweiterung mit az extension add -n eventgrid

Erstellen eines Systemthemas

  • Informationen zum Erstellen eines Systemthemas zuerst in einer Azure-Quelle und anschließendes Erstellen eines Ereignisabonnements für dieses Thema finden Sie in den folgenden Referenzthemen:

    • az eventgrid system-topic erstellen

      # 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

      Führen Sie für eine Liste der topic-type Werte, die Sie zum Erstellen eines Systemthemas verwenden können, den folgenden Befehl aus. Diese Thementypwerte stellen die Ereignisquellen dar, die die Erstellung von Systemthemen unterstützen. Bitte ignorieren Sie Microsoft.EventGrid.Topics und Microsoft.EventGrid.Domains aus der Liste.

      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>

  • Verwenden Sie die Methode az eventgrid event-subscription create, um beim Erstellen eines Ereignisabonnements für eine Azure-Quelle ein Systemthema (implizit) zu erstellen. 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 Lernprogramm mit schrittweisen Anleitungen finden Sie unter Abonnieren des Speicherkontos.

Alle Systemthemen anzeigen

Verwenden Sie die folgenden Befehle, um alle Systemthemen und Details eines ausgewählten Systemthemas anzuzeigen:

Löscht ein Systemthema

Verwenden Sie den folgenden Befehl, um ein Systemthema zu löschen:

Nächste Schritte

Weitere Informationen zu Systemthemen und Thementypen, die von Azure Event Grid unterstützt werden, finden Sie im Abschnitt " Systemthemen" im Abschnitt "Azure Event Grid ".

  • Last updated on