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.

# GetMigrations
<a name="API_GetMigrations"></a>

Obtiene una lista de las migraciones entre Amazon Lex V1 y Amazon Lex V2.

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

```
GET /migrations?maxResults=maxResults&migrationStatusEquals=migrationStatusEquals&nextToken=nextToken&sortByAttribute=sortByAttribute&sortByOrder=sortByOrder&v1BotNameContains=v1BotNameContains HTTP/1.1
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
El número máximo de migraciones que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
Filtra la lista para que muestre solo las migraciones con el estado especificado.  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de migraciones. Si la respuesta a esta operación está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de migraciones, especifique el token de paginación en la solicitud.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
El campo de referencia para ordenar la lista de migraciones. Puede ordenar la lista por nombre de bot de Amazon Lex V1 o por la fecha y hora en que se inició la migración.  
Valores válidos: `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
El orden en el que se ordena la lista.  
Valores válidos: `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
Filtra la lista para que muestre solo los bots cuyo nombre contiene la cadena especificada. La cadena debe coincidir con cualquier parte del nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

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

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetMigrations_ResponseSyntax"></a>

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

{
   "migrationSummaries": [ 
      { 
         "migrationId": "string",
         "migrationStatus": "string",
         "migrationStrategy": "string",
         "migrationTimestamp": number,
         "v1BotLocale": "string",
         "v1BotName": "string",
         "v1BotVersion": "string",
         "v2BotId": "string",
         "v2BotRole": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_GetMigrations_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.

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Una matriz de resúmenes para migraciones de Amazon Lex V1 a Amazon Lex V2. Para ver los detalles de la migración, consulte `migrationId` en el resumen de una llamada a la operación [GetMigration](API_GetMigration.md).  
Tipo: matriz de objetos [MigrationSummary](API_MigrationSummary.md)

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
Si la respuesta está truncada, incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de migraciones.  
Tipo: cadena

## Errores
<a name="API_GetMigrations_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

## Véase también
<a name="API_GetMigrations_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/GetMigrations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations)