Créer, afficher et gérer des rubriques système Event Grid avec l’interface Azure CLI

  • Article

Cet article vous montre comment créer et gérer des rubriques système dans l’interface Azure CLI. Pour une présentation des rubriques système, consultez Rubriques système.

Installer l'extension pour l'interface de ligne de commande Azure

L'interface de ligne de commande Azure requiert l'extension Event Grid.

Dans Cloud Shell :

  • Si vous avez installé l’extension précédemment, mettez-la à jour : az extension update -n eventgrid
  • Si vous n’avez pas installé l’extension précédemment, faites-le : az extension add -n eventgrid

Pour une installation locale :

  1. Installer l’interface de ligne de commande Microsoft Azure. Vérifiez que la dernière version est installée en exécutant az --version.
  2. Désinstallez les précédentes versions de l’extension : az extension remove -n eventgrid
  3. Installez l’extension eventgrid avec az extension add -n eventgrid

Créer une rubrique système

  • Pour créer d’abord une rubrique système sur une source Azure, puis créer un abonnement d’événement pour cette rubrique, consultez les rubriques de référence suivantes :

    • 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

      Pour obtenir la liste des valeurs de topic-type que vous pouvez utiliser pour créer une rubrique système, exécutez la commande suivante. Ces valeurs de rubrique représentent les sources d’événements qui prennent en charge la création de rubriques système. Ignorez Microsoft.EventGrid.Topics et Microsoft.EventGrid.Domains de la 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>

  • Pour créer une rubrique système (implicitement) lors de la création d’un abonnement aux événements pour une source Azure, utilisez la méthode az eventgrid event-subscription create. Voici un exemple :

    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

    Pour suivre un tutoriel avec des instructions pas à pas, consultez S’abonner à un compte de stockage.

Afficher toutes les rubriques système

Pour afficher toutes les rubriques et les détails relatifs à une rubrique système sélectionnée, utilisez les commandes suivantes :

Supprime une rubrique système

Pour supprimer une rubrique système, utilisez la commande suivante :

Étapes suivantes

Pour en savoir plus sur les rubriques système et les types de rubriques pris en charge par Azure Event Grid, consultez la section Rubriques système dans Azure Event Grid.