StartMigration - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

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

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 dans le guide du développeur Amazon Lex.

Syntaxe de la demande

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

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

Paramètres de demande URI

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

Corps de la demande

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

migrationStrategy

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

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

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.

Modèle : \$LATEST|[0-9]+

Obligatoire : oui

v2BotName

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

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

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

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

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

La stratégie utilisée pour effectuer la migration.

Type : chaîne

Valeurs valides : CREATE_NEW | UPDATE_EXISTING

migrationTimestamp

Date et heure du début de la migration.

Type : Timestamp

v1BotLocale

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

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

Version du bot à migrer vers Amazon Lex V2.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : \$LATEST|[0-9]+

v2BotId

Identifiant unique du bot Amazon Lex V2.

Type : chaîne

Contraintes de longueur : longueur fixe de 10.

Modèle : ^[0-9a-zA-Z]+$

v2BotRole

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

AccessDeniedException

Votre utilisateur ou rôle IAM n'est pas autorisé à appeler les API Amazon Lex V2 requises 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

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :