Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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.

# GetMigration
<a name="API_GetMigration"></a>

Fournit des informations sur une migration en cours ou complète d'un bot Amazon Lex V1 vers un bot Amazon Lex V2. Utilisez cette opération pour afficher les alertes de migration et les avertissements liés à la migration.

## Syntaxe de la demande
<a name="API_GetMigration_RequestSyntax"></a>

```
GET /migrations/migrationId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetMigration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
Identifiant unique de la migration à consulter. Le `migrationID` est renvoyé par l'[StartMigration](API_StartMigration.md)opération.  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetMigration_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetMigration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "alerts": [ 
      { 
         "details": [ "string" ],
         "message": "string",
         "referenceURLs": [ "string" ],
         "type": "string"
      }
   ],
   "migrationId": "string",
   "migrationStatus": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

## Eléments de réponse
<a name="API_GetMigration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Liste d'alertes et d'avertissements signalant des problèmes liés à la migration du bot Amazon Lex V1 vers Amazon Lex V2. Vous recevez un avertissement lorsqu'une fonctionnalité Amazon Lex V1 est implémentée différemment dans Amazon Lex V2.  
Pour plus d'informations, consultez la section [Migration d'un bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) dans le *guide du développeur Amazon Lex V2*.  
Type : tableau d’objets [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
Identifiant unique de la migration. Il s'agit du même identifiant que celui utilisé lors de l'appel de l'`GetMigration`opération.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indique le statut de la migration. Lorsque le statut est `COMPLETE` le suivant, la migration est terminée et le bot est disponible dans Amazon Lex V2. Certaines alertes et avertissements doivent peut-être être résolus pour terminer la migration.  
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
+  `CREATE_NEW`- Crée un nouveau bot Amazon Lex V2 et migre le bot Amazon Lex V1 vers le nouveau bot.
+  `UPDATE_EXISTING`- Remplace les métadonnées du bot Amazon Lex V2 existantes et les paramètres régionaux en cours de migration. Cela ne change aucune autre localisation dans le bot Amazon Lex V2. Si les paramètres régionaux n'existent pas, un nouveau paramètre régional est créé dans le bot Amazon Lex V2.
Type : Chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
Date et heure de début de la migration.  
Type : Timestamp

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
Les paramètres régionaux du bot Amazon Lex V1 ont été migrés vers Amazon Lex V2.  
Type : Chaîne  
Valeurs valides : `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [v1BotName](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotName"></a>
Nom du bot Amazon Lex V1 migré vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
La version du bot Amazon Lex V1 a migré vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
Identifiant unique du bot Amazon Lex V2 vers lequel l'Amazon Lex V1 est migré.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
Rôle IAM utilisé par Amazon Lex pour exécuter le bot Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Erreurs
<a name="API_GetMigration_Errors"></a>

 ** BadRequestException **   
La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.  
Code d’état HTTP : 400

 ** InternalFailureException **   
Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.  
Code d’état HTTP : 500

 ** LimitExceededException **   
La demande a dépassé une limite. Réessayez votre demande.  
Code d’état HTTP : 429

 ** NotFoundException **   
La ressource spécifiée dans la demande est introuvable. Vérifiez la ressource et réessayez.  
Code d’état HTTP :404

## Voir aussi
<a name="API_GetMigration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration)