Mettre à jour un bus EventBridge d'événements Amazon - Amazon EventBridge

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.

Mettre à jour un bus EventBridge d'événements Amazon

Vous pouvez mettre à jour la configuration des bus d'événements après les avoir créés. Cela inclut le bus d'événements par défaut, qui est EventBridge créé automatiquement dans votre compte.

Mettre à jour le KMS key code utilisé pour le chiffrement

Note

Les archives et la découverte de schémas ne sont pas prises en charge pour les bus d'événements chiffrés à l'aide d'un clé gérée par le client. Pour activer la découverte d'archives ou de schémas sur un bus d'événements, choisissez d'utiliser un Clé détenue par AWS. Pour plus d’informations, consultez Chiffrement au repos pour les bus dédiés aux événements.

Pour modifier le paramètre KMS key utilisé pour le chiffrement au repos sur un bus d'événements à l'aide de la EventBridge console
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, sélectionnez Event Buses (Bus d'événements).

  3. Choisissez le bus d'événements que vous souhaitez mettre à jour.

  4. Sur la page des détails du bus d'événements, choisissez l'onglet Chiffrement.

  5. Choisissez la forme KMS key EventBridge à utiliser lors du chiffrement des données d'événements stockées sur le bus d'événements :

    • Choisissez Utiliser Clé détenue par AWS pour chiffrer EventBridge les données à l'aide d'un Clé détenue par AWS.

      Il s' Clé détenue par AWS agit d'un compte KMS key qui EventBridge possède et gère pour une utilisation dans plusieurs AWS comptes. En général, à moins que vous ne soyez obligé d'auditer ou de contrôler la clé de chiffrement qui protège vos ressources, une Clé détenue par AWS est un bon choix.

      Il s’agit de l’option par défaut.

    • Choisissez Utiliser clé gérée par le client pour chiffrer les données EventBridge à l'aide de celles clé gérée par le client que vous spécifiez ou créez.

      Clés gérées par le client se trouvent KMS keys dans le AWS compte que vous créez, détenez et gérez. Vous en avez le plein contrôle KMS keys.

      1. Spécifiez un existant clé gérée par le client ou choisissez Créer un nouveau KMS key.

        EventBridge affiche le statut de la clé et tous les alias de clé associés à la clé spécifiée clé gérée par le client.

      2. Choisissez la file d'attente Amazon SQS à utiliser comme file d'attente de lettres mortes (DLQ) pour ce bus d'événements, le cas échéant.

        EventBridge envoie les événements qui ne sont pas correctement chiffrés au DLQ, s'il est configuré, afin que vous puissiez les traiter ultérieurement.

Mettre à jour les autorisations sur un bus d'événements

Vous pouvez accorder des autorisations supplémentaires à un bus d’événements en y attachant une politique basée sur les ressources. Pour obtenir des instructions détaillées sur la mise à jour des autorisations accordées à un bus d'événements, consultez la section Gestion des autorisations de bus d'événements.

Ajouter ou supprimer des archives sur les bus d'événements

Une archive vous permet de capturer des événements afin de pouvoir facilement les rejouer ultérieurement. Par exemple, vous souhaitez peut-être relire des événements pour récupérer suite à des erreurs ou pour valider une nouvelle fonctionnalité de votre application. Pour plus d'informations, consultez la section EventBridge Archiver et rejouer.

Note

Les archives et la découverte de schémas ne sont pas prises en charge pour les bus d'événements chiffrés à l'aide d'un clé gérée par le client. Pour activer la découverte d'archives ou de schémas sur un bus d'événements, choisissez d'utiliser un Clé détenue par AWS. Pour plus d’informations, consultez Chiffrement au repos pour les bus dédiés aux événements.

Pour ajouter ou supprimer une archive d'un bus d'événements à l'aide de la EventBridge console
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, sélectionnez Event Buses (Bus d'événements).

  3. Choisissez le bus d'événements que vous souhaitez mettre à jour.

  4. Sur la page des détails du bus d'événements, choisissez l'onglet Archives.

  5. Effectuez l’une des actions suivantes :

    • Pour ajouter une archive :

      1. Choisissez Créer une archive.

      2. Spécifiez les attributs de l'archive.

      3. Choisissez Suivant.

      4. Choisissez le modèle d'événements à appliquer aux événements de l'archive.

      5. Choisissez Créer une archive.

    • Pour supprimer une archive :

      1. Pour le tag que vous souhaitez supprimer, choisissez Supprimer.

      2. Entrez le nom de l'archive, puis choisissez Supprimer.

        L'archive est définitivement supprimée. Vous ne pouvez pas annuler cette opération.

Pour créer ou supprimer une archive pour un bus d'événements à l'aide du AWS CLI

Démarrage ou arrêt de la découverte de schémas sur les bus d'événements

Pour plus d'informations sur la découverte de schémas, consultez la section EventBridge Schémas.

Note

Les archives et la découverte de schémas ne sont pas prises en charge pour les bus d'événements chiffrés à l'aide d'un clé gérée par le client. Pour activer la découverte d'archives ou de schémas sur un bus d'événements, choisissez d'utiliser un Clé détenue par AWS. Pour plus d’informations, consultez Chiffrement au repos pour les bus dédiés aux événements.

Pour démarrer ou arrêter la découverte de schémas sur un bus d'événements à l'aide de la EventBridge console
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, sélectionnez Event Buses (Bus d'événements).

  3. Choisissez le bus d'événements que vous souhaitez mettre à jour.

  4. Effectuez l’une des actions suivantes :

    • Pour démarrer la découverte du schéma, choisissez Démarrer la découverte.

    • Pour arrêter la découverte du schéma, choisissez Supprimer la découverte.

Pour démarrer ou arrêter la découverte de schémas sur un bus d'événements à l'aide du AWS CLI

Ajouter ou supprimer des tags sur les bus d'événements

Une balise est une étiquette d'attribut personnalisée que vous attribuez ou AWS assignez à une AWS ressource. Utilisez des balises pour identifier et organiser vos AWS ressources. Pour plus d'informations, consultez la section EventBridge Tags.

Pour ajouter ou supprimer des balises d'un bus d'événements à l'aide de la EventBridge console
  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans le volet de navigation, sélectionnez Event Buses (Bus d'événements).

  3. Choisissez le bus d'événements que vous souhaitez mettre à jour.

  4. Sur la page des détails du bus d'événements, choisissez l'onglet Tags, puis sélectionnez Gérer les tags.

  5. Effectuez l’une des actions suivantes :

    • Pour ajouter un tag, procédez comme suit :

      1. Sélectionnez Ajouter une nouvelle balise.

      2. Spécifiez la clé et la valeur de la balise

      3. Choisissez Mettre à jour.

    • Pour supprimer un tag, procédez comme suit :

      1. Pour le tag que vous souhaitez supprimer, choisissez Supprimer.

      2. Choisissez Mettre à jour.

Pour ajouter ou supprimer des balises dans un bus d'événements à l'aide du AWS CLI

Mise à jour du bus d'événements par défaut à l'aide de AWS CloudFormation

AWS CloudFormation vous permet de configurer et de gérer vos AWS ressources sur l'ensemble des comptes et des régions de manière centralisée et reproductible en traitant l'infrastructure comme du code. CloudFormation pour ce faire, vous pouvez créer des modèles qui définissent les ressources que vous souhaitez approvisionner et gérer.

Étant donné EventBridge que le bus d'événements par défaut est automatiquement intégré à votre compte, vous ne pouvez pas le créer à l'aide d'un CloudFormation modèle, comme vous le feriez normalement pour toute ressource que vous souhaitez inclure dans une CloudFormation pile. Pour inclure le bus d'événements par défaut dans une CloudFormation pile, vous devez d'abord l'importer dans une pile. Une fois que vous avez importé le bus d'événements par défaut dans une pile, vous pouvez mettre à jour les propriétés du bus d'événements comme vous le souhaitez.

Pour importer une ressource existante dans une CloudFormation pile nouvelle ou existante, vous avez besoin des informations suivantes :

  • Identifiant unique de la ressource à importer.

    Pour les bus d'événements par défaut, l'identifiant est Name puis la valeur de l'identifiant estdefault.

  • Modèle qui décrit avec précision les propriétés actuelles de la ressource existante.

    L'extrait de modèle ci-dessous contient une AWS::Events::EventBus ressource qui décrit les propriétés actuelles d'un bus d'événements par défaut. Dans cet exemple, le bus d'événements a été configuré pour utiliser a clé gérée par le client et DLQ pour le chiffrement au repos.

    En outre, la AWS::Events::EventBus ressource qui décrit le bus d'événements par défaut que vous souhaitez importer doit inclure une DeletionPolicy propriété définie surRetain.

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Default event bus import example", "Resources": { "defaultEventBus": { "Type" : "AWS::Events::EventBus", "DeletionPolicy": "Retain", "Properties" : { "Name" : "default", "KmsKeyIdentifier" : "KmsKeyArn", "DeadLetterConfig" : { "Arn" : "DLQ_ARN" } } } } }

Pour plus d'informations, consultez la section Intégration des ressources existantes dans CloudFormation la gestion dans le Guide de CloudFormation l'utilisateur.