az eventgrid partner topic event-subscription
Administrar suscripciones de eventos del tema del asociado.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az eventgrid partner topic event-subscription create |
Cree una nueva suscripción de eventos para un tema de asociado. |
Núcleo | GA |
az eventgrid partner topic event-subscription delete |
Eliminar una suscripción de eventos de un tema de asociado. |
Núcleo | GA |
az eventgrid partner topic event-subscription list |
Enumerar suscripciones de eventos de un tema de asociado específico. |
Núcleo | GA |
az eventgrid partner topic event-subscription show |
Obtenga los detalles de una suscripción de eventos de un tema de asociado. |
Núcleo | GA |
az eventgrid partner topic event-subscription update |
Actualizar una suscripción de eventos de un tema de asociado. |
Núcleo | GA |
az eventgrid partner topic event-subscription create
Cree una nueva suscripción de eventos para un tema de asociado.
az eventgrid partner topic event-subscription create --name
--partner-topic-name
--resource-group
[--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 de asociado de Event Grid mediante filtros predeterminados.
az eventgrid partner topic event-subscription create --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Cree una nueva suscripción de eventos para un tema de asociado de Event Grid, con un filtro que especifique un prefijo de asunto.
az eventgrid partner topic event-subscription create --name es4 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Cree una nueva suscripción de eventos para un tema de asociado de Event Grid, con filtros predeterminados y CloudEvent V 1.0 como esquema de entrega.
az eventgrid partner topic event-subscription create -n es2 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Cree una nueva suscripción de eventos para un partnertopic 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 partner topic event-subscription create --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--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 de asociado de Event Grid mediante el webhook habilitado para Azure Active Directory como destino.
az eventgrid partner topic event-subscription create --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 asociado de Event Grid mediante Azure Function como destino.
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 asociado de Event Grid mediante la cola de Storage como destino con el mensaje ttl a 5 minutos
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 asociado de Event Grid con filtrado avanzado en matrices habilitadas
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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
Nombre de la suscripción de eventos.
Nombre del tema del asociado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
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 argumento de --advanced-filter
.
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 argumento --delivery-attribute-mapping
.
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 comprendido entre 1 y 5000.
Tamaño de lote preferido en kilobytes. Debe ser un número comprendido 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 admiten 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 admiten caracteres comodín.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Use --debug para registros de depuración completos.
az eventgrid partner topic event-subscription delete
Eliminar una suscripción de eventos de un tema de asociado.
az eventgrid partner topic event-subscription delete --name
--partner-topic-name
--resource-group
[--yes]
Ejemplos
Elimina una suscripción de eventos para un tema de asociado de Event Grid.
az eventgrid partner topic event-subscription delete --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
Parámetros requeridos
Nombre de la suscripción de eventos.
Nombre del tema del asociado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
No solicite confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Use --debug para registros de depuración completos.
az eventgrid partner topic event-subscription list
Enumerar suscripciones de eventos de un tema de asociado específico.
az eventgrid partner topic event-subscription list --partner-topic-name
--resource-group
[--odata-query]
Ejemplos
Enumere todas las suscripciones de eventos creadas para un tema de asociado de Event Grid.
az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1
Parámetros requeridos
Nombre del tema del asociado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Use --debug para registros de depuración completos.
az eventgrid partner topic event-subscription show
Obtenga los detalles de una suscripción de eventos de un tema de asociado.
az eventgrid partner topic event-subscription show --name
--partner-topic-name
--resource-group
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]
Ejemplos
Muestra los detalles de una suscripción de eventos para un tema de asociado de Event Grid.
az eventgrid partner topic event-subscription show --name es1 \
-g rg1 --partner-topic-name partnertopic1
Mostrar los detalles de una suscripción de eventos para un tema de asociado de Event Grid e incluir secretos de atributo de entrega estática
az eventgrid partner topic event-subscription show --name es1 \
-g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret
Parámetros requeridos
Nombre de la suscripción de eventos.
Nombre del tema del asociado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Use --debug para registros de depuración completos.
az eventgrid partner topic event-subscription update
Actualizar una suscripción de eventos de un tema de asociado.
az eventgrid partner topic event-subscription update --name
--partner-topic-name
--resource-group
[--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 de asociado de Event Grid para especificar un nuevo punto de conexión.
az eventgrid partner topic event-subscription update --name es1 \
-g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Actualice una suscripción de eventos para un tema de asociado de Event Grid para especificar un nuevo filtro subject-ends-with.
az eventgrid partner topic event-subscription update --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--subject-ends-with .jpg
Actualice una suscripción de eventos para un tema de asociado de Event Grid para especificar un nuevo punto de conexión y un nuevo subject-ends-with filtre una nueva lista de tipos de eventos incluidos.
az eventgrid partner topic event-subscription update --name es3 \
-g rg1 --partner-topic-name partnertopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Actualice una suscripción de eventos para un tema de asociado de Azure Event Grid para incluir un destino de entrega de mensajes fallidos.
az eventgrid partner topic event-subscription update --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Actualice una suscripción de eventos para un tema de asociado de Azure Event Grid mediante filtros avanzados.
az eventgrid partner topic event-subscription update --name es3 \
-g rg1 --partner-topic-name partnertopic1 \
--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
Actualización de una suscripción de eventos para un tema de asociado de Event Grid mediante la cola de Storage como destino con el mensaje ttl a 5 minutos
az eventgrid partner topic event-subscription update -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Actualización de una suscripción de eventos para un tema de asociado de Event Grid con filtrado avanzado en matrices habilitadas
az eventgrid partner topic event-subscription update -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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
Nombre de la suscripción de eventos.
Nombre del tema del asociado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
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 argumento de --advanced-filter
.
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 argumento --delivery-attribute-mapping
.
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 admiten caracteres comodín.
Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo. No se admiten caracteres comodín.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Use --debug para registros de depuración completos.