Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola de Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la [guía Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Proporciona información acerca de una migración en curso o finalizada de un bot de Amazon Lex V1 a un bot de Amazon Lex V2. Utilice esta operación para ver las alertas y los avisos relacionados con la migración.

## Sintaxis de la solicitud
<a name="API_GetMigration_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetMigration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
El identificador único de la migración que se consulta. `migrationID` lo devuelve la operación [StartMigration](API_StartMigration.md).  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetMigration_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetMigration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Una lista de alertas y advertencias que indican problemas con la migración de un bot de Amazon Lex V1 a Amazon Lex V2. Recibirá una advertencia cuando una característica de Amazon Lex V1 se implemente de forma distinta en Amazon Lex V2.  
Para obtener más información, consulte [Migración de un bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) en la *Guía para desarrolladores de Amazon Lex V2*.  
Tipo: matriz de objetos [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
El identificador único de la migración. Es el mismo identificador que se utiliza al llamar a la operación `GetMigration`.  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indica el estado de la migración. Cuando el estado es `COMPLETE`, la migración ha finalizado y el bot está disponible en Amazon Lex V2. Es posible que haya alertas y advertencias que deban resolverse antes de completar la migración.  
Tipo: cadena  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
La estrategia empleada para llevar a cabo la migración.  
+  `CREATE_NEW`: crea un nuevo bot de Amazon Lex V2 y migra el bot de Amazon Lex V1 al nuevo bot.
+  `UPDATE_EXISTING`: sobrescribe los metadatos de un bot de Amazon Lex V2 y la configuración regional que se van a migrar. No cambia ninguna otra configuración regional del bot de Amazon Lex V2. Si la configuración regional no existe, se crea una nueva configuración regional en el bot de Amazon Lex V2.
Tipo: cadena  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
La fecha y hora en que comenzó la migración.  
Tipo: marca temporal

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
La configuración regional del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Valores válidos: `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>
El nombre del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
La versión del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
El identificador único del bot de Amazon Lex V2 al que se migra desde Amazon Lex V1.  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
El rol de IAM que Amazon Lex utiliza para ejecutar el bot de Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetMigration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration)