Création d'archives d'événements sur Amazon EventBridge - Amazon EventBridge
Définition de l'archiveCréez le modèle d'événement (facultatif)

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.

Création d'archives d'événements sur Amazon EventBridge

Lorsque vous créez une archive dans EventBridge, vous pouvez déterminer quels événements sont envoyés à l'archive en spécifiant un modèle d'événement. EventBridge envoie des événements qui correspondent au modèle d'événement à l'archive. Vous définissez également la période de conservation pour stocker les événements dans l’archive avant qu’ils ne soient supprimés.

Vous pouvez également créer des archives dans le cadre de la création d'un bus d'événements. Ces archives ont une politique de conservation illimitée et aucun filtre d'événements, bien que celui-ci puisse être mis à jour une fois l'archive créée.

Définition de l'archive

Entrez d'abord un nom et une description pour l'archive, puis spécifiez le bus d'événements à partir duquel elle reçoit les événements. Vous pouvez éventuellement définir la durée de conservation des événements dans l'archive.

Pour définir l'archive

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Accédez au bus d'événements source ou créez directement l'archive :

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

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

    • Dans le panneau de navigation, choisissez Archives.

  3. Choisissez Créer une archive.

  4. Sous Détails de l'archive, entrez un nom et éventuellement une description pour l'archive.

    Le nom doit être unique dans la région sélectionnée pour votre compte. Vous ne pouvez pas modifier le nom une fois que vous avez créé l’archive.

  5. Pour Source, sélectionnez le bus d'événements vers lequel vous souhaitez envoyer des événements à l'archive

    Si vous avez navigué depuis la page de détails d'un bus d'événements existant, le nom de ce bus d'événements apparaît par défaut.

    Vous ne pouvez pas modifier le bus d'événements source une fois que vous avez créé l'archive.

  6. Pour Période de conservation, spécifiez la durée de conservation des événements dans l'archive :

    • Choisissez Indéfini pour conserver les événements dans l’archive et ne jamais les supprimer.

    • Pour une période de conservation définie, entrez le nombre de jours après lesquels les événements EventBridge doivent être supprimés de l'archive.

  7. Choisissez Suivant.

Créez le modèle d'événement (facultatif)

Ensuite, en tant qu'étape facultative, vous pouvez créer un modèle d'événements pour filtrer les EventBridge événements envoyés à l'archive. Pour ce faire, spécifiez la source de l’événement, choisissez la base du modèle d’événement et définissez les attributs et les valeurs sur lesquels vous souhaitez établir une correspondance. Vous pouvez également générer le modèle d’événement au format JSON et le tester par rapport à un exemple d’événement.

Pour plus d'informations sur les modèles d'événements, consultez.

Pour créer le modèle d’événement

  1. Dans Source de l'événement, sélectionnez AWS événements ou événements EventBridge partenaires.

  2. (Facultatif) Dans la section Exemples d’événements, choisissez un Type d’exemple d’événement par rapport auquel vous souhaitez tester votre modèle d’événement.

    Les types d’exemples d’événements suivants sont disponibles :

    • AWS événements — Choisissez parmi les événements émis ou pris en charge Services AWS.

    • EventBridge événements partenaires : sélectionnez parmi les événements émis par des services tiers qui prennent en charge EventBridge, tels que Salesforce.

    • Saisir mon propre : entrez votre propre événement au format texte JSON.

      Vous pouvez également utiliser un événement AWS ou un événement partenaire comme point de départ pour créer votre propre événement personnalisé.

      1. Sélectionnez AWS des événements ou des événements EventBridge partenaires.

      2. Utilisez le menu déroulant Exemples d’événements pour sélectionner l’événement que vous souhaitez utiliser comme point de départ pour votre événement personnalisé.

        EventBridge affiche l'exemple d'événement.

      3. Sélectionnez Copier.

      4. Sélectionnez Saisir mon propre pour Type d’événement.

      5. Supprimez l'exemple de structure d'événement dans le volet d'édition JSON et collez l'événement AWS ou l'événement partenaire à sa place.

      6. Modifiez le code JSON de l’événement pour créer votre propre exemple d’événement.

  3. Choisissez une Méthode de création. Vous pouvez créer un modèle d'événement à partir d'un EventBridge schéma ou d'un modèle, ou vous pouvez créer un modèle d'événement personnalisé.

    Existing schema

    Pour utiliser un EventBridge schéma existant afin de créer le modèle d'événement, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, sélectionnez Utiliser le schéma.

    2. Dans la section Modèle d’événement, pour Type de schéma, sélectionnez Sélectionner un schéma dans le registre des schémas.

    3. Pour le Registre des schémas, cliquez sur la liste déroulante et entrez le nom d’un registre de schémas, tel que aws.events. Vous pouvez également sélectionner une option dans la liste déroulante qui s’affiche.

    4. Pour Schéma, cliquez sur la liste déroulante et entrez le nom du schéma à utiliser. Par exemple, aws.s3@ObjectDeleted. Vous pouvez également sélectionner une option dans la liste déroulante qui s’affiche.

    5. Dans la section Modèles, cliquez sur le bouton Modifier en regard de n’importe quel attribut pour ouvrir ses propriétés. Définissez les champs Relation et Valeur selon vos besoins, puis choisissez Jeu pour enregistrer l’attribut.

      Note

      Pour en savoir plus sur la définition d’un attribut, cliquez sur l’icône Infos en regard du nom de l’attribut. Pour savoir comment définir les propriétés des attributs dans votre événement, ouvrez la section Remarque de la boîte de dialogue des propriétés des attributs.

      Pour supprimer les propriétés d’un attribut, cliquez sur le bouton Modifier correspondant à cet attribut, puis choisissez Effacer.

    6. Choisissez Générer un modèle d’événement au format JSON pour générer et valider votre modèle d’événement sous forme de texte JSON.

    7. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

    Custom schema

    Pour écrire un schéma personnalisé et le convertir en modèle d’événement, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, choisissez Utiliser le schéma.

    2. Dans la section Modèle d’événement, pour Type de schéma, choisissez Saisir le schéma.

    3. Entrez votre schéma dans la zone de texte. Vous devez mettre en forme le schéma au format texte JSON valide.

    4. Dans la section Modèles, cliquez sur le bouton Modifier en regard de n’importe quel attribut pour ouvrir ses propriétés. Définissez les champs Relation et Valeur selon vos besoins, puis choisissez Jeu pour enregistrer l’attribut.

      Note

      Pour en savoir plus sur la définition d’un attribut, cliquez sur l’icône Infos en regard du nom de l’attribut. Pour savoir comment définir les propriétés des attributs dans votre événement, ouvrez la section Remarque de la boîte de dialogue des propriétés des attributs.

      Pour supprimer les propriétés d’un attribut, cliquez sur le bouton Modifier correspondant à cet attribut, puis choisissez Effacer.

    5. Choisissez Générer un modèle d’événement au format JSON pour générer et valider votre modèle d’événement sous forme de texte JSON.

    6. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

    Event pattern

    Pour écrire un modèle d’événement personnalisé au format JSON, procédez comme suit :

    1. Dans la section Méthode de création, pour Méthode, choisissez Modèle personnalisé (éditeur JSON).

    2. Pour Modèle d’événement, entrez votre modèle d’événement personnalisé au format texte JSON.

    3. (Facultatif) Pour tester l’exemple d’événement par rapport à votre modèle de test, choisissez Modèle de test.

      EventBridge affiche une boîte de message indiquant si votre exemple d'événement correspond au modèle d'événement.

      Vous pouvez également choisir l’une des options suivantes :

      • Copier : copiez le modèle d’événement dans le presse-papiers de votre appareil.

      • Prettify : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

      • Formulaire de modèle d’événement : ouvre le modèle d’événement dans le Générateur de modèle. Si le modèle ne peut pas être affiché tel quel dans Pattern Builder, vous EventBridge avertit avant qu'il n'ouvre Pattern Builder.

  4. Choisissez Créer une archive.

Pour confirmer que les événements ont bien été envoyés à l'archive, vous pouvez utiliser le DescribeArchivefonctionnement de l' EventBridge API pour voir si cela EventCount reflète le nombre d'événements contenus dans l'archive. Si la valeur est égale à 0, il n’y a aucun événement dans l’archive.