az eventgrid system-topic event-subscription
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 del tema del sistema.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az eventgrid system-topic event-subscription create |
Cree una nueva suscripción de eventos para un tema del sistema. |
Core | GA |
| az eventgrid system-topic event-subscription create (eventgrid extensión) |
Cree una nueva suscripción de eventos para un tema del sistema. |
Extensión | Vista previa |
| az eventgrid system-topic event-subscription delete |
Elimine una suscripción de eventos de un tema del sistema. |
Core | GA |
| az eventgrid system-topic event-subscription delete (eventgrid extensión) |
Elimine una suscripción de eventos de un tema del sistema. |
Extensión | Vista previa |
| az eventgrid system-topic event-subscription list |
Enumerar suscripciones de eventos de un tema de sistema específico. |
Core | GA |
| az eventgrid system-topic event-subscription list (eventgrid extensión) |
Enumerar suscripciones de eventos de un tema de sistema específico. |
Extensión | Vista previa |
| az eventgrid system-topic event-subscription show |
Obtenga los detalles de una suscripción de eventos de un tema del sistema. |
Core | GA |
| az eventgrid system-topic event-subscription show (eventgrid extensión) |
Obtenga los detalles de una suscripción de eventos de un tema del sistema. |
Extensión | Vista previa |
| az eventgrid system-topic event-subscription update |
Actualizar una suscripción de eventos de un tema del sistema. |
Core | GA |
| az eventgrid system-topic event-subscription update (eventgrid extensión) |
Actualizar una suscripción de eventos de un tema del sistema. |
Extensión | Vista previa |
az eventgrid system-topic event-subscription create
Cree una nueva suscripción de eventos para un tema del sistema.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--aad-tenant-id]
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--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]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]Ejemplos
Cree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante filtros predeterminados.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=codeCree una nueva suscripción de eventos para un tema del sistema de Event Grid, con un filtro que especifique un prefijo de asunto.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefixCree una nueva suscripción de eventos para un tema del sistema de Event Grid, con filtros predeterminados y CloudEvent V 1.0 como esquema de entrega.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0Cree una nueva suscripción de eventos para un tema del sistema de Event Grid, con un destino de reintentos fallido y una directiva de reintento personalizado de máximo 10 intentos de entrega y un TTL de eventos de 2 horas (lo que ocurra anteriormente) y la fecha de expiración.
az eventgrid system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 --expiration-date "2022-10-31"Cree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante el webhook habilitado para Azure Active Directory como destino.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruriCree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante Azure Functions como destino.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunctionCreación de una nueva suscripción de eventos para un tema del sistema de Event Grid mediante la cola de Storage como destino con un ttl de 5 minutos
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300Creación de una nueva suscripción de eventos para un tema del sistema de Event Grid y habilitación del filtrado avanzado en matrices
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays trueParámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
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.
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.
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.
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.
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.
Permite evaluar filtros avanzados en una matriz de valores en lugar de esperar un valor singular.
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.
Tipo del punto de conexión de destino.
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).
Tiempo de vida del evento (en minutos). Debe ser un número comprendido entre 1 y 1440.
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.
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".
Lista separada por espacios de etiquetas que se van a asociar a esta suscripción de eventos.
Número máximo de intentos de entrega. Debe ser un número comprendido entre 1 y 30.
Número máximo de eventos en un lote. Debe ser un número entre 1 y 5000.
Tamaño de lote preferido en kilobytes. Debe ser un número entre 1 y 1024.
Tiempo de vida del mensaje de cola de almacenamiento en segundos.
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.
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.
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription create (eventgrid extensión)
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 para un tema del sistema.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--azure-active-directory-tenant-id]
[--deadletter-endpoint]
[--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]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]Ejemplos
Cree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante filtros predeterminados.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=codeCree una nueva suscripción de eventos para un tema del sistema de Event Grid, con un filtro que especifique un prefijo de asunto.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefixCree una nueva suscripción de eventos para un tema del sistema de Event Grid, con filtros predeterminados y CloudEvent V 1.0 como esquema de entrega.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0Cree una nueva suscripción de eventos para un tema del sistema de Event Grid, con un destino de reintentos fallido y una directiva de reintento personalizado de máximo 10 intentos de entrega y un TTL de eventos de 2 horas (lo que ocurra anteriormente) y la fecha de expiración.
az eventgrid system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 --expiration-date "2022-10-31"Cree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante el webhook habilitado para Azure Active Directory como destino.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruriCree una nueva suscripción de eventos para un tema del sistema de Event Grid mediante Azure Functions como destino.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunctionParámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
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 StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Se pueden especificar varios filtros avanzados mediante más de un --advanced-filter argumento.
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.
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.
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.
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.
Tipo del punto de conexión de destino.
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).
Tiempo de vida del evento (en minutos). Debe ser un número comprendido entre 1 y 1440.
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.
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.
Lista separada por espacios de etiquetas que se van a asociar a esta suscripción de eventos.
Número máximo de intentos de entrega. Debe ser un número comprendido entre 1 y 30.
Número máximo de eventos en un lote. Debe ser un número entre 1 y 5000.
Tamaño de lote preferido en kilobytes. Debe ser un número entre 1 y 1024.
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.
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.
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription delete
Elimine una suscripción de eventos de un tema del sistema.
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-name
[--yes]Ejemplos
Elimine una suscripción de eventos para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \Parámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription delete (eventgrid extensión)
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
Elimine una suscripción de eventos de un tema del sistema.
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-nameEjemplos
Elimine una suscripción de eventos para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \Parámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription list
Enumerar suscripciones de eventos de un tema de sistema específico.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]Ejemplos
Enumere todas las suscripciones de eventos creadas para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1Parámetros requeridos
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
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.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription list (eventgrid extensión)
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 de un tema de sistema específico.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]Ejemplos
Enumere todas las suscripciones de eventos creadas para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1Parámetros requeridos
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
Consulta que se usa para filtrar los resultados mediante la sintaxis de OData.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription show
Obtenga los detalles de una suscripción de eventos de un tema del sistema.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]Ejemplos
Muestra los detalles de una suscripción de eventos para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1Mostrar los detalles de una suscripción de eventos para un tema del sistema de Event Grid incluye los secretos de atributos de entrega estáticos.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1 --include-attrib-secretParámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
Indica si se deben devolver secretos de atributo de entrega estáticos. True si la marca está presente.
Especifique para indicar si se debe devolver la dirección URL completa del punto de conexión. True si la marca está presente.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription show (eventgrid extensión)
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 de un tema del sistema.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-full-endpoint-url {false, true}]Ejemplos
Muestra los detalles de una suscripción de eventos para un tema del sistema de Event Grid.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1Parámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
Especifique para indicar si se debe devolver la dirección URL completa del punto de conexión. True si la marca está presente.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription update
Actualizar una suscripción de eventos de un tema del sistema.
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]Ejemplos
Actualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo punto de conexión.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=codeActualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo filtro subject-ends-with.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpgActualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo punto de conexión y un nuevo subject-ends- con filtrar una nueva lista de tipos de eventos incluidos.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeletedActualice una suscripción de eventos para un tema del sistema de Azure Event Grid para incluir un destino de deadletter.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1Actualice una suscripción de eventos para un tema del sistema de Azure Event Grid mediante filtros avanzados.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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.netActualización de una suscripción de eventos para un tema del sistema de Event Grid con la cola de Storage como destino con ttl de 5 minutos
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--storage-queue-msg-ttl 300Actualización de una suscripción de eventos para un tema del sistema de Event Grid con filtrado avanzado en matrices habilitadas
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--enable-advanced-filtering-on-arrays trueParámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
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.
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.
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.
Permite evaluar filtros avanzados en una matriz de valores en lugar de esperar un valor singular.
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.
Tipo del punto de conexión de destino.
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".
Lista separada por espacios de etiquetas que se van a asociar a esta suscripción de eventos.
Tiempo de vida del mensaje de cola de almacenamiento en segundos.
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.
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az eventgrid system-topic event-subscription update (eventgrid extensión)
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 de un tema del sistema.
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--included-event-types]
[--labels]
[--subject-begins-with]
[--subject-ends-with]Ejemplos
Actualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo punto de conexión.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=codeActualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo filtro subject-ends-with.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpgActualice una suscripción de eventos para un tema del sistema de Event Grid para especificar un nuevo punto de conexión y un nuevo subject-ends- con filtrar una nueva lista de tipos de eventos incluidos.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeletedActualice una suscripción de eventos para un tema del sistema de Azure Event Grid para incluir un destino de deadletter.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1Actualice una suscripción de eventos para un tema del sistema de Azure Event Grid mediante filtros avanzados.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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.netParámetros requeridos
Nombre de la suscripción de eventos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del tema del sistema.
Parámetros opcionales
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 StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Se pueden especificar varios filtros avanzados mediante más de un --advanced-filter argumento.
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.
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.
Tipo del punto de conexión de destino.
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.
Lista separada por espacios de etiquetas que se van a asociar a esta suscripción de eventos.
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.
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de