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
<a name="eb-archive-event"></a>

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](eb-event-patterns.md). 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). Ces archives ont une politique de conservation illimitée et aucun filtre d'événements, bien que celui-ci puisse être [mis à jour](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html) une fois l'archive créée.

**Topics**
+ [Définition de l'archive](#eb-create-archive-define)
+ [Créez le modèle d'événement (facultatif)](#eb-create-archive-event-pattern)

## Définition de l'archive
<a name="eb-create-archive-define"></a>

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/](https://console.aws.amazon.com/events/).

1. 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**.

1. Choisissez **Créer une archive**.

1. 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.

1. 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.

1. 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.

1. Pour le **chiffrement**, choisissez la clé KMS EventBridge à utiliser lors du chiffrement des événements stockés dans l'archive.
**Important**  
Si vous avez spécifié EventBridge l'utilisation d'une clé gérée par le client pour chiffrer le bus d'événements source, nous vous recommandons vivement de spécifier également une clé gérée par le client pour toutes les archives du 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'une clé KMS qui EventBridge possède et gère pour être utilisée 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 la clé gérée par le client** EventBridge pour chiffrer les données à l'aide de la clé gérée par le client que vous spécifiez ou créez.

     Les clés gérées par le client sont des clés KMS de votre AWS compte que vous créez, détenez et gérez. Vous avez un contrôle total sur ces clés KMS.

     1. Spécifiez une clé gérée par le client existante ou choisissez **Créer une nouvelle clé KMS />**.

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

1. Choisissez **Suivant**.

## Créez le modèle d'événement (facultatif)
<a name="eb-create-archive-event-pattern"></a>

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[](eb-event-patterns.md).

**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**.

1. (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**.

     1. 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.

     1. Sélectionnez **Copier**.

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

     1. 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.

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

1. 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**.

   1. 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**.

   1. 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.

   1. 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.

   1. 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**.

   1. 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. 

   1. (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**.

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

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

   1. 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**.

   1. 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. 

   1. (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)**.

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

   1. (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.

------

1. Choisissez **Créer une archive**.

Pour vérifier que les événements ont bien été envoyés à l'archive, vous pouvez utiliser le [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html)fonctionnement 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.