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.
# Utilisation des abonnements aux événements Amazon DocumentDB
Amazon DocumentDB utilise Amazon Simple Notification Service (Amazon SNS) pour envoyer des notifications lorsqu'un événement Amazon DocumentDB se produit. Ces notifications peuvent prendre n'importe quelle forme prise en charge par Amazon SNS, par exemple un e-mail Région AWS, un message texte ou un appel à un point de terminaison HTTP.
Amazon DocumentDB regroupe ces événements dans des catégories auxquelles vous pouvez vous abonner afin d'être averti lorsqu'un événement de cette catégorie se produit. Vous pouvez vous abonner à une catégorie d'événements pour une instance, un cluster, un instantané, un instantané de cluster ou un groupe de paramètres. Par exemple, si vous vous abonnez à la catégorie Backup pour une instance donnée, vous êtes averti chaque fois qu'un événement lié à la sauvegarde affecte l'instance. Vous recevez également une notification en cas de modification de l'abonnement à un événement.
Les événements se produisent à la fois au niveau du cluster et de l'instance. Vous pouvez donc recevoir des événements si vous vous abonnez à un cluster ou à une instance.
Les abonnements aux événements sont envoyés aux adresses que vous avez fournies lors de la création de l'abonnement. Vous souhaiterez peut-être créer plusieurs abonnements différents, tels qu'un abonnement qui reçoit toutes les notifications d'événements et un autre qui inclut uniquement les événements critiques pour vos instances de production. Vous pouvez facilement désactiver les notifications sans supprimer d'abonnement. Pour ce faire, réglez le bouton radio **Enabled** sur **Non** dans la console Amazon DocumentDB.
**Important**
Amazon DocumentDB ne garantit pas l'ordre des événements envoyés dans un flux d'événements. L’ordre des événements est susceptible de changer.
Amazon DocumentDB utilise le nom de ressource Amazon (ARN) d'une rubrique Amazon SNS pour identifier chaque abonnement. La console Amazon DocumentDB crée l'ARN pour vous lorsque vous créez l'abonnement.
La facturation des abonnements aux événements Amazon DocumentDB s'effectue via Amazon SNS. Des frais Amazon SNS s’appliquent en cas d’utilisation de la notification d’événement. Pour plus d'informations, consultez Tarification Amazon Simple Notification Service. Hormis les frais Amazon SNS, Amazon DocumentDB ne facture pas les abonnements aux événements.
**Topics**
+ [Abonnement aux événements](event-subscriptions.subscribe.md)
+ [Gérer les abonnements](event-subscriptions.managing.md)
+ [Catégories et messages](event-subscriptions.categories-messages.md)
# Abonnement aux événements Amazon DocumentDB
Vous pouvez utiliser la console Amazon DocumentDB pour vous abonner à des événements, comme suit :
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. Dans le volet **Abonnements aux événements**, choisissez **Créer un abonnement aux événements**.
![\[Le volet Abonnements aux événements met en évidence le bouton Créer un abonnement à un événement dans le coin supérieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. Dans la boîte de dialogue **Créer un abonnement aux événements**, exécutez l'une des actions suivantes :
+ Dans le champ **Nom**, entrez un nom pour l'abonnement à la notification d'événements.
![\[Le formulaire d'inscription à un événement présentant la section Détails et le champ de saisie du nom.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ Pour **Target**, choisissez l'adresse à laquelle vous souhaitez envoyer les notifications. Vous pouvez choisir un **ARN** existant ou choisir **Nouveau sujet d'e-mail** pour saisir le nom d'un sujet et une liste de destinataires.
![\[La section Cible contient des options permettant de spécifier à qui envoyer les notifications.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ Pour **Source**, choisissez un type de source. Selon le type de source que vous avez sélectionné, choisissez les catégories d'événement et les sources pour lesquelles vous souhaitez recevoir des notifications d'événements.
![\[La section Source permet de sélectionner le type de source dont vous souhaitez recevoir les notifications d'événements.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Choisissez **Créer**.
![\[La section Source avec le bouton Créer dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Gestion des abonnements aux notifications d'événements Amazon DocumentDB
Si vous choisissez **Abonnements aux événements** dans le volet de navigation de la console Amazon DocumentDB, vous pouvez consulter les catégories d'abonnement et la liste de vos abonnements actuels. Vous pouvez également modifier ou supprimer un abonnement spécifique.
## Pour modifier vos abonnements actuels aux notifications d'événements Amazon DocumentDB
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**. Le volet **Abonnements aux événements** affiche tous les abonnements aux notifications d’événements.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. Dans le volet **Abonnements aux événements**, choisissez l’abonnement que vous voulez modifier, puis choisissez **Modifier**.
![\[Le volet Abonnements aux événements affichant un abonnement sélectionné et le bouton Modifier.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Apportez les modifications requises à l’abonnement dans la section **Cible** ou **Source**. Vous pouvez ajouter ou supprimer des identifiants sources en les sélectionnant ou en annulant leur sélection dans la section Source.
![\[Le formulaire de modification de l'abonnement à un événement met en évidence la section Cible.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Sélectionnez **Modifier**. La console Amazon DocumentDB indique que l'abonnement est en cours de modification.
![\[Fin du formulaire d'inscription à un événement Modifier avec le bouton Modifier surligné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Supprimer un abonnement aux notifications d'événements Amazon DocumentDB
Vous pouvez supprimer un abonnement lorsque vous n’en avez plus besoin. Tous les abonnés à la rubrique ne reçoivent plus les notifications d’événements spécifiées par l’abonnement.
1. Connectez-vous à l' AWS Management Console adresse[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Dans le panneau de navigation, choisissez **Abonnements aux événements**.
![\[Volet de navigation de la console Amazon DocumentDB avec l'option d'abonnement aux événements surlignée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. Dans le volet **Mes abonnements aux événements de base de données**, cliquez sur l'abonnement que vous souhaitez supprimer.
![\[Le volet Abonnements aux événements affiche un abonnement sélectionné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Sélectionnez **Delete (Supprimer)**.
![\[Le volet Abonnements aux événements met en évidence le bouton Supprimer.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. Une fenêtre contextuelle apparaît pour vous demander si vous souhaitez supprimer définitivement cette notification. Sélectionnez **Delete (Supprimer)**.
![\[Une boîte de dialogue confirmant la suppression de l'abonnement à l'événement avec le bouton Supprimer surligné dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Catégories d'événements et messages Amazon DocumentDB
Amazon DocumentDB génère un nombre important d'événements dans des catégories auxquelles vous pouvez vous abonner à l'aide de la console. Chaque catégorie s'applique à un type de source, qui peut être une instance, un cluster, un instantané ou un groupe de paramètres.
**Note**
Amazon DocumentDB utilise les définitions d'événements Amazon RDS existantes et. IDs
## Événements Amazon DocumentDB provenant d'instances
| Catégorie | Description |
| --- | --- |
| disponibilité | L'instance a redémarré. |
| disponibilité | L'arrêt de l'instance. |
| modification de configuration | Appliquer une modification à une classe d'instance. |
| modification de configuration | L'application de la modification à une classe d'instance est terminée. |
| modification de configuration | Réinitialisez les informations d'identification principales. |
| création | Instance créée. |
| suppression | Instance supprimée |
| échec | L'instance a échoué en raison d'une configuration incompatible ou d'un problème de stockage sous-jacent. Commencez par point-in-time-restore pour l'instance. |
| notification | Instance arrêtée. |
| notification | Instance démarrée. |
| notification | L'instance est en cours de démarrage car le temps d'arrêt maximal autorisé est dépassé. |
| ponctuelle | La restauration de l'instance a commencé. Le temps de récupération varie selon la quantité de données à restaurer. |
| ponctuelle | La restauration de l'instance est terminée. |
| application de correctifs de sécurité | La mise à jour du système d'exploitation est disponible pour votre instance. Pour plus d'informations sur l'application des mises à jour, consultez [Maintenance d'Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Événements Amazon DocumentDB provenant d'un cluster
| Catégorie | Description |
| --- | --- |
| création | Cluster créé |
| suppression | Cluster supprimé. |
| basculement | Promouvoir à nouveau les primaires précédentes. |
| basculement | Le basculement vers l'instance est terminé. |
| basculement | Basculement commencé vers l'instance de base de données : %s |
| basculement | Démarrage du même basculement AZ vers l'instance de base de données : %s |
| basculement | Basculement inter-AZ lancé vers l'instance de base de données : %s |
| maintenance | Le cluster a été corrigé. |
| maintenance | Le cluster de base de données est dans un état qui ne peut pas être mis à niveau : %s |
| notification | Le cluster s'est arrêté. |
| notification | Le cluster a démarré. |
| notification | L'arrêt du cluster a échoué. |
| notification | Le cluster est en cours de démarrage car le temps d'arrêt maximal autorisé est dépassé. |
| notification | Cluster renommé de %s à %s. |
## Événements Amazon DocumentDB provenant d'un instantané du cluster
Le tableau suivant indique la catégorie d'événements et la liste des événements dont le type de source est un instantané de cluster Amazon DocumentDB.
| Catégorie | Description |
| --- | --- |
| sauvegarde | Création d'un instantané de cluster manuel. |
| sauvegarde | Instantané de cluster manuel créé. |
| sauvegarde | Création d'instantané de cluster automatisé. |
| sauvegarde | Instantané de cluster automatisé créé. |
## Événements Amazon DocumentDB provenant d'un groupe de paramètres
Le tableau suivant affiche la catégorie d’événement et la liste d’événements quand un groupe de paramètres est le type source.
| Catégorie | Description |
| --- | --- |
| modification de configuration | Paramètre %s mis à jour vers %s avec la méthode d'application %s |