Compartir vía


Temas personalizados en Azure Event Grid

En un tema de Event Grid se proporciona un punto de conexión al que el origen envía los eventos. El publicador crea un tema de Event Grid y determina si un origen de evento necesita uno o más temas. Un tema se usa para una colección de eventos relacionados. Para responder a determinados tipos de eventos, los suscriptores deciden los temas a los que se suscriben.

Los temas personalizados son temas de terceros y de aplicación. Cuando cree un tema personalizado o se le dé acceso al mismo, verá ese tema personalizado en su suscripción. Los temas personalizados admiten la entrega de inserción. Consulte cuándo usar la entrega de extracción o inserción para ayudarle a decidir si la entrega de inserción es el enfoque adecuado según sus requisitos.

Cuando diseñe la aplicación, tiene que decidir cuántos temas se van a crear. Para soluciones relativamente grandes, cree un tema personalizado para cada categoría de eventos relacionados. Por ejemplo, considere una aplicación que administra cuentas de usuario y otra aplicación sobre pedidos de clientes. Es poco probable que todos los suscriptores de eventos quieran eventos de ambas aplicaciones. Para separar los problemas, cree dos temas: uno para cada aplicación. Permita que los controladores de eventos se suscriban al tema según sus requisitos. Para soluciones pequeñas, puede que prefiera enviar todos los eventos a un solo tema. Los suscriptores de eventos se pueden filtrar por los tipos de evento que desean.

Esquema del evento

Los temas personalizados admiten dos tipos de esquemas de eventos: eventos en la nube y esquema de Event Grid.

Esquema de eventos en la nube

Además de su esquema de eventos predeterminado, Azure Event Grid admite de forma nativa eventos de la implementación de JSON de CloudEvents v1.0 y el enlace del protocolo HTTP. CloudEvents es una especificación abierta para la descripción de datos de eventos.

CloudEvents simplifica la interoperabilidad al proporcionar un esquema de eventos común para la publicación y el consumo de eventos. Este esquema permite herramientas uniformes, formas estándar de enrutamiento y control de eventos, y una manera común de deserializar sus eventos. Con un esquema común, puede integrar más fácilmente el trabajo entre plataformas.

Nota:

Para más información, consulte Esquema de eventos en la nube.

Esquema de eventos de Event Grid

Cuando se usa el esquema de eventos de Event Grid, puede especificar las propiedades específicas de la aplicación en el objeto data.

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

Nota:

Para más información, consulte Esquema de eventos de Event Grid.

En las secciones siguientes se proporcionan vínculos a tutoriales para crear temas personalizados mediante Azure Portal, la CLI, PowerShell y plantillas de Azure Resource Manager (ARM).

Tutoriales de Azure Portal

En los siguientes inicios rápidos o tutoriales se muestra cómo crear un tema, enviar pares al punto de conexión del tema y enrutarlos a destinos admitidos mediante Azure Portal.

Título Descripción
Guía de inicio rápido: creación y enrutamiento de eventos personalizados con Azure Portal Muestra cómo utilizar Azure Portal para enviar eventos personalizados.
Guía de inicio rápido: enrutamiento de eventos personalizados a Azure Queue Storage Describe cómo enviar eventos personalizados a una instancia de Queue Storage.
Publicación en tema personalizado Se describe cómo publicar un evento en un tema personalizado.

Tutoriales de la CLI de Azure

En los siguientes inicios rápidos o tutoriales se muestra cómo crear un tema, enviar pares al punto de conexión del tema y enrutarlos a destinos admitidos mediante la CLI de Azure.

Título Descripción
Guía de inicio rápido: creación y enrutamiento de eventos personalizados con la CLI de Azure Muestra cómo utilizar la CLI de Azure para enviar eventos personalizados.
CLI de Azure: creación de un tema personalizado de Event Grid Script de ejemplo que crea un tema personalizado. El script recupera el punto de conexión y una clave.
CLI de Azure: suscripción a eventos de un tema personalizado Script de ejemplo que crea una suscripción a un tema personalizado. Envía eventos a un webhook.

Tutoriales de Azure PowerShell

En los siguientes inicios rápidos o tutoriales se muestra cómo crear un tema, enviar pares al punto de conexión del tema y enrutarlos a destinos admitidos mediante Azure PowerShell.

Título Descripción
Guía de inicio rápido: creación y enrutamiento de eventos personalizados con Azure PowerShell Muestra cómo utilizar Azure PowerShell para enviar eventos personalizados.
PowerShell: Creación de un tema personalizado de Event Grid Script de ejemplo que crea un tema personalizado. El script recupera el punto de conexión y una clave.
PowerShell: suscripción a eventos de un tema personalizado Script de ejemplo que crea una suscripción a un tema personalizado. Envía eventos a un webhook.

Tutoriales de plantillas de ARM

En los siguientes inicios rápidos o tutoriales se muestra cómo crear un tema y crear una suscripción al tema mediante plantillas de ARM.

Título Descripción
Plantilla de Resource Manager: tema personalizado y punto de conexión del webhook Plantilla de Resource Manager que crea un tema personalizado y una suscripción a ese tema personalizado. Envía eventos a un webhook.
Plantilla de Resource Manager: tema personalizado y punto de conexión a Event Hubs Plantilla de Resource Manager que crea una suscripción a un tema personalizado. Envía eventos a una instancia de Azure Event Hubs.

Nota:

Azure Digital Twins puede enrutar las notificaciones de eventos a los temas personalizados que cree con Event Grid. Para más información, consulte Puntos de conexión y rutas de eventos en la documentación de Azure Digital Twins.

Vea los artículos siguientes: