az eventgrid event-subscription

Referencia

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar suscripciones de eventos.

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

Comandos

Nombre	Description	Tipo	Estado
az eventgrid event-subscription create	Cree una nueva suscripción de eventos.	Principal	GA
az eventgrid event-subscription create (eventgrid extensión)	Cree una nueva suscripción de eventos.	Extensión	Vista previa
az eventgrid event-subscription delete	Eliminar una suscripción a eventos.	Principal	GA
az eventgrid event-subscription delete (eventgrid extensión)	Eliminar una suscripción a eventos.	Extensión	Vista previa
az eventgrid event-subscription list	Enumerar suscripciones de eventos.	Principal	GA
az eventgrid event-subscription list (eventgrid extensión)	Enumerar suscripciones de eventos.	Extensión	Vista previa
az eventgrid event-subscription show	Obtenga los detalles de una suscripción de eventos.	Principal	GA
az eventgrid event-subscription show (eventgrid extensión)	Obtenga los detalles de una suscripción de eventos.	Extensión	Vista previa
az eventgrid event-subscription update	Actualizar una suscripción de eventos.	Principal	GA
az eventgrid event-subscription update (eventgrid extensión)	Actualizar una suscripción de eventos.	Extensión	Vista previa

az eventgrid event-subscription create

Editar

Cree una nueva suscripción de eventos.

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--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]
                                       [--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]

Ejemplos

Cree una nueva suscripción de eventos para un tema de Event Grid con 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 Azure mediante 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 mediante 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 mediante 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, con filtros predeterminados y un Centro de eventos 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, con 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, con filtros predeterminados y una instancia de Azure ServiceBusQueue 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, con 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 de reintentos fallido y una directiva de reintento personalizado de 10 intentos de entrega máximos y un TTL de eventos de 2 horas (lo que ocurra anteriormente).

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 habilitado para Azure Active Directory 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 tema de Event Grid mediante Azure Function 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

Creación de una nueva suscripción de eventos para un tema de Event Grid, mediante Eventhub con la identidad MSI asignada por systemassigned como destino y con deadletter 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}

Creación de una nueva suscripción de eventos para un tema de Event Grid mediante la cola de Storage como destino con el mensaje ttl 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

Creación de una nueva suscripción de eventos para un tema de Event Grid mediante StorageQueue con la identidad MSI asignada por 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 de 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

--aad-tenant-id --azure-active-directory-tenant-id

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

--advanced-filter

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

Uso: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Azul Rojo Naranja Amarillo StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginssWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png numberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100,110 200,210 300,310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Se pueden especificar varios filtros avanzados mediante más de un --advanced-filter argumento.

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

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

--deadletter-endpoint

Identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage en el que EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

Ejemplo: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Vista previa

Tipo de identidad del recurso de destino deadletter.

Valores aceptados: systemassigned

--deadletter-identity-endpoint

El identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage con identidad donde EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--delivery-attribute-mapping

Agregue la 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 más de un --delivery-attribute-mapping argumento.

Uso: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Asignación de atributos estáticos: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity

Vista previa

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

Valores aceptados: systemassigned

--delivery-identity-endpoint

Vista previa

Punto de conexión con identidad donde EventGrid debe entregar 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 punto de conexión, debe ser el identificador de recursos de Azure del punto de conexión.

--delivery-identity-endpoint-type

Vista previa

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

Valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--enable-advanced-filtering-on-arrays --enable-af-arr

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

Valores aceptados: false, true

--endpoint

Punto de conexión donde EventGrid debe entregar 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 punto 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 se cree y esté disponible para su uso antes de ejecutar cualquier comando de Event Grid.

--endpoint-type

Tipo del punto de conexión de destino.

Valor predeterminado: webhook

--event-delivery-schema

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

Valores aceptados: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Tiempo de vida del evento (en minutos). Debe ser un número comprendido entre 1 y 1440.

Valor predeterminado: 1440

--expiration-date

Fecha o fecha y hora (en UTC, por ejemplo, "2018-11-30T11:59:59+00:00" o "2018-11-30") después de la 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 separada por espacios de tipos de eventos (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 el caso de los temas de Event Grid, los tipos de eventos se definen por el cliente. Para eventos de Azure, por ejemplo, cuentas de almacenamiento, IoT Hub, etc., puede consultar sus tipos de eventos mediante este comando de la CLI "az eventgrid topic-type list-event-types".

--labels

Lista separada por espacios de etiquetas 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 vida del mensaje de cola de almacenamiento en segundos.

--source-resource-id

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

Uso: --source-resource-id Azure-Resource-ID For Azure subscription: --source-resource-id /subscriptions/{SubID} For resource group: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de 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 confidencial entre mayúsculas y minúsculas. True si la marca está presente.

Valores aceptados: false, true

Valor predeterminado: False

--subject-ends-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo. No se admite el uso de caracteres comodín.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription create (eventgrid extensión)

Vista previa

El grupo de comandos "az eventgrid" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Ejemplos

Cree una nueva suscripción de eventos para un tema de Event Grid con 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 Azure mediante 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 mediante 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 mediante 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, con filtros predeterminados y un Centro de eventos 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, con 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, con filtros predeterminados y una instancia de Azure ServiceBusQueue 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, con 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

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 habilitado para Azure Active Directory 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 tema de Event Grid mediante Azure Function 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

Creación de una nueva suscripción de eventos para un tema de Event Grid, mediante Eventhub con la identidad MSI asignada por systemassigned como destino y con deadletter 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}

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--advanced-filter

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

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

--azure-active-directory-tenant-id

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

--deadletter-endpoint

Identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage en el que EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

Ejemplo: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Tipo de identidad del recurso de destino deadletter.

Valores aceptados: systemassigned

--deadletter-identity-endpoint

El identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage con identidad donde EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--delivery-identity

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

Valores aceptados: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

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

Valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--endpoint

--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

Valores aceptados: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Tiempo de vida del evento (en minutos). Debe ser un número comprendido entre 1 y 1440.

Valor predeterminado: 1440

--expiration-date

--included-event-types

Una lista separada por espacios de tipos de eventos. Ejemplo: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Para suscribirse a todos los tipos de eventos predeterminados, no especifique ningún valor para este argumento.

--labels

Lista separada por espacios de etiquetas 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.

--source-resource-id

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

--subject-begins-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de 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 confidencial entre mayúsculas y minúsculas. True si la marca está presente.

Valores aceptados: false, true

Valor predeterminado: False

--subject-ends-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo. No se admite el uso de caracteres comodín.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription delete

Editar

Eliminar una suscripción a eventos.

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

Ejemplos

Elimine una suscripción de eventos para un tema de 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.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription delete (eventgrid extensión)

Vista previa

El grupo de comandos "az eventgrid" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Eliminar una suscripción a eventos.

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

Ejemplos

Elimine una suscripción de eventos para un tema de 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.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription list

Editar

Enumerar suscripciones de eventos.

Event Grid admite suscripciones de eventos regionales y globales: las suscripciones de eventos en recursos regionales (como cuentas de almacenamiento o 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:

Para enumerar por el identificador de recurso del recurso cuyas suscripciones de eventos desea enumerar, especifique el parámetro --source-resource-id. No se debe especificar ningún otro parámetro.
Para enumerar por un tipo de tema (por ejemplo, cuentas de almacenamiento), especifique el parámetro --topic-type junto con el parámetro --location (por ejemplo, "westus2"). Para los tipos de temas globales (por ejemplo, "Microsoft.Resources.Subscriptions"), especifique el valor de ubicación como "global".
Para enumerar todas las suscripciones de eventos de una región (en todos los tipos de temas), especifique solo el parámetro --location.
Para el número 2 y el número 3 anterior, 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]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Ejemplos

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

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

Enumere 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}

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

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

Enumere todas las suscripciones de eventos para un dominio de Event Grid.

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

Enumere todas las suscripciones de eventos para un tema de dominio de Event Grid.

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 Storage (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 Storage (en el grupo de recursos especificado) en westus2.

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

Enumere 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

Enumere todas las suscripciones de eventos regionales o globales en 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 contiene 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 para un dominio de Event Grid, excepto la suscripción de eventos con el nombre "name1"

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 OData que se usa para filtrar los resultados de la lista. El filtrado solo se permite en la propiedad Name. Las operaciones admitidas incluyen: CONTAINS, eq (para igual), ne (para no igual), AND, OR y NOT.

--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.

--topic-type-name

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

Ejemplo 1: Enumerar todas las suscripciones de eventos de Storage en WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Ejemplo 2: Enumerar todas las suscripciones de eventos en suscripciones de Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription list (eventgrid extensión)

Vista previa

El grupo de comandos "az eventgrid" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumerar suscripciones de eventos.

Para enumerar por el identificador de recurso del recurso cuyas suscripciones de eventos desea enumerar, especifique el parámetro --source-resource-id. No se debe especificar ningún otro parámetro.
Para enumerar por un tipo de tema (por ejemplo, cuentas de almacenamiento), especifique el parámetro --topic-type junto con el parámetro --location (por ejemplo, "westus2"). Para los tipos de temas globales (por ejemplo, "Microsoft.Resources.Subscriptions"), especifique el valor de ubicación como "global".
Para enumerar todas las suscripciones de eventos de una región (en todos los tipos de temas), especifique solo el parámetro --location.
Para el número 2 y el número 3 anterior, 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]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Ejemplos

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

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

Enumere 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}

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

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

Enumere todas las suscripciones de eventos para un dominio de Event Grid.

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

Enumere todas las suscripciones de eventos para un tema de dominio de Event Grid.

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 Storage (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 Storage (en el grupo de recursos especificado) en westus2.

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

Enumere 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

Enumere todas las suscripciones de eventos regionales o globales en 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 contiene 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 para un dominio de Event Grid, excepto la suscripción de eventos con el nombre "name1"

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 que se usa para filtrar los resultados mediante la sintaxis de OData.

--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.

--topic-type-name

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

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription show

Editar

Obtenga 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}]
                                     [--source-resource-id]

Ejemplos

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

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}

Mostrar 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

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

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 deben devolver secretos de atributo de entrega estáticos. True si la marca está presente.

Valores aceptados: false, true

Valor predeterminado: False

--include-full-endpoint-url

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

Valores aceptados: false, true

Valor predeterminado: False

--source-resource-id

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

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription show (eventgrid extensión)

Vista previa

El grupo de comandos "az eventgrid" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga los detalles de una suscripción de eventos.

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

Ejemplos

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

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}

Mostrar 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

Parámetros requeridos

--name -n

Nombre de la suscripción de eventos.

Parámetros opcionales

--include-full-endpoint-url

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

Valores aceptados: false, true

Valor predeterminado: False

--source-resource-id

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

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription update

Editar

Actualizar 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]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Ejemplos

Actualice una suscripción de eventos para un tema de 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 una suscripción de Azure para especificar un nuevo filtro subject-ends-with.

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

Actualice una suscripción de eventos para un grupo de recursos para especificar un nuevo punto de conexión y un nuevo filtro subject-ends-with.

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 eventos 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 entrega 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 ttl del 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 <key=value, string or JSON string>.

Valor predeterminado: []

--advanced-filter

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

--deadletter-endpoint

Identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage en el que EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--deadletter-identity

Vista previa

Tipo de identidad del recurso de destino deadletter.

Valores aceptados: systemassigned

--deadletter-identity-endpoint

El identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage con identidad donde EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--delivery-attribute-mapping

--delivery-identity

Vista previa

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

Valores aceptados: systemassigned

--delivery-identity-endpoint

Vista previa

--delivery-identity-endpoint-type

Vista previa

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

Valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--enable-advanced-filtering-on-arrays --enable-af-arr

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

Valores aceptados: false, true

--endpoint

--endpoint-type

Tipo del punto de conexión de destino.

Valor predeterminado: webhook

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False

--included-event-types

--labels

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

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

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

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []

--source-resource-id

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

--subject-begins-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un prefijo. No se admite el uso de caracteres comodín.

--subject-ends-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo. No se admite el uso de caracteres comodín.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az eventgrid event-subscription update (eventgrid extensión)

Vista previa

El grupo de comandos "az eventgrid" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualizar una suscripción de eventos.

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

Ejemplos

Actualice una suscripción de eventos para un tema de 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 una suscripción de Azure para especificar un nuevo filtro subject-ends-with.

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

Actualice una suscripción de eventos para un grupo de recursos para especificar un nuevo punto de conexión y un nuevo filtro subject-ends-with.

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 eventos 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 entrega 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

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 <key=value, string or JSON string>.

Valor predeterminado: []

--advanced-filter

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

--deadletter-endpoint

Identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage en el que EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--deadletter-identity

Tipo de identidad del recurso de destino deadletter.

Valores aceptados: systemassigned

--deadletter-identity-endpoint

El identificador de recurso de Azure de un destino de contenedor de blobs de Azure Storage con identidad donde EventGrid debe anular la entrega de eventos para esta suscripción de eventos.

--delivery-identity

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

Valores aceptados: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

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

Valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--endpoint

--endpoint-type

Tipo del punto de conexión de destino.

Valores aceptados: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

Valor predeterminado: webhook

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False

--included-event-types

--labels

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

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []

--source-resource-id

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

--subject-begins-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un prefijo. No se admite el uso de caracteres comodín.

--subject-ends-with

Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo. No se admite el uso de caracteres comodín.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

Compartir a través de

az eventgrid event-subscription

Comandos

az eventgrid event-subscription create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription create (eventgrid extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription delete (eventgrid extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription list

Ejemplos

Parámetros opcionales

az eventgrid event-subscription list (eventgrid extensión)

Ejemplos

Parámetros opcionales

az eventgrid event-subscription show

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription show (eventgrid extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription update

Ejemplos

Parámetros requeridos

Parámetros opcionales

az eventgrid event-subscription update (eventgrid extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

Recursos adicionales