

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.

# AWS Database Migration Service
<a name="automation-ref-dms"></a>

AWS Systems Manager L'automatisation fournit des runbooks prédéfinis pour AWS Database Migration Service. Pour plus d’informations sur les runbooks, consultez [Travailler avec des runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Pour plus d'informations sur l'affichage du contenu du runbook, consultez[Afficher le contenu du runbook](automation-runbook-reference.md#view-automation-json). 

**Topics**
+ [`AWSSupport-TroubleshootDMSTableErrors`](awssupport-troubleshoot-dms-table-errors.md)
+ [`AWSSupport-TroubleshootDMSEndpointConnection`](automation-awssupport-troubleshootdmsendpointconnection.md)

# `AWSSupport-TroubleshootDMSTableErrors`
<a name="awssupport-troubleshoot-dms-table-errors"></a>

 **Description** 

 Le manuel AWS Systems Manager **AWSSuport-TroubleshootDMSTableErrors**d'automatisation vous aide à automatiser le processus de résolution des problèmes liés à la tâche de migration `Table errors` de base de données ou à la réplication sans serveur à partir de. AWS Database Migration Service Ces erreurs se produisent lorsque les tables ne parviennent pas à migrer du point de terminaison source (base de données source) vers le point de terminaison cible (base de données cible) par le biais de la tâche de migration de base de données ou de la réplication sans serveur créée en AWS DMS service. Ce manuel analyse les messages d'erreur de signature provenant des CloudWatch journaux, en se concentrant spécifiquement sur les journaux des tâches pour les tâches de migration de base de données traditionnelles et sur les journaux sans serveur pour la réplication sans serveur. Il fournit également des suggestions ciblées et des étapes de correction pour les messages d'erreur courants rencontrés `Table error` lors des AWS DMS migrations. 

 **Fonctionnement** 

 Le runbook exécute les étapes suivantes : 
+ Récupère des informations sur l' AWS DMS ARN fourni, qui peut être une tâche de migration de base de données ou une réplication sans serveur.
+ Vérifie si la AWS DMS ressource fournie a été démarrée au moins une fois en vérifiant la `FreshStartDate` valeur dans la réponse de l' DescribeReplicationTasks API (pour la tâche de migration de base de données) et de DescribeReplications l'API (pour la réplication sans serveur). Si la ressource n'a pas démarré, l'automatisation génère une erreur.
+ Si la ressource a démarré, l'automatisation vérifie la présence des tables dans les `TableError` états à l'aide `TableStatistics` des informations. Si aucune erreur n'est détectée, l'automatisation met fin au flux de travail après avoir affiché un message confirmant qu'aucune erreur de table n'a été détectée dans la tâche de migration de base de données ou de réplication sans serveur spécifiée.
+ Si des tables avec un `TableError` état sont trouvées, l'automatisation vérifie si la CloudWatch journalisation est activée pour la AWS DMS ressource spécifiée. Si la journalisation n'est pas activée, l'automatisation met fin au flux de travail après avoir affiché un message indiquant que la journalisation n'est pas activée. 

  **Remarque :** la CloudWatch journalisation devrait être activée, car l'automatisation s'appuie sur ces journaux pour analyser et identifier les problèmes liés aux tables en `TableError` état.
+ Si la journalisation est activée, l'automatisation analyse CloudWatch les journaux et génère un rapport pour chaque table en `TableError` état. Le rapport inclut des suggestions de messages d'erreur courants et fournit des journaux d'erreurs pertinents pour aider à identifier et à résoudre les problèmes empêchant la migration réussie des tables du point de terminaison AWS DMS source vers le point de terminaison AWS DMS cible.

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootDMSTableErrors) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

/

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ DMSArn

  Type : Chaîne

  Description : ARN (obligatoire) de la tâche de migration de base de données ou de réplication sans serveur 

  Modèle autorisé : `^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\d{12}:(task|replication-config):[a-zA-Z0-9-]+$`
+ StartTimeRange

  Type : Chaîne

  Description : (Facultatif) Ce paramètre définit le début de la plage horaire pour l'analyse des CloudWatch journaux d'une tâche de migration de base de données ou d'une réplication sans serveur donnée. Lorsqu'ils sont fournis, seuls les journaux générés à partir de ce moment précis seront collectés et analysés. Veuillez noter qu'il est possible que le flux de travail expire si l'intervalle de temps entre `startDate` et `endDate` est trop long. La valeur doit être fournie au format de date et d'heure ISO 6081.

  Modèle autorisé : `^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$` 
+ EndTimeRange

  Type : Chaîne

  Description : (Facultatif) Ce paramètre définit la fin de la plage de temps pour l'analyse des CloudWatch journaux de la tâche de migration de base de données ou de réplication sans serveur donnée. Lorsqu'ils sont fournis, seuls les journaux générés jusqu'à cette heure précise seront collectés et analysés. Veuillez noter qu'il est possible que le flux de travail expire si l'intervalle de temps entre `startDate` et `endDate` est trop long. La valeur doit être fournie au format de date et d'heure ISO 6081.

  Modèle autorisé : `^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$` 

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `dms:DescribeReplicationTasks`
+ `dms:DescribeReplications`
+ `dms:DescribeEndpoints`
+ `dms:DescribeReplicationConfigs`
+ `dms:DescribeTableStatistics`
+ `dms:DescribeReplicationTableStatistics`
+ `logs:FilterLogEvents`

 **Exemple de politique IAM pour le rôle Automation Assume** 

------
#### [ JSON ]

****  

```
            {
                "Version":"2012-10-17",		 	 	 
                "Statement": [
                    {
                        "Sid": "VisualEditor0",
                        "Effect": "Allow",
                        "Action": [
                            "dms:DescribeReplicationConfigs",
                            "dms:DescribeEndpoints",
                            "dms:DescribeReplicationTableStatistics",
                            "dms:DescribeTableStatistics",
                            "logs:FilterLogEvents",
                            "dms:DescribeReplicationTasks",
                            "dms:DescribeReplications"
                        ],
                        "Resource": "*"
                    }
                ]
            }
```

------

 **Instructions** 

Pour configurer l'automatisation, procédez comme suit :

1. Accédez [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSTableErrors/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSTableErrors/description)à Systems Manager sous Documents.

1. Sélectionnez Execute automation (Exécuter l'automatisation).

1. Pour les paramètres d'entrée, entrez ce qui suit :
   + **AutomationAssumeRole (Facultatif) :**

     Amazon Resource Name (ARN) du rôle AWS Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
   + **DMSArn**

     ARN de la tâche de migration de base de données ou de réplication sans serveur contenant des erreurs de table. 
   + **StartTimeRange**

     (Facultatif) Format de date et d'heure ISO 6081 définissant le début de la plage horaire pour l'analyse des CloudWatch journaux d'une tâche de migration de base de données ou d'une réplication sans serveur donnée.
   + **EndTimeRange**

     (Facultatif) Format de date et d'heure ISO 6081 définissant la fin de la plage horaire pour l'analyse des CloudWatch journaux d'une tâche de migration de base de données ou d'une réplication sans serveur donnée.

1. Sélectionnez **le bouton Exécuter** en bas de la page.

1. L'automatisation démarre.

1. Le document exécute les étapes suivantes :
   + **valider DMSInput TypeAndGatherDetails**

     Valide l'entrée AWS DMS ARN donnée et rassemble les détails de base de la tâche de migration de base de données ou de réplication sans serveur qui sont nécessaires dans les étapes suivantes.
   + **branchOnTableErreurs**

     Branche le flux de travail en fonction du nombre d'erreurs de table détectées à l'étape ci-dessus. Si le nombre est supérieur à 0, passez à l'`branchOnCWLoggingStatus`étape -. Sinon, passez à l'`outputNoTableErrors`étape -.
   + **outputNoTableErreurs**

     Afficher un message indiquant que les erreurs de table sont introuvables dans la tâche de migration de base de données ou de réplication sans serveur donnée.
   + **État de BranchOn CWLogging**

     Branche le flux de travail en fonction de l'état de CloudWatch journalisation trouvé à l'étape ci-dessus. Si cette option est activée, passez à l'`gatherTableDetails`étape -. Sinon, passez à l'`outputNoCWLoggingEnabled`étape -.
   + **Sortie non activée CWLogging**

     Affiche un message indiquant que la CloudWatch journalisation n'est pas activée dans la tâche de migration de base de données ou de réplication sans serveur donnée.
   + **gatherTableDetails**

     Recueille les `FullLoadEndTime` horodatages des tables défaillantes et calcule les valeurs temporelles pour analyser les journaux. CloudWatch 
   + **analyzeCloudWatchJournaux**

     Analyse les journaux trouvés dans le groupe de CloudWatch journaux en fonction des messages d'erreur de signature et renvoie le rapport à l'utilisateur.

1. Une fois l'exécution terminée, consultez la section Sorties pour connaître les résultats détaillés de l'exécution.
   + **Sortie d'aucune erreur de table détectée**

     Si aucune erreur de table n'est détectée dans la tâche de migration de base de données ou de réplication sans serveur fournie, l'automatisation affiche le même résultat. 
   + **Sortie indiquant « Aucune CloudWatch connexion activée »**

     Si la CloudWatch journalisation n'est pas activée dans la tâche de migration de base de données ou de réplication sans serveur fournie, l'automatisation affiche le même résultat et indique les étapes pour activer la journalisation. 
   + **Rapport d'analyse du journal**

     Produit un rapport qui identifie les tables en `Table error` état à partir de la tâche de migration de base de données ou de la réplication sans serveur fournie, en différenciant les types d'erreur, en répertoriant les messages d'erreur rencontrés et en fournissant des étapes de correction ciblées et des suggestions pour chaque table identifiée.

 **Références** 

Systems Manager Automation
+ [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSTableErrors/description)
+ [Exécuter une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuration d'une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Page d'accueil de Support Automation Workflows](https://aws.amazon.com/premiumsupport/technology/saw/)

# `AWSSupport-TroubleshootDMSEndpointConnection`
<a name="automation-awssupport-troubleshootdmsendpointconnection"></a>

 **Description** 

Le **AWSSupport-TroubleshootDMSEndpointConnection**runbook permet de diagnostiquer et de résoudre les problèmes de connectivité entre les instances de AWS Database Migration Service réplication et AWS DMS les points de terminaison. L'automatisation utilise les contrôles [Reachability Analyzer](https://docs.aws.amazon.com/vpc/latest/reachability/what-is-reachability-analyzer.html) pour tester la connectivité réseau et analyse la configuration du réseau afin d'identifier les problèmes de connectivité potentiels susceptibles d'empêcher la réussite des migrations. AWS DMS 

**Important**  
Vous devez avoir testé la connectivité entre l'instance de AWS DMS réplication et le point de terminaison à l'aide de la AWS DMS console ou de l'API avant d'exécuter ce runbook. Si vous n'avez pas testé la connexion, veuillez d'abord le faire, sinon vous devrez peut-être réexécuter ce runbook. L'instance de AWS DMS réplication et le point de terminaison doivent être disponibles pour des tests de connectivité précis.

**Important**  
Ce runbook crée et invoque des AWS Lambda fonctions, qui entraîneront des frais Lambda. Chaque analyse de Reachability Analyzer entraîne également des frais. [Pour plus de détails sur les tarifs, consultez la page de [tarification d'Amazon VPC](https://aws.amazon.com/vpc/pricing/) sous l'onglet Network Analysis et AWS Lambda la tarification.](https://aws.amazon.com/lambda/pricing/)

 **Fonctionnement** 

Le runbook effectue une analyse systématique de la AWS DMS connectivité selon les phases suivantes :

**Phase 1 : Validation des ressources et conditions préalables**
+ **Validation du point** de AWS DMS terminaison : vérifie que le point de terminaison existe, récupère sa configuration (nom du serveur, port, type de moteur) et confirme que le moteur de base de données est pris en charge pour le dépannage.
+ **État du test de connexion : récupère l'état** actuel du test de connexion entre l'instance de réplication et le point de terminaison à l'aide de l' AWS DMS `DescribeConnections`API, y compris les messages d'échec des tentatives de test précédentes.
+ **Analyse de l'instance de réplication** : collecte les détails de configuration réseau, notamment l'identifiant Amazon VPC, le IDs sous-réseau, le IDs groupe de sécurité, et identifie l'interface réseau élastique (ENI) associée à l'instance de réplication.

**Phase 2 : résolution du DNS et découverte du chemin réseau**
+ **Résolution DNS basée sur Amazon VPC** : crée une fonction Lambda temporaire dans le même Amazon VPC que l'instance de réplication pour résoudre le nom d'hôte du point de terminaison en son adresse IP depuis le contexte Amazon VPC, garantissant ainsi une résolution DNS privée précise.
+ **Identification de la cible** : détermine la cible appropriée pour Reachability Analyzer selon que le point de terminaison se trouve dans le même Amazon VPC (utilise ENI) ou externe (utilise une adresse IP résolue).
+ IPv6 Contrôle de **compatibilité : vérifie** que les adresses résolues le sont IPv4, car Reachability Analyzer ne prend pas en charge les adresses. IPv6 

**Phase 3 : Analyse complète du chemin du réseau**
+ Exécution de l'**analyseur de reachabilité** : crée un chemin d'information réseau entre l'instance de réplication ENI et la cible (ENI du point de terminaison ou adresse IP) et exécute une analyse complète pour tester la connectivité TCP sur le port spécifié.
+ **Analyse du réseau multicouche** : examine le chemin réseau complet, y compris les tables de routage, les groupes de sécurité, le réseau, les passerelles Internet ACLs, les passerelles NAT, les connexions d'appairage Amazon VPC et les passerelles de transit afin d'identifier les obstacles à la connectivité.
+ **Génération d'explications détaillées** : en cas de défaillance de la connectivité, fournit des explications spécifiques pour chaque composant réseau bloquant le trafic, y compris les numéros de règles exacts, les blocs CIDR, les plages de ports et les restrictions de protocole.

**Phase 4 : Génération de rapports et nettoyage des ressources**
+ **Rapports complets** : génère un rapport détaillé contenant un résumé des tests de connexion, les résultats de l'analyse des chemins réseau et des explications spécifiques sur les défaillances avec des conseils de correction.
+ **Gestion des ressources** : nettoie automatiquement les ressources créées (fonction Lambda, rôles IAM, chemins d'informations réseau), sauf si PersistReachabilityAnalyzerResults le paramètre est défini pour conserver les résultats d'analyse à des fins d'investigation plus approfondie.
+ **Gestion des erreurs** : fournit des rapports d'erreur spécifiques pour divers scénarios de défaillance, notamment les moteurs de base de données non pris en charge, les ressources manquantes, les échecs de résolution DNS et les problèmes d'autorisation.

Le runbook permet de résoudre les problèmes de connectivité pour plusieurs moteurs de base de données, notamment Amazon Aurora, Amazon DocumentDB, Amazon DynamoDB, Amazon Neptune, Amazon Redshift, Amazon S3, Azure SQL Database, MySQL, Oracle, PostgreSQL DB2, SQL Server et bien d'autres.

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootDMSEndpointConnection) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

/

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `cloudformation:CreateStack`
+ `cloudformation:DeleteStack`
+ `cloudformation:DescribeStacks`
+ `cloudformation:DescribeStackEvents`
+ `dms:DescribeEndpoints`
+ `dms:DescribeReplicationInstances`
+ `dms:DescribeConnections`
+ `iam:GetRole`
+ `iam:PassRole`
+ `iam:SimulatePrincipalPolicy`
+ `lambda:CreateFunction`
+ `lambda:DeleteFunction`
+ `lambda:GetFunction`
+ `lambda:InvokeFunction`
+ `lambda:ListTags`
+ `lambda:TagResource`
+ `lambda:UntagResource`
+ `lambda:UpdateFunctionCode`

 **Autorisations IAM facultatives** 

Les autorisations suivantes ne sont requises que `AutomationAssumeRole` si vous ne fournissez pas de `LambdaRoleArn` paramètre et que vous souhaitez que l'automatisation crée le rôle d'exécution Lambda pour vous :
+ `iam:CreateRole`
+ `iam:DeleteRole`
+ `iam:AttachRolePolicy`
+ `iam:DetachRolePolicy`
+ `iam:TagRole`
+ `iam:UntagRole`

**Important**  
 Outre les actions mentionnées ci-dessus, [Amazon `AutomationAssumeRole`](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonVPCReachabilityAnalyzerFullAccessPolicy.html) doit être [associé à une politique gérée](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) afin VPCReachability AnalyzerFullAccessPolicy que les tests de [Reachability Analyzer soient effectués](https://docs.aws.amazon.com/vpc/latest/reachability/what-is-reachability-analyzer.html) avec succès. 

Exemple de politique : 

```
        {
            "Version": "2012-10-17"		 	 	 ,
            "Statement": [
                {
                    "Sid": "AllowDMSTroubleshootingActions",
                    "Effect": "Allow",
                    "Action": [
                        "dms:DescribeEndpoints",
                        "dms:DescribeReplicationInstances",
                        "dms:DescribeConnections",
                        "lambda:GetFunction",
                        "lambda:ListTags",
                        "lambda:CreateFunction",
                        "lambda:DeleteFunction",
                        "lambda:TagResource",
                        "lambda:UntagResource",
                        "lambda:UpdateFunctionCode",
                        "cloudformation:DescribeStacks",
                        "cloudformation:DescribeStackEvents",
                        "cloudformation:CreateStack",
                        "cloudformation:DeleteStack",
                        "iam:GetRole",
                        "iam:SimulatePrincipalPolicy",
                        "iam:CreateRole",
                        "iam:DeleteRole",
                        "iam:TagRole",
                        "iam:UntagRole"
                    ],
                    "Resource": "*"
                },
                {
                    "Sid": "AllowDMSLambdaInvocation",
                    "Effect": "Allow",
                    "Action": [
                        "lambda:InvokeFunction"
                    ],
                    "Resource": "arn:*:lambda:*:*:function:AWSSupport-TroubleshootDMSEndpointConnection-*"
                },
                {
                    "Sid": "AllowPassRoleToDMSLambda",
                    "Effect": "Allow",
                    "Action": [
                        "iam:PassRole"
                    ],
                    "Resource": "arn:*:iam::*:role/AWSSupport-TroubleshootDMSEndpointConnection-*",
                    "Condition": {
                        "StringLikeIfExists": {
                            "iam:PassedToService": "lambda.amazonaws.com"
                        }
                    }
                },
                {
                    "Sid": "AllowRolePolicyManagement",
                    "Effect": "Allow",
                    "Action": [
                        "iam:AttachRolePolicy",
                        "iam:DetachRolePolicy"
                    ],
                    "Resource": "*",
                    "Condition": {
                        "StringLikeIfExists": {
                            "iam:ResourceTag/AWSSupport-TroubleshootDMSEndpointConnection": "true"
                        }
                    }
                }
            ]
        }
```

 **Instructions** 

Pour configurer l'automatisation, procédez comme suit :

1. Accédez [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSEndpointConnection/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSEndpointConnection/description)à Systems Manager sous Documents.

1. Sélectionnez **Execute automation** (Exécuter l'automatisation).

1. Pour les paramètres d'entrée, entrez ce qui suit :
   + **AutomationAssumeRole (Facultatif) :**
     + Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à SSM Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, SSM Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
     + Type : `AWS::IAM::Role::Arn`
   + **DmsEndpointArn (Obligatoire)**
     + Description : (Obligatoire) Le nom de ressource Amazon (ARN) du AWS Database Migration Service point de terminaison.
     + Type : `String`
     + Modèle autorisé : `^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\\d{12}:endpoint:[A-Z0-9]{1,48}$`
   + **DmsReplicationInstanceArn (Obligatoire)**
     + Description : (Obligatoire) Le nom de ressource Amazon (ARN) de l'instance de AWS Database Migration Service réplication.
     + Type : `String`
     + Modèle autorisé : `^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\\d{12}:rep:[A-Z0-9]+$`
   + **PersistReachabilityAnalyzerResults (Facultatif)**
     + Description : (Facultatif) L'indicateur indiquant si les résultats de l'exécution de l'analyse Network Insights doivent être conservés ou non.
     + Type : `Boolean`
     + Valeurs autorisées : `[true, false]`
     +  Valeur par défaut : `false`
   + **LambdaRoleArn (Facultatif)**
     + Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Gestion des identités et des accès AWS (IAM) qui permet à la AWS Lambda fonction d'accéder aux AWS services et ressources requis. Si aucun rôle n'est spécifié, cette automatisation de Systems Manager créera un rôle IAM pour Lambda dans votre compte.
     + Type : `AWS::IAM::Role::Arn`
     +  Valeur par défaut : `""`
   + **Reconnaître (obligatoire)**
     + Description : (Obligatoire) Entrez `yes` pour confirmer que ce runbook créera une fonction Lambda dans votre compte et créera un rôle IAM si `LambdaRoleArn` ce n'est pas le cas.
     + Type : `String`
     + Modèle autorisé : `^[Yy][Ee][Ss]$`

1. Sélectionnez **Exécuter**.

1. L'automatisation démarre.

1. Le document exécute les étapes suivantes :
   + **DescribeEndpointAndCheckEngine:**

     Récupère la configuration du AWS DMS point de terminaison et valide si le type de moteur de base de données est pris en charge pour le dépannage. Extrait le nom du serveur, le port et le type de moteur de la configuration du point de terminaison.
   + **BranchOnEndpointAndCheckEngineErrors:**

     Branche l'automatisation en fonction des erreurs liées à la validation du point de terminaison. Si des erreurs sont détectées, l'automatisation génère un rapport d'erreur ; sinon, elle poursuit les tests de connectivité.
   + **GetTestConnectionStatus:**

     Récupère l'état de la connexion et le message d'erreur pour le AWS DMS point de terminaison à l'aide de l'`DescribeConnections`API. Cette étape vérifie si un test de connexion a été effectué et capture les éventuels messages d'échec.
   + **BranchOnTestConnectionStatusErrors:**

     Branche l'automatisation en fonction des erreurs d'état des tests de connexion. Si des erreurs sont détectées, l'automatisation génère un rapport d'erreur ; dans le cas contraire, elle procède à l'analyse des instances de réplication.
   + **DescribeReplicationInstance:**

     Récupère les détails de configuration réseau de l'instance de AWS DMS réplication, notamment l'identifiant Amazon VPC, le IDs sous-réseau, le IDs groupe de sécurité, et identifie l'Elastic Network Interface (ENI) associée.
   + **ValidateResourcePermissions:**

     Vérifie que le rôle d'exécution dispose des autorisations nécessaires pour nettoyer les ressources qui seront créées au cours du processus d'automatisation.
   + **Créez DNSResolver Lambda :**

     Crée une AWS CloudFormation pile contenant une fonction Lambda déployée dans le même Amazon VPC que l'instance de réplication. Cette fonction est utilisée pour convertir les noms DNS en adresses IP privées dans le contexte Amazon VPC.
   + **DescribeCloudFormationErrorFromStackEvents:**

     Si la création de la CloudFormation pile échoue, cette étape décrit les erreurs liées aux événements de la pile afin de fournir des informations détaillées sur les défaillances à des fins de résolution des problèmes.
   + **Obtenez DNSResolver LambdaName :**

     Récupère le nom de la fonction Lambda du résolveur DNS à partir des sorties de la CloudFormation pile pour l'utiliser dans les étapes suivantes.
   + **ResolveDmsEndpoint:**

     Invoque la fonction Lambda pour convertir le nom d'hôte AWS DMS du point de terminaison en adresse IP depuis Amazon VPC. Cela garantit une résolution DNS privée précise et valide la IPv4 compatibilité.
   + **BranchOnResolveDmsEndpointErrors:**

     Branche l'automatisation en fonction des erreurs de résolution DNS. Si le point de terminaison ne peut pas être résolu ou s'il est résolu à une IPv6 adresse, l'automatisation génère un rapport d'erreur.
   + **GetReachabilityAnalyzerTarget:**

     Identifie la cible appropriée pour Reachability Analyzer en fonction de la configuration Amazon VPC et de l'emplacement du point de terminaison. Détermine s'il faut utiliser une adresse ENI (pour les mêmes points de terminaison Amazon VPC) ou une adresse IP (pour les points de terminaison externes) comme cible.
   + **GenerateErrors:**

     Crée un rapport d'erreur complet lorsque des défaillances se produisent au cours des étapes précédentes. Cela inclut des informations sur les erreurs de validation des terminaux, les échecs des tests de connexion ou les problèmes de résolution du DNS, avec des conseils de correction spécifiques.
   + **GenerateReport:**

     Crée un rapport de dépannage complet contenant l'état de la connexion, les résultats de l'analyse du chemin réseau à l'aide de Reachability Analyzer, des explications détaillées sur les obstacles à la connectivité et des actions recommandées pour les résoudre.
   + **CheckStackExists:**

     Vérifie si la CloudFormation pile a été créée avec succès et doit être supprimée pendant le nettoyage. Cette étape garantit une gestion appropriée des ressources, quel que soit le succès ou l'échec de l'automatisation.
   + **Supprimer DNSResolver Lambda :**

     Supprime la CloudFormation pile contenant la fonction Lambda du résolveur DNS et les ressources associées (sauf si elle `PersistReachabilityAnalyzerResults` est définie sur`true`), garantissant ainsi qu'il ne reste aucune ressource résiduelle une fois l'automatisation terminée.

1. Une fois terminé, consultez la section **Sorties** pour obtenir les résultats détaillés de l'exécution :
   + **GetTestConnectionStatus.statut**

     État actuel du test de connexion entre l'instance de AWS DMS réplication et le point de terminaison (par exemple, succès, échec, test).
   + **DescribeCloudFormationErrorFromStackEvents.Évènements**

     Si la création de la CloudFormation pile échoue, ce résultat contient des événements d'erreur détaillés liés au processus de création de la pile pour aider à diagnostiquer les problèmes de déploiement de l'infrastructure.
   + **GenerateReport.rapport**

     Un rapport de dépannage complet contenant les résultats de l'analyse des connexions, les conclusions de Reachability Analyzer, l'analyse du chemin réseau, les obstacles de connectivité spécifiques identifiés et des recommandations de correction détaillées avec des liens vers la documentation pertinente. AWS 
   + **GenerateErrors.rapport**

     Si des erreurs se produisent pendant le processus d'automatisation, ce résultat fournit un rapport d'erreur détaillé incluant les raisons spécifiques de l'échec, les ressources affectées et des conseils pour résoudre les problèmes avant de réessayer l'automatisation.

 **Références** 

Systems Manager Automation
+ [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootDMSEndpointConnection/description)
+ [Exécuter une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuration d'une automatisation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Page d'accueil de Support Automation Workflows](https://aws.amazon.com/premiumsupport/technology/saw/)