View a markdown version of this page

¿Qué es el EventBridge Custom Event Bus? - Amazon EventBridge

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

¿Qué es el EventBridge Custom Event Bus?

El bus de eventos EventBridge personalizado es un bus de eventos sin servidor que ejecuta un equipo y que utilizan muchos equipos y cuentas. Publicas eventos en él con PutEvents oPutRawEvents. Dirige cada evento a los suscriptores cuyos filtros coinciden con él y conserva una copia de cada evento durante el período de retención que tú establezcas en el autobús. Compartes el autobús con otras cuentas a través de AWS Resource Access Manager (AWS RAM), y cada una de esas cuentas adjunta sus propios suscriptores. El propietario del autobús no escribe ninguna ruta en su nombre.

En la EventBridge consola, el tipo de bus se muestra como Custom Event Bus para este autobús y Custom Event Bus: Classic para los autobuses que utilizan reglas y objetivos. Para ver los nombres de la CLI, el SDK y el IAM, consulte. Nombres, puntos finales y permisos de IAM para el bus de eventos personalizado

Características principales de

  • Cross-account compartir mediante AWS RAM cuatro permisos gestionados que permiten a una cuenta de consumidor publicar, suscribirse y adjuntar fuentes de eventos o los tres.

  • Retención de todos los eventos de 1 a 365 días, programados en el autobús.

  • Entrega ordenada (FIFO) dentro de un grupo de eventos, por suscriptor.

  • Una posición inicial para cada suscriptor, de modo que un nuevo suscriptor pueda leer los eventos retenidos y un suscriptor pausado pueda reanudarlos sin pérdidas.

  • Deduplicación en el momento de la publicación, por contenido o por clave que proporciones, en un período de 5 minutos.

  • PutRawEventspara JSON, Avro, Protobuf o bytes sin procesar, con deserialización del registro de esquemas para filtrarlos.

  • Objetivos universales que invocan directamente cualquier acción de la AWS API que cambie el estado, junto con los objetivos personalizados.

Recursos

Trabajas con tres recursos.

Bus de eventos

El bus de eventos recibe los eventos con los que publicas PutEvents oPutRawEvents, los dirige a los suscriptores y los retiene. Tú estableces el período de retención, una AWS KMS clave opcional y el uso compartido opcional entre cuentas en el autobús. Para conocer los estados por los que pasa un autobús, consultaLos estados de los buses y lo que permite cada uno.

Suscriptor

Un suscriptor nombra los eventos que desea, con filtros, y el único objetivo que los recibe. Lo creas conCreateSubscriber. Vigila un autobús, conserva los eventos que coinciden con sus filtros y, si lo desea, transforma cada uno de ellos y lo envía exactamente a un objetivo. Para enviar un evento a varios objetivos, cree un suscriptor para cada objetivo.

Origen del evento

Una fuente de eventos incorpora eventos a un bus desde un AWS servicio o desde un socio de software como servicio (SaaS). Lo creas asignando CreateEventSource un nombre al bus de origen y al de destino, y EventBridge mueves los eventos automáticamente.

Los nombres de recursos de Amazon (ARN) de autobuses y suscriptores terminan en un identificador que se EventBridge genera, por ejemploarn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef. Almacene el ARN completo en lugar del nombre. Si elimina un bus y crea otro con el mismo nombre, el nuevo bus tendrá un identificador diferente.

Un autobús, muchas cuentas

Para permitir que otra cuenta utilice tu autobús, compártela con uno de los permisos gestionados AWS RAM y adjúntale uno de los permisos gestionados, por ejemploAWSRAMEventBridgeEventBusV2SubscribeOnly, para que esa cuenta pueda vincular suscriptores. Luego, la cuenta crea y es propietaria de sus propios suscriptores en tu autobús: solo ve a sus suscriptores cuando los incluye en la lista y tú los ves a todos. Una cuenta de consumidor no puede cambiar ni eliminar el autobús, y puedes retirar a cualquiera de sus suscriptores con ellaRevokeResource. Para obtener información sobre los permisos, las políticas de recursos y la revocación, consulteCompartir un bus de eventos personalizado con otras cuentas.

Cómo el bus de eventos personalizado enruta y retiene los eventos

El autobús dirige cada evento a los suscriptores que coincidan a medida que llegan. El autobús también conserva el evento durante el número de días que configure. La retención posibilita dos funciones.

  • Un suscriptor puede empezar desde un punto del pasado. Así es como se reproducen los eventos retenidos y cómo un suscriptor que se crea hoy lee los eventos que se publicaron ayer.

  • Un suscriptor puede pausar y reanudar más tarde sin perder los eventos.

Para obtener más información, consulte Elegir el período de retención y Reproducción de eventos retenidos para un suscriptor.

En qué se diferencia el Custom Event Bus del Custom Event Bus - Classic

Funcionalidad Bus de eventos personalizado Autobús para eventos personalizado: clásico
Cross-account utilizar Comparte el autobús con AWS RAM. Cada cuenta de consumidor crea y es propietaria de sus suscriptores en el autobús. Concede acceso a otras cuentas mediante la política de recursos del autobús o reenvía los eventos a un autobús de la otra cuenta.
Retención Integrado en el autobús, durante el período que tú establezcas. No se conserva. Para conservar los eventos, agrega un archivo.
Ordenación Entrega FIFO dentro de un grupo de eventos, por suscriptor. No disponible.
Reproducción La posición inicial de un suscriptor respecto a los eventos retenidos. Reproducir desde un archivo.
Publica las API PutEventspara JSON y PutRawEvents para cualquier formato, incluidos Avro y Protobuf. PutEventspara JSON.
Desduplicación En el momento de la publicación, por contenido o por clave que proporciones. No disponible.
Objetivos por recurso de enrutamiento Un objetivo por suscriptor. Hasta cinco objetivos por regla.

Casos de uso

  • Un equipo de plataforma gestiona un orders autobús y lo comparte con las cuentas de los equipos de gestión logística, facturación y análisis. Cada equipo adjunta sus propios suscriptores; el equipo de la plataforma nunca edita las rutas para ellos.

  • Un servicio de pagos publica un número EventGroupId por cuenta y un suscriptor de FIFO envía los eventos de cada cuenta a una cola por orden.

  • Se crea un nuevo consumidor de análisis con una posición inicial de 30 días atrás y lee los eventos retenidos durante un mes antes de ponerse al día con el tráfico actual.

Precios

Usted paga por los eventos que publica, las entregas a los suscriptores y la retención. Para conocer las tarifas, consulta los EventBridge precios de Amazon.

Siguientes pasos