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.

# StartMigration
<a name="API_StartMigration"></a>

Lance la migration d'un bot d'Amazon Lex V1 vers Amazon Lex V2. Migrez votre bot lorsque vous souhaitez profiter des nouvelles fonctionnalités d'Amazon Lex V2.

Pour plus d'informations, consultez la section [Migration d'un bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) dans le *guide du développeur Amazon Lex*.

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

```
POST /migrations HTTP/1.1
Content-type: application/json

{
   "migrationStrategy": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotName": "string",
   "v2BotRole": "string"
}
```

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

La demande n’utilise pas de paramètres URI.

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

Cette demande accepte les données suivantes au format JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-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`   
Obligatoire : oui

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
Nom du bot Amazon Lex V1 que vous êtes en train de migrer vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
Version du bot à migrer vers Amazon Lex V2. Vous pouvez migrer la `$LATEST` version ainsi que toute version numérotée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
Nom du bot Amazon Lex V2 vers lequel vous migrez le bot Amazon Lex V1.   
+ Si le bot Amazon Lex V2 n'existe pas, vous devez utiliser la stratégie de `CREATE_NEW` migration.
+ Si le bot Amazon Lex V2 existe, vous devez utiliser la stratégie de `UPDATE_EXISTING` migration pour modifier le contenu du bot Amazon Lex V2.
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([0-9a-zA-Z][_-]?)+$`   
Obligatoire : oui

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-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/.+$`   
Obligatoire : oui

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

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

{
   "migrationId": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

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

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

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

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
Identifiant unique attribué par Amazon Lex à la migration.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
Type : Chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING` 

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

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
Les paramètres régionaux utilisés pour le bot Amazon Lex V1.   
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_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotName"></a>
Nom du bot Amazon Lex V1 que vous êtes en train de migrer 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_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
Version du bot à migrer 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_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
Identifiant unique du bot Amazon Lex V2.   
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-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_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Votre utilisateur ou rôle IAM n'est pas autorisé à appeler l'Amazon Lex V2 APIs requis pour migrer votre bot.  
Code d’état HTTP : 403

 ** 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_StartMigration_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/StartMigration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration)