Entrega de inserción con HTTP

  • Artículo

Este artículo se basa en ¿Qué es Azure Event Grid? para proporcionar información esencial antes de empezar a usar la entrega de inserción y extracción de Event Grid a través de HTTP. Trata conceptos fundamentales, modelos de recursos y modos de entrega de mensajes admitidos. 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 datos de dispositivo IoT, consulte Información general sobre la compatibilidad con MQTT en Azure Event Grid.

Conceptos principales

CloudEvents

Event Grid cumple con la especificación CloudEvents 1.0 estándar abierta de CNCF mediante el enlace de protocolo HTTP con formato JSON. Esto significa que las soluciones publican y consumen mensajes de eventos con un formato similar al 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 hacemos referencia a un evento, como se muestra anteriormente, como un evento discreto porque representa un hecho distintivo e independiente sobre un sistema que proporciona una conclusión que puede ser procesable. 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 se refiere a los eventos como a ese tipo de mensajes que llevan un punto de datos, como una sola lectura de un dispositivo o un solo clic en una página de una 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, nos referimos a ese tipo de evento como punto de datos, datos de streaming o telemetría. MQTT de Event Grid admite este tipo de datos y Azure Event Hubs, por lo general, los controla.

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, la suscripción a eventos se usa para establecer criterios de selección de eventos para definir la colección de eventos disponible para un suscriptor del conjunto total de eventos presentes en un tema.

Diagram showing a topic and associated event subscriptions.

Entrega de inserción

La entrega de inserción es compatible con los siguientes recursos. Haga clic en los vínculos para obtener más información sobre ellos.

  • 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 diferentes 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 una 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.

En el diagrama siguiente se muestran los recursos que admiten la entrega de inserción con algunos de los controladores de eventos admitidos.

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Nota:

Si está interesado en obtener más información sobre la entrega de inserción en 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.