az eventgrid event-subscription

Administrar suscripciones a eventos.

Administrar suscripciones de eventos para un tema Event Grid, un dominio, un tema de dominio, una suscripción de Azure, un grupo de recursos o para cualquier otro recurso de Azure que admita notificaciones de eventos.

Comandos

az eventgrid event-subscription create

Cree una nueva suscripción de eventos.

az eventgrid event-subscription delete

Eliminar una suscripción a eventos.

az eventgrid event-subscription list

Enumerar suscripciones a eventos.

az eventgrid event-subscription show

Obtener los detalles de una suscripción de eventos.

az eventgrid event-subscription update

Actualice una suscripción de eventos.

az eventgrid event-subscription create

Cree una nueva suscripción de eventos.

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--qttl]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]
                                       [--subscription]

Ejemplos

Cree una nueva suscripción de eventos para un Event Grid tema, usando filtros predeterminados.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Cree una nueva suscripción de eventos para una suscripción de suscripción de Azure usando filtros predeterminados.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Cree una nueva suscripción de eventos para un grupo de recursos mediante filtros predeterminados.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Cree una nueva suscripción de eventos para una cuenta de almacenamiento con filtros predeterminados.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Cree una nueva suscripción de eventos para una cuenta de almacenamiento con filtros avanzados.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Cree una nueva suscripción de eventos para una suscripción de Azure, con un filtro que especifique un prefijo de asunto.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Cree una nueva suscripción de eventos para un grupo de recursos, con un filtro que especifique un sufijo de asunto.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Cree una nueva suscripción de eventos para una suscripción de Azure, usando filtros predeterminados y un EventHub como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Cree una nueva suscripción de eventos para una suscripción de Azure, usando filtros predeterminados y una cola de Azure Storage como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Cree una nueva suscripción de eventos para una suscripción de Azure, usando filtros predeterminados y una ServiceBusQueue de Azure como destino.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Cree una nueva suscripción de eventos para un dominio de Event Grid, usando filtros predeterminados y CloudEvent V 1,0 como esquema de entrega.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Cree una nueva suscripción de eventos para una cuenta de almacenamiento, con un destino mensajes fallidos y una directiva de reintentos personalizada con un máximo de 10 intentos de entrega y un TTL de evento de 2 horas (lo que suceda antes).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Cree una nueva suscripción de eventos para un tema de dominio.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Cree una nueva suscripción de eventos (para una cuenta de almacenamiento) con una fecha de expiración.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Cree una nueva suscripción de eventos para un tema de Event Grid, mediante el webhook de Azure Active Directory habilitado como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Cree una nueva suscripción de eventos para un Event Grid tema con Azure Functions como destino.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Cree una nueva suscripción de eventos para un Event Grid tema, usando Eventhub con identidad MSI systemassigned como destino y con mensajes fallidos con identidad MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Cree una nueva suscripción de eventos para un Event Grid tema mediante la cola de almacenamiento como destino con el TTL del mensaje a 5 minutos

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Cree una nueva suscripción de eventos para un tema de Event Grid mediante StorageQueue con la identidad MSI de systemassigned como destino.

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Creación de una nueva suscripción de eventos para un tema Event Grid con filtrado avanzado habilitado en matrices

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--advanced-filter

Un filtro avanzado permite el filtrado de eventos en función de una propiedad de evento específica.

--azure-active-directory-application-id-or-uri

El identificador de la aplicación Azure Active Directory o el URI para obtener el token de acceso que se incluirá como el token de portador en las solicitudes de entrega. Solo se aplica a webhook como destino.

--azure-active-directory-tenant-id

El identificador de inquilino de Azure Active Directory para obtener el token de acceso que se incluirá como el token de portador en las solicitudes de entrega. Solo se aplica a webhook como destino.

--deadletter-endpoint

El identificador de recurso de Azure de un Azure Storage destino de contenedor de blobs en el que EventGrid debe mensajes fallidos eventos que no se pueden enviar para esta suscripción de eventos.

--deadletter-identity

El tipo de identidad del recurso de destino de mensajes fallidos.

valores aceptados: systemassigned
--deadletter-identity-endpoint

El identificador de recurso de Azure de un Azure Storage destino de contenedor de blobs con la identidad en la que EventGrid debe mensajes fallidos eventos que no se pueden enviar para esta suscripción de eventos.

--delivery-attribute-mapping

Agregar asignación de atributos de entrega para enviar información adicional a través de encabezados HTTP al entregar eventos. Este atributo es válido para todos los tipos de destino excepto StorageQueue. Se pueden especificar varios atributos mediante el uso de más de un --delivery-attribute-mapping argumento.

--delivery-identity

El tipo de identidad del recurso de destino de entrega (por ejemplo, la cola de almacenamiento o eventhub).

valores aceptados: systemassigned
--delivery-identity-endpoint

Punto de conexión con identidad en el que EventGrid debe proporcionar eventos que coincidan con esta suscripción de eventos. Para el tipo de punto de conexión de webhook, debe ser la dirección URL de webhook correspondiente. Para otros tipos de puntos de conexión, debe ser el identificador de recursos de Azure del punto de conexión.

--delivery-identity-endpoint-type

Tipo del punto de conexión de destino con la identidad de recurso.

valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permite evaluar los filtros avanzados en una matriz de valores en lugar de esperar un valor singular.

valores aceptados: false, true
--endpoint

Punto de conexión en el que EventGrid debe proporcionar eventos que coincidan con esta suscripción de eventos. Para el tipo de punto de conexión de webhook, debe ser la dirección URL de webhook correspondiente. Para otros tipos de puntos de conexión, debe ser el identificador de recursos de Azure del punto de conexión. Se espera que el punto de conexión de destino ya esté creado y disponible para su uso antes de ejecutar cualquier comando Event Grid.

--endpoint-type

Tipo del punto de conexión de destino.

valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
valor predeterminado: webhook
--event-delivery-schema

Esquema en el que se deben entregar los eventos para esta suscripción de eventos. De forma predeterminada, los eventos se entregan en el mismo esquema en el que se publican (según el esquema de entrada del tema correspondiente).

valores aceptados: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Período de vida del evento (en minutos). Debe ser un número entre 1 y 1440.

valor predeterminado: 1440
--expiration-date

Date o DateTime (en UTC, por ejemplo, ' 2018-11-30T11:59:59 + 00:00 ' o ' 2018-11-30 ') después del cual expiraría la suscripción de eventos. De forma predeterminada, no hay ninguna expiración para la suscripción de eventos.

--included-event-types

Una lista de tipos de eventos separados por espacios (por ejemplo, Microsoft. Storage. BlobCreated y Microsoft. Storage. BlobDeleted). Para suscribirse a todos los tipos de eventos predeterminados, no especifique ningún valor para este argumento. En los temas de Event Grid, los tipos de evento son Customer defined. En el caso de los eventos de Azure, por ejemplo, las cuentas de almacenamiento, IoT Hub, etc., puede consultar sus tipos de evento con este comando de la CLI ' AZ eventgrid topic-Type List-Event-Types '.

--labels

Lista de etiquetas separadas por espacios que se van a asociar a esta suscripción de eventos.

--max-delivery-attempts

Número máximo de intentos de entrega. Debe ser un número comprendido entre 1 y 30.

valor predeterminado: 30
--max-events-per-batch

Número máximo de eventos en un lote. Debe ser un número entre 1 y 5000.

--preferred-batch-size-in-kilobytes

Tamaño de lote preferido en kilobytes. Debe ser un número entre 1 y 1024.

--qttl --storage-queue-msg-ttl

Tiempo de espera del mensaje de cola de almacenamiento en segundos.

--source-resource-id

Identificador completo del recurso de Azure en el que se debe crear la suscripción de eventos.

--subject-begins-with

Una cadena opcional para filtrar los eventos de una suscripción de eventos basada en un prefijo. No se admite el uso de caracteres comodín.

--subject-case-sensitive

Especifique para indicar si los campos de asunto deben compararse de forma que distinga entre mayúsculas y minúsculas. True si la marca está presente.

valores aceptados: false, true
--subject-ends-with

Una cadena opcional para filtrar los eventos de una suscripción de eventos basándose en un sufijo. No se admite el uso de caracteres comodín.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az eventgrid event-subscription delete

Eliminar una suscripción a eventos.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]
                                       [--subscription]

Ejemplos

Elimine una suscripción de eventos para un tema Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Elimine una suscripción de eventos para un tema de dominio de Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Elimina una suscripción de eventos para un dominio de Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Elimine una suscripción de eventos para una suscripción de Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Elimine una suscripción de eventos para un grupo de recursos.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Elimine una suscripción de eventos para una cuenta de almacenamiento.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--source-resource-id

Identificador completo del recurso de Azure cuya suscripción de eventos debe eliminarse.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az eventgrid event-subscription list

Enumerar suscripciones a eventos.

Event Grid admite las suscripciones a eventos regionales y globales: las suscripciones a eventos en los recursos regionales (como las cuentas de almacenamiento o los temas de Event Grid) son regionales, mientras que las suscripciones de eventos en recursos globales (como una suscripción de Azure o un grupo de recursos) son globales. Por lo tanto, puede enumerar las suscripciones de eventos de varias maneras diferentes:

  1. Para enumerar por el identificador de recurso del recurso cuyas suscripciones de eventos desea mostrar, especifique el parámetro--Source-Resource-ID. No se debe especificar ningún otro parámetro.
  2. Para enumerar por un tipo de tema (por ejemplo, cuentas de almacenamiento), especifique el parámetro--topic-Type junto con--Location (por ejemplo, "westus2"). En el caso de los tipos de temas globales (por ejemplo, "Microsoft. Resources. subscriptions"), especifique el valor de ubicación como "global".
  3. Para enumerar todas las suscripciones de eventos de una región (en todos los tipos de tema), especifique solo el parámetro--Location.
  4. En el caso de #2 y #3 anteriores, para filtrar solo por un grupo de recursos, también puede especificar el parámetro--Resource-Group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--query-examples]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--subscription]
                                     [--topic-type-name]

Ejemplos

Muestra todas las suscripciones de eventos creadas para un Event Grid tema.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Muestra todas las suscripciones de eventos creadas para una cuenta de almacenamiento.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Enumere todas las suscripciones de eventos creadas para una suscripción de Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Muestra todas las suscripciones de eventos creadas para un grupo de recursos.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Enumera todas las suscripciones de eventos de un dominio de Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Enumerar todas las suscripciones de eventos de un tema Event Grid dominio.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Enumere todas las suscripciones de eventos de almacenamiento (en la suscripción de Azure seleccionada actualmente) en westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Enumere todas las suscripciones de eventos de almacenamiento (en el grupo de recursos determinado) en westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Enumerar todas las suscripciones de eventos regionales o globales (en la suscripción de Azure seleccionada actualmente).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Enumerar todas las suscripciones de eventos regionales o globales de un grupo de recursos especificado.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Enumerar todas las suscripciones de eventos de un dominio de Event Grid cuyo nombre contenga el patrón "XYZ"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Enumerar todas las suscripciones de eventos de un dominio de Event Grid excepto la suscripción de eventos con el nombre "nombre1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Parámetros opcionales

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--odata-query

Consulta de OData que se usa para filtrar los resultados de la lista. Actualmente solo se permite el filtrado en la propiedad Name. Entre las operaciones admitidas se incluyen: Contains, EQ (para igual), NE (para no igual), AND, OR y NOT.

--query-examples

Recomiende la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro--Query entre comillas dobles para ver los resultados. Puede Agregar una o más palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--source-resource-id

Identificador completo del recurso de Azure cuya suscripción de eventos debe aparecer en la lista.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

--topic-type-name

Nombre del tipo de tema cuyas suscripciones de eventos deben mostrarse. Cuando se especifica, también debe especificar--Location.

az eventgrid event-subscription show

Obtener los detalles de una suscripción de eventos.

az eventgrid event-subscription show --name
                                     [--include-attrib-secret {false, true}]
                                     [--include-full-endpoint-url {false, true}]
                                     [--query-examples]
                                     [--source-resource-id]
                                     [--subscription]

Ejemplos

Mostrar los detalles de una suscripción de eventos para un Event Grid tema.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Mostrar los detalles de una suscripción de eventos para una suscripción de Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Muestra los detalles de una suscripción de eventos para un grupo de recursos.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Muestra los detalles de una suscripción de eventos para una cuenta de almacenamiento.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Mostrar los detalles de una suscripción de eventos para un grupo de recursos, incluidos los secretos de atributo de entrega estática.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--include-attrib-secret --include-static-delivery-attribute-secret

Indica si se debe devolver cualquier secreto de atributo de entrega estático. True si la marca está presente.

valores aceptados: false, true
--include-full-endpoint-url

Especifique para indicar si se debe devolver la dirección URL completa del extremo. True si la marca está presente.

valores aceptados: false, true
--query-examples

Recomiende la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro--Query entre comillas dobles para ver los resultados. Puede Agregar una o más palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--source-resource-id

Identificador completo del recurso de Azure cuya suscripción de eventos debe mostrarse.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .

az eventgrid event-subscription update

Actualice una suscripción de eventos.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]
                                       [--subscription]

Ejemplos

Actualice una suscripción de eventos para un tema Event Grid para especificar un nuevo punto de conexión.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Actualice una suscripción de eventos para que una suscripción de Azure especifique un nuevo filtro de asunto-fin-con.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Actualice una suscripción de eventos para que un grupo de recursos especifique un nuevo punto de conexión y un nuevo filtro de asunto-fin-con.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Actualice una suscripción de eventos para una cuenta de almacenamiento para especificar una nueva lista de tipos de evento incluidos.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Actualice una suscripción de eventos para una cuenta de almacenamiento, para incluir un destino de mensajes fallidos.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Actualice una suscripción de eventos para una cuenta de almacenamiento mediante filtros avanzados.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Actualice una suscripción de eventos para que una cuenta de almacenamiento incluya el TTL de mensaje establecido en 5 minutos.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Actualización de una suscripción de eventos con filtrado avanzado habilitado en matrices

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo:--Add Property. listProperty <clave = valor, cadena o cadena JSON>.

--advanced-filter

Un filtro avanzado permite el filtrado de eventos en función de una propiedad de evento específica.

--deadletter-endpoint

El identificador de recurso de Azure de un Azure Storage destino de contenedor de blobs en el que EventGrid debe mensajes fallidos eventos que no se pueden enviar para esta suscripción de eventos.

--deadletter-identity

El tipo de identidad del recurso de destino de mensajes fallidos.

valores aceptados: systemassigned
--deadletter-identity-endpoint

El identificador de recurso de Azure de un Azure Storage destino de contenedor de blobs con la identidad en la que EventGrid debe mensajes fallidos eventos que no se pueden enviar para esta suscripción de eventos.

--delivery-attribute-mapping

Agregar asignación de atributos de entrega para enviar información adicional a través de encabezados HTTP al entregar eventos. Este atributo es válido para todos los tipos de destino excepto StorageQueue. Se pueden especificar varios atributos mediante el uso de más de un --delivery-attribute-mapping argumento.

--delivery-identity

El tipo de identidad del recurso de destino de entrega (por ejemplo, la cola de almacenamiento o eventhub).

valores aceptados: systemassigned
--delivery-identity-endpoint

Punto de conexión con identidad en el que EventGrid debe proporcionar eventos que coincidan con esta suscripción de eventos. Para el tipo de punto de conexión de webhook, debe ser la dirección URL de webhook correspondiente. Para otros tipos de puntos de conexión, debe ser el identificador de recursos de Azure del punto de conexión.

--delivery-identity-endpoint-type

Tipo del punto de conexión de destino con la identidad de recurso.

valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permite evaluar los filtros avanzados en una matriz de valores en lugar de esperar un valor singular.

valores aceptados: false, true
--endpoint

Punto de conexión en el que EventGrid debe proporcionar eventos que coincidan con esta suscripción de eventos. Para el tipo de punto de conexión de webhook, debe ser la dirección URL de webhook correspondiente. Para otros tipos de puntos de conexión, debe ser el identificador de recursos de Azure del punto de conexión. Se espera que el punto de conexión de destino ya esté creado y disponible para su uso antes de ejecutar cualquier comando Event Grid.

--endpoint-type

Tipo del punto de conexión de destino.

valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
valor predeterminado: webhook
--force-string

Cuando se usa ' Set ' o ' Add ', se conservan los literales de cadena en lugar de intentar convertir en JSON.

--included-event-types

Una lista de tipos de eventos separados por espacios (por ejemplo, Microsoft. Storage. BlobCreated y Microsoft. Storage. BlobDeleted). Para suscribirse a todos los tipos de eventos predeterminados, no especifique ningún valor para este argumento. En los temas de Event Grid, los tipos de evento son Customer defined. En el caso de los eventos de Azure, por ejemplo, las cuentas de almacenamiento, IoT Hub, etc., puede consultar sus tipos de evento con este comando de la CLI ' AZ eventgrid topic-Type List-Event-Types '.

--labels

Lista de etiquetas separadas por espacios que se van a asociar a esta suscripción de eventos.

--qttl --storage-queue-msg-ttl

Tiempo de espera del mensaje de cola de almacenamiento en segundos.

--remove

Quitar una propiedad o un elemento de una lista. Ejemplo:--Remove Property. List o--Remove propertyToRemove.

--set

Actualice un objeto especificando la ruta de acceso y el valor de la propiedad que se van a establecer. Ejemplo:--set property1. property2 =.

--source-resource-id

Identificador completo del recurso de Azure cuya suscripción de eventos debe actualizarse.

--subject-begins-with

Una cadena opcional para filtrar los eventos de una suscripción de eventos basada en un prefijo. No se admite el uso de caracteres comodín.

--subject-ends-with

Una cadena opcional para filtrar los eventos de una suscripción de eventos basándose en un sufijo. No se admite el uso de caracteres comodín.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID .