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

Artículo
06/01/2023

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:

Instalación de la CLI de Azure. Asegúrese de que tiene la última versión. Para ello, debe comprobarlo con az --version.
Desinstale las versiones anteriores de la extensión: az extension remove -n eventgrid
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:

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>

Elimina un tema del sistema.

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

az eventgrid system-topic delete

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

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.

Compartir vía