Transfert des abonnements aux événements vers Amazon EventBridge Utilisation des événements et des notifications Amazon SNS Catégories d'événements et messages d'événements AWS DMS pour les notifications SNS Abonnement aux notifications d'événement AWS DMS à l'aide de SNS

Utilisation des événements et des notifications Amazon SNS dans AWS Database Migration Service

Depuis la publication d'AWS DMS 3.4.5 et avec les versions ultérieures, nous vous recommandons d'utiliser Amazon EventBridge pour envoyer des notifications quand un événement AWS DMS se produit. Pour plus d'informations sur l'utilisation des événements EventBridge avec AWS DMS, consultez Utilisation des événements et des notifications Amazon EventBridge dans AWS Database Migration Service.

Transfert des abonnements aux événements vers Amazon EventBridge

Vous pouvez utiliser la commande AWS CLI suivante pour migrer les abonnements aux événements actifs à partir de DMS vers Amazon EventBridge, jusqu'à 10 à la fois.

update-subscriptions-to-event-bridge [--force-move | --no-force-move]

Par défaut, AWS DMS migre uniquement les abonnements aux événements actifs lorsque votre instance de réplication est à jour avec AWS DMS 3.4.5 ou version ultérieure. Pour remplacer ce comportement par défaut, utilisez l'option --force-move. Toutefois, certains types d'événements peuvent ne pas être disponibles en utilisant Amazon EventBridge si vos instances de réplication ne sont pas mises à niveau.

Pour exécuter la commande CLI update-subscriptions-to-event-bridge, un utilisateur AWS Identity and Access Management (IAM) doit disposer des autorisations de politique suivantes.


{
  "Version": "2012-10-17",
  "Statement": [
      {
          "Effect": "Allow",
          "Action": [
              "SNS:GetTopicAttributes",
              "SNS:SetTopicAttributes",
              "events:PutTargets",
              "events:EnableRule",
              "events:PutRule"
          ],
          "Resource": "*"
      }
  ]
}

Pour plus d'informations sur le transfert des abonnements vers EventBridge, consultez UpdateSubscriptionsToEventBridge dans Référence d'API AWS Database Migration Service.

Utilisation des événements et des notifications Amazon SNS

AWS DMS versions 3.4.5 et antérieures prennent en charge le traitement des événements et des notifications comme décrit ci-dessous.

AWS Database Migration Service (AWS DMS) peut utiliser Amazon Simple Notification Service (Amazon SNS) pour envoyer des notifications lorsqu'un événement AWS DMS se produit, par exemple lors de la création ou de la suppression d'une instance de réplication. Vous pouvez utiliser ces notifications sous n'importe quelle forme prise en charge par Amazon SNS pour une région AWS, telle qu'un e-mail, un message texte ou un appel à un point de terminaison HTTP.

AWS DMS groupe les événements en catégories auxquelles vous pouvez vous abonner afin d'être averti lorsqu'un événement de cette catégorie se produit. Par exemple, si vous vous abonnez à la catégorie de création d'une instance de réplication donnée, vous recevez une notification chaque fois que survient un événement lié à la création qui affecte votre instance de réplication. Si vous vous abonnez à la catégorie Modification de configuration pour une instance de réplication, vous recevez une notification en cas de modification de la configuration de l'instance de réplication. Vous recevez également une notification en cas de modification d'un abonnement à une notification d'évènements. Pour obtenir la liste des catégories d'événements fournies par AWS DMS, consultez Catégories d'événements et messages d'événements AWS DMS pour les notifications SNS, ci-dessous.

AWS DMS envoie des notifications d'événement aux adresses que vous fournissez lorsque vous créez un abonnement aux événements. Il se peut que vous souhaitiez créer plusieurs abonnements différents, tel qu'un abonnement recevant toutes les notifications d'événements et un autre abonnement incluant uniquement les événements critiques pour vos ressources DMS de production. Vous pouvez facilement désactiver les notifications sans supprimer un abonnement. Pour ce faire, désélectionnez l'option Activé dans la console AWS DMS ou définissez le paramètre Enabled sur false à l'aide de l'API AWS DMS.

Note

Les notifications d'événement AWS DMS utilisant les messages texte SMS sont actuellement disponibles pour les ressources AWS DMS dans toutes les régions AWS où Amazon SNS est pris en charge. Pour obtenir la liste des pays et des régions AWS où Amazon SNS prend en charge la messagerie SMS, consultez Pays et régions pris en charge.

Pour plus d'informations sur l'utilisation des SMS avec SNS, consultez Envoi et réception de notifications par SMS avec Amazon SNS.

Les notifications d'événement AWS DMS diffèrent des événements CloudTrail dans CloudWatch ou EventBridge. Les notifications d'événement CloudTrail peuvent être générées par n'importe quelle invocation d'API. DMS envoie une notification uniquement quand un événement DMS se produit.

AWS DMS utilise un identificateur d'abonnement pour identifier chaque abonnement. Plusieurs abonnements aux événements AWS DMS peuvent être publiés dans la même rubrique Amazon SNS. Lorsque vous utilisez la notification d'événement, les tarifs Amazon SNS s'appliquent ; pour plus d'informations sur la facturation d'Amazon SNS, consultez Tarification d'Amazon SNS.

Pour vous abonner à des événements AWS DMS avec Amazon SNS, utilisez le processus suivant :

Créer une rubrique Amazon SNS. Dans la rubrique, indiquez le type de notification que vous souhaitez recevoir et à quelle adresse ou quel numéro elle doit être envoyée.
Créez un abonnement aux notifications d'événement AWS DMS à l'aide de la AWS Management Console, d'AWS CLI ou de l'API AWS DMS.
AWS DMS envoie un e-mail d'approbation ou un SMS aux adresses que vous avez fournies avec votre abonnement. Pour valider votre abonnement, cliquez sur le lien dans l'e-mail d'approbation ou le SMS.
Lorsque vous avez confirmé l'abonnement, le statut de celui-ci est mis à jour dans la section Abonnements aux événements de la console AWS DMS.
Vous commencez alors à recevoir des notifications d'évènements.

Pour obtenir la liste des catégories et événements dont vous pouvez être informé, consultez la section suivante. Pour plus de détails sur l'abonnement et l'utilisation des abonnements aux événements AWS DMS, consultez Abonnement aux notifications d'événement AWS DMS à l'aide de SNS.

Rubriques

Catégories d'événements et messages d'événements AWS DMS pour les notifications SNS

Important

AWS DMS génère un nombre important d'événements dans des catégories auxquelles vous pouvez vous abonner à l'aide de la console AWS DMS ou de l'API AWS DMS. Chaque catégorie s'applique à un type de source ; AWS DMS prend actuellement en charge les types de source suivants : instance de réplication et tâche de réplication.

Le tableau suivant recense les catégories et événements possibles pour le type de source instance de réplication.

Catégorie	ID d'événement DMS	Description
Modification de configuration	DMS-EVENT-0012	La classe d'instances de réplication de cette instance de réplication est en cours de modification.
Modification de configuration	DMS-EVENT-0014	La classe d'instances de réplication de cette instance de réplication a changé.
Modification de configuration	DMS-EVENT-0018	L'espace de stockage de l'instance de réplication est en cours d'augmentation.
Modification de configuration	DMS-EVENT-0017	L'espace de stockage de l'instance de réplication a été augmenté.
Modification de configuration	DMS-EVENT-0024	L'instance de réplication est en cours de transition vers une configuration multi-AZ.
Modification de configuration	DMS-EVENT-0025	L'instance de réplication a terminé sa transition vers une configuration multi-AZ.
Modification de configuration	DMS-EVENT-0030	L'instance de réplication est en cours de transition vers une configuration mono-AZ.
Modification de configuration	DMS-EVENT-0029	L'instance de réplication a terminé sa transition vers une configuration mono-AZ.
Création	DMS-EVENT-0067	Une instance de réplication est en cours de création.
Création	DMS-EVENT-0005	Une instance de réplication est créée.
Suppression	DMS-EVENT-0066	L'instance de réplication est en cours de suppression.
Suppression	DMS-EVENT-0003	L'instance de réplication est supprimée.
Maintenance	DMS-EVENT-0047	Le logiciel de gestion figurant sur l'instance de réplication a été mis à jour.
Maintenance	DMS-EVENT-0026	La maintenance hors connexion de l'instance de réplication est en cours. L'instance de réplication n'est pas disponible actuellement.
Maintenance	DMS-EVENT-0027	La maintenance hors connexion de l'instance de réplication est terminée. L'instance de réplication est désormais disponible.
Maintenance	DMS-EVENT-0068	Une instance de réplication est dans un état qui ne peut pas être mis à niveau.
Stockage faible	DMS-EVENT-0007	L'instance de réplication a consommé plus de 90 % de son stockage alloué. Vous pouvez surveiller l'espace de stockage d'une instance de réplication à l'aide de la métrique Espace de stockage disponible.
Basculement	DMS-EVENT-0013	Le basculement a commencé pour une instance de réplication multi-AZ.
Basculement	DMS-EVENT-0049	Le basculement est terminé pour une instance de réplication multi-AZ.
Basculement	DMS-EVENT-0015	Le basculement multi-AZ vers l'instance de secours est terminé.
Basculement	DMS-EVENT-0050	L'activation multi-AZ a commencé.
Basculement	DMS-EVENT-0051	L'activation multi-AZ est terminée.
Basculement	DMS-EVENT-0034	Si vous demandez trop souvent un basculement, cet événement se produit à la place des événements de basculement standard.
Échec	DMS-EVENT-0031	L'instance de réplication a subi un échec de stockage.
Échec	DMS-EVENT-0036	L'instance de réplication a échoué en raison d'une incompatibilité de réseau.
Échec	DMS-EVENT-0037	Le service ne peut pas accéder à la clé AWS KMS utilisée pour chiffrer le volume de données.

Le tableau suivant recense les catégories et événements possibles pour le type de source tâche de réplication.

Catégorie	ID d'événement DMS	Description
Modification d'état	DMS-EVENT-0069	La tâche de réplication a commencé.
Modification d'état	DMS-EVENT-0081	Un rechargement des détails d'une table a été demandé.
Modification d'état	DMS-EVENT-0079	La tâche de réplication s'est arrêtée.
Modification d'état	DMS-EVENT-0091	Lecture mise en pause, limite de fichiers d'échange atteinte.
Modification d'état	DMS-EVENT-0092	Lecture mise en pause, limite d'utilisation du disque atteinte.
Modification d'état	DMS-EVENT-0093	La lecture a repris.
Échec	DMS-EVENT-0078	La tâche de réplication a échoué.
Échec	DMS-EVENT-0082	Un appel de suppression de la tâche n'a pas réussi à nettoyer les données de la tâche.
Modification de configuration	DMS-EVENT-0080	La tâche de réplication est modifiée.
Suppression	DMS-EVENT-0073	La tâche de réplication est supprimée.
Création	DMS-EVENT-0074	La tâche de réplication est créée.

L'exemple suivant montre un abonnement aux événements AWS DMS de la catégorie Modification d'état.



            Resources: 
                DMSEvent: 
                    Type: AWS::DMS::EventSubscription 
                    Properties: 
                        Enabled: true 
                        EventCategories: State Change 
                        SnsTopicArn: arn:aws:sns:us-east-1:123456789:testSNS 
                        SourceIds: [] 
                        SourceType: replication-task

Abonnement aux notifications d'événement AWS DMS à l'aide de SNS

Important

Vous pouvez créer un abonnement aux notifications d'événements AWS DMS afin de pouvoir être informé quand un événement AWS DMS se produit. La solution la plus simple pour créer un abonnement consiste à utiliser la console AWS DMS. Dans le cadre d'un abonnement aux notifications, vous choisissez comment et où envoyer les notifications. Vous spécifiez le type de source dont vous voulez être informé. Actuellement, AWS DMS prend en charge les types de source d'instance de réplication et de tâche de réplication. De plus, selon le type de source que vous sélectionnez, vous choisissez les catégories d'évènements et vous identifiez la source pour laquelle vous souhaitez recevoir des notifications d'événement.

Utilisation de AWS Management Console

Important

Pour vous abonner aux notifications d'événement AWS DMS avec Amazon SNS à l'aide de la console

Connectez-vous à la AWS Management Console et ouvrez la console AWS DMS à l'adresse https://console.aws.amazon.com/dms/v2/.

Si vous êtes connecté en tant qu'utilisateur IAM, vous devez détenir les autorisations appropriées pour accéder à AWS DMS.
Dans le panneau de navigation, choisissez Abonnements aux évènements.
Sur la page Abonnements aux événements, choisissez Créer un abonnement aux événements.
Sur la page Créer un abonnement aux événements, procédez comme suit :
1. Sous Détails, pour Nom, entrez un nom pour l'abonnement aux notifications d'événement.
2. Choisissez Activé pour activer l'abonnement. Si vous souhaitez créer l'abonnement sans envoyer encore de notifications, ne choisissez pas Activé.
3. Sous Cible, choisissez Rubriques existantes, Créer une rubrique d'e-mail ou Créer une rubrique SMS pour envoyer des notifications. Assurez-vous de disposer d'une rubrique Amazon SNS où envoyer les avis. Si besoin est, créez-en une. Si vous créez une rubrique, vous pouvez entrer une adresse e-mail à laquelle les notifications seront envoyées.
4. Sous Origine de l'événement, pour Type de source, choisissez un type de source. Les seules options sont replication-instance et replication-task.
5. 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.
6. Sélectionnez Créer un abonnement aux événements.

La console AWS DMS indique que l'abonnement est en cours de création.

Note

Vous pouvez également créer des abonnements aux notifications d'événement Amazon SNS à l'aide de l'API et de la CLI AWS DMS. Pour plus d'informations, consultez CreateEventSubscription dans Référence d'API AWS DMS et create-event-subscription dans la documentation Référence de la CLI AWS DMS.

Validation de la stratégie d'accès de votre rubrique SNS

Votre stratégie d'accès SNS nécessite des autorisations permettant à AWS DMS de publier des événements dans votre rubrique SNS. Vous pouvez valider et mettre à jour votre stratégie d'accès comme décrit dans les procédures suivantes.

Pour valider votre stratégie d'accès

Ouvrez la console Amazon SNS.
Dans le volet de navigation, choisissez Rubriques et sélectionnez la rubrique pour laquelle vous souhaitez recevoir des notifications DMS.
Sélectionnez l'onglet Stratégie d'accès.

Vous pouvez mettre à jour votre stratégie si votre stratégie d'accès SNS n'autorise pas AWS DMS à publier des événements dans votre rubrique SNS.

Pour mettre à jour votre stratégie d'accès

Dans la section Détails de la page de votre rubrique, choisissez Modifier.

Développez la section Stratégie d'accès et attachez la stratégie suivante dans l'éditeur JSON.


{
      "Sid": "dms-allow-publish",
      "Effect": "Allow",
      "Principal": {
        "Service": "dms.amazonaws.com"
      },
      "Action": "sns:Publish",
      "Resource": "your-SNS-topic-ARN"
    }

Nous vous recommandons de restreindre davantage l'accès à votre rubrique SNS en spécifiant la condition aws:SourceArn, à savoir l'ARN de l'élément EventSubscription DMS qui publie les événements dans cette rubrique.


...
"Resource": "your-SNS-topic-ARN"
"Condition": {
    "StringEquals": {
       "aws:SourceArn": "arn:partition:dms:your-AWS-region:your-AWS-account-ID:es:your-dms-es-arn or *"
 }

Choisissez Enregistrer les modifications.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Utilisation d'événements EventBridge

Validation des données