Utilisation des événements et des notifications Amazon SNS dans AWS Database Migration Service - AWS Service de Migration de Base de Données

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 é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 :

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

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

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

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

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

    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.

    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

    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.

    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

    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.

    Pour vous abonner aux notifications d'événement AWS DMS avec Amazon SNS à l'aide de la console
    1. 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.

    2. Dans le panneau de navigation, choisissez Abonnements aux évènements.

    3. Sur la page Abonnements aux événements, choisissez Créer un abonnement aux événements.

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

        Console Créer un abonnement aux é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
    1. Ouvrez la console Amazon SNS.

    2. Dans le volet de navigation, choisissez Rubriques et sélectionnez la rubrique pour laquelle vous souhaitez recevoir des notifications DMS.

    3. 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
    1. Dans la section Détails de la page de votre rubrique, choisissez Modifier.

    2. 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 *" }
    3. Choisissez Enregistrer les modifications.