Compartir vía

Creación, visualización y administración de temas del sistema de Event Grid en la CLI de Azure

  • Artículo

En este artículo se muestra cómo crear y administrar temas del sistema con la CLI de Azure. Para una introducción a los temas del sistema, consulte Temas del sistema.

Instalación de la extensión para la CLI de Azure

Para la CLI de Azure, necesita la extensión de Event Grid.

En Cloud Shell:

  • Si ha instalado la extensión anteriormente, actualícela: az extension update -n eventgrid
  • Si no ha instalado la extensión anteriormente, instálela: az extension add -n eventgrid

Para una instalación local:

  1. Instalación de la CLI de Azure. Asegúrese de que tiene la última versión. Para ello, debe comprobarlo con az --version.
  2. Desinstale las versiones anteriores de la extensión: az extension remove -n eventgrid
  3. Instale la extensión eventgrid con az extension add -n eventgrid

Creación de un tema del sistema

  • Para crear un tema del sistema en un origen de Azure en primer lugar y después una suscripción de eventos para ese tema, consulte los temas de referencia siguientes:

    • 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

      Para obtener una lista de los valores de topic-type que puede usar para crear un tema del sistema, ejecute el comando siguiente. Estos valores de tipo de tema representan los orígenes de eventos que admiten la creación de temas del sistema. Pase por alto Microsoft.EventGrid.Topics y Microsoft.EventGrid.Domains de la lista.

      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>

  • Para crear un tema del sistema (implícitamente) al crear una suscripción de eventos para un origen de Azure, use el método az eventgrid event-subscription create. Este es un ejemplo:

    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

    Para ver un tutorial con instrucciones paso a paso, consulte Suscripción a la cuenta de almacenamiento.

Visualización de todos los temas del sistema

Para ver todos los temas del sistema y los detalles de uno seleccionado, use los comandos siguientes:

Elimina un tema del sistema.

Para eliminar un tema del sistema, use el comando siguiente:

Pasos siguientes

Consulte los temas del sistema de Azure Event Grid para más información sobre los temas del sistema y los tipos de temas admitidos en Azure Event Grid.