Compartir a través de

Entrega por empuje con HTTP

Este artículo se basa en el artículo '¿Qué es Azure Event Grid?' para proporcionar información esencial antes de empezar a usar la extracción y entrega de Event Grid mediante HTTP. Trata los conceptos fundamentales, los modelos de recursos y los modos de entrega de mensajes. Al final de este documento, encontrará vínculos útiles a artículos que le pueden guiar sobre cómo usar Event Grid y artículos que ofrecen información conceptual detallada.

Importante

Este documento le ayuda a empezar a trabajar con las funcionalidades de Event Grid que usan el protocolo HTTP. Este artículo es adecuado para los usuarios que necesitan integrar aplicaciones en la nube. Si necesita comunicar los datos del dispositivo IoT, consulte Introducción a la compatibilidad con MQTT en Azure Event Grid.

Conceptos principales

CloudEvents

Event Grid cumple con el estándar abierto Cloud Native Computing Foundation (CNCF) CloudEvents 1.0 mediante la vinculación de protocolo HTTP con formato JSON. Esta conformidad significa que las soluciones publican y consumen mensajes de eventos mediante un formato similar al ejemplo siguiente:

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

¿Qué es un evento?

Un evento es la cantidad mínima de información que describe completamente algo que se ha producido en un sistema. A menudo, un evento se conoce como un evento discreto porque representa un hecho independiente y independiente sobre un sistema que proporciona una información que puede ser accionable. Algunos ejemplos son: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Nota:

Usamos indistintamente los términos eventos discretos, eventos en la nube o simplemente eventos para hacer referencia a esos mensajes que informan sobre un cambio de estado del sistema.

Para obtener más información sobre los eventos, consulte la Terminología de Event Grid.

Otro tipo de evento

La comunidad de usuarios también hace referencia a eventos como aquellos tipos de mensajes que llevan un punto de datos, como una sola lectura de un dispositivo o un solo clic en una página de aplicación web. Ese tipo de evento normalmente se analizan observando un período de tiempo o un tamaño de flujo de eventos para derivar información y realizar una acción. En la documentación de Event Grid, ese tipo de evento se conoce como punto de datos, datos de streaming o telemetría. Son un tipo de datos que admite el protocolo Message Queuing Telemetry Transport (MQTT) de Event Grid y que suele manejar Azure Event Hubs.

Temas y suscripciones a eventos

Los eventos publicados en Event Grid llegan a un tema, que es un recurso que contiene lógicamente todos los eventos. Una suscripción a eventos es un recurso de configuración asociado a un único tema. Entre otras cosas, use una suscripción de eventos para establecer criterios de selección de eventos para definir la colección de eventos disponible para un suscriptor fuera del conjunto total de eventos presentes en un tema.

Diagrama que muestra un tema y las suscripciones a eventos asociadas.

Entrega de mensajes push

Los siguientes recursos admiten la entrega push. Seleccione los vínculos para obtener más información sobre cada recurso.

  • Temas del sistema. Use temas del sistema para recibir eventos (del sistema) de los servicios de Azure.
  • Temas personalizados. Use temas personalizados cuando quiera publicar los eventos de la aplicación.
  • Dominios. Los dominios representan un grupo de temas de dominio asociados normalmente a una sola aplicación que requiere el envío de eventos a distintos grupos de usuarios, organizaciones o aplicaciones. Un enfoque común es asociar un tema de dominio a un grupo de aplicaciones de destino o usuarios de una organización dentro del mismo inquilino. Una organización puede ser un equipo, una división en la empresa, una empresa, etc.
  • Temas de asociados. Use temas de asociados cuando quiera consumir eventos de asociados de terceros.

Configure una suscripción de eventos en un tema del sistema, personalizado o asociado para especificar un criterio de filtrado para eventos y establecer un destino en uno de los controladores de eventos admitidos.

El siguiente diagrama ilustra los recursos que admiten la entrega push con algunos de los controladores de eventos compatibles.

Diagrama de alto nivel que muestra todos los tipos de tópicos que admiten la entrega por envío, a saber, Tópicos de Sistema, Personalizados, de Dominio y de Asociados.

Nota:

Para obtener más información sobre la entrega push en los espacios de nombres de Event Grid, consulte [namespace-push-delivery-overview.md].

Pasos siguientes

En los artículos siguientes se proporciona información sobre cómo usar Event Grid o se proporciona información adicional sobre los conceptos.

  • Last updated on