Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Qu'est-ce que le EventBridge Custom Event Bus ?
Le EventBridge Custom Event Bus est un bus d'événements sans serveur géré par une équipe et utilisé par de nombreuses équipes et comptes. Vous y publiez des événements avec PutEvents ouPutRawEvents. Il achemine chaque événement vers les abonnés dont les filtres correspondent et conserve une copie de chaque événement pendant une période de conservation que vous avez définie dans le bus. Vous partagez le bus avec d'autres comptes via AWS Resource Access Manager (AWS RAM), et chacun de ces comptes associe ses propres abonnés. Le propriétaire du bus n'écrit aucun itinéraire en son nom.
Dans la EventBridge console, le type de bus est affiché comme Custom Event Bus pour ce bus et Custom Event Bus - Classic pour les bus qui utilisent des règles et des cibles. Pour les noms de la CLI, du SDK et de l'IAM, consultez. Noms, points de terminaison et autorisations IAM pour le bus d'événements personnalisé
Fonctionnalités principales
-
Cross-account partage via AWS RAM, avec quatre autorisations gérées qui permettent à un compte client de publier, de s'abonner, de joindre des sources d'événements, ou les trois.
-
Conservation de chaque événement pendant 1 à 365 jours, défini dans le bus.
-
Livraison commandée (FIFO) au sein d'un groupe d'événements, par abonné.
-
Une position de départ pour chaque abonné, afin qu'un nouvel abonné puisse lire les événements mémorisés et qu'un abonné en pause puisse reprendre sans perte.
-
Déduplication au moment de la publication, par contenu ou par une clé que vous fournissez, dans un délai de 5 minutes.
-
PutRawEventspour JSON, Avro, Protobuf ou des octets bruts, avec désérialisation du registre des schémas pour le filtrage. -
Des cibles universelles qui appellent directement toute action d' AWS API modifiant l'état, en plus des cibles personnalisées.
Ressources
Vous travaillez avec trois ressources.
- Bus d’événement
-
Le bus des événements reçoit les événements que vous publiez avec
PutEventsouPutRawEvents, les achemine vers les abonnés et les conserve. Vous définissez la période de rétention, une AWS KMS clé facultative et le partage optionnel entre comptes sur le bus. Pour les États traversés par un bus, voirLes états des bus et ce que chacun autorise. - Subscriber
-
Un abonné nomme les événements que vous souhaitez, avec des filtres, et la seule cible qui les reçoit. Vous le créez avec
CreateSubscriber. Il surveille un bus, conserve les événements correspondant à ses filtres, transforme éventuellement chacun d'eux et les transmet exactement à une cible. Pour envoyer un événement à plusieurs cibles, créez un abonné pour chaque cible. - Source de l’événement
-
Une source d'événements ingère des événements dans un bus à partir d'un AWS service ou d'un partenaire de logiciel en tant que service (SaaS). Vous le créez en
CreateEventSourcenommant le bus d'origine et le bus de destination, et EventBridge vous déplacez les événements pour vous.
Les Amazon Resource Names (ARN) des bus et des abonnés se terminent par un identifiant EventBridge généré, par exemplearn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef. Stockez l'ARN complet plutôt que le nom. Si vous supprimez un bus et que vous en créez un autre portant le même nom, le nouveau bus possède un identifiant différent.
Un bus, de nombreux comptes
Pour autoriser un autre compte à utiliser votre bus, partagez-le avec l'une des autorisations gérées AWS RAM et associez-le à l'une des autorisations gérées, par exemple pour permettre AWSRAMEventBridgeEventBusV2SubscribeOnly à ce compte d'associer des abonnés. Le compte crée et possède ensuite ses propres abonnés dans votre bus : il ne voit que ses abonnés lorsqu'il les répertorie, et vous les voyez tous. Un compte client ne peut pas modifier ou supprimer le bus, et vous pouvez retirer n'importe lequel de ses abonnés avecRevokeResource. Pour les autorisations, les politiques relatives aux ressources et la révocation, consultezPartager un bus d'événements personnalisé avec d'autres comptes.
Comment le Custom Event Bus achemine et conserve les événements
Le bus achemine chaque événement vers les abonnés correspondants au fur et à mesure de son arrivée. Le bus conserve également l'événement pendant le nombre de jours que vous configurez. La rétention permet deux fonctionnalités.
-
Un abonné peut repartir d'un point dans le passé. C'est ainsi que vous rejouez les événements conservés et que l'abonné que vous créez aujourd'hui lit les événements publiés hier.
-
Un abonné peut faire une pause et reprendre ultérieurement sans perdre d'événements.
Pour plus d’informations, consultez Choix de la durée de conservation et Rediffusion des événements enregistrés à un abonné.
En quoi le Custom Event Bus diffère-t-il du Custom Event Bus - Classic
| Capacité | Bus événementiel personnalisé | Bus événementiel personnalisé - Classic |
|---|---|---|
| Cross-account utiliser | Partagez le bus avec AWS RAM. Chaque compte client crée et possède ses abonnés dans le bus. | Accordez d'autres comptes via la politique de ressources du bus ou transférez les événements à un bus de l'autre compte. |
| Retention | Intégré au bus, pour une durée que vous définissez. | Non retenu. Pour conserver les événements, ajoutez une archive. |
| Commander | Diffusion FIFO au sein d'un groupe d'événements, par abonné. | Indisponible. |
| Relire | Position de départ d'un abonné par rapport aux événements retenus. | Rediffusion à partir d'une archive. |
| Publier des API | PutEventspour JSON et PutRawEvents pour tous les formats, y compris Avro et Protobuf. |
PutEventspour JSON. |
| Déduplication | Au moment de la publication, par contenu ou par clé que vous fournissez. | Indisponible. |
| Cibles par ressource de routage | Un objectif par abonné. | Jusqu'à cinq cibles par règle. |
Cas d’utilisation
-
Une équipe de plateforme gère un
ordersbus et le partage avec les comptes des équipes chargées de la distribution, de la facturation et des analyses. Chaque équipe associe ses propres abonnés ; l'équipe de la plateforme ne modifie jamais le routage pour eux. -
Un service de paiement publie avec un numéro
EventGroupIdpar compte et un abonné FIFO transmet les événements de chaque compte à une file d'attente dans l'ordre. -
Un nouveau consommateur d'analyses est créé avec une position de départ 30 jours en arrière et lit un mois d'événements conservés avant de rattraper le trafic réel.
Tarification
Vous payez pour les événements que vous publiez, les livraisons aux abonnés et la fidélisation. Pour les tarifs, consultez la section EventBridge Tarification d'Amazon
Étapes suivantes
-
Découvrez les noms à utiliser dans la CLI, les SDK et IAM :. Noms, points de terminaison et autorisations IAM pour le bus d'événements personnalisé
-
Publiez vos premiers événements :Publication d'événements dans un bus d'événements personnalisé.
-
Créez un abonné qui les livre :S'abonner à des événements sur un bus événementiel personnalisé.
