Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Inizia la migrazione di un bot da Amazon Lex V1 ad Amazon Lex V2. Esegui la migrazione del bot quando desideri sfruttare le nuove funzionalità di Amazon Lex V2.

Per ulteriori informazioni, consulta [Migrazione di un bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) nella *guida per sviluppatori di Amazon Lex*.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_StartMigration_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartMigration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
+  `CREATE_NEW`- Crea un nuovo bot Amazon Lex V2 e migra il bot Amazon Lex V1 al nuovo bot.
+  `UPDATE_EXISTING`- Sovrascrive i metadati del bot di Amazon Lex V2 esistenti e le impostazioni locali da migrare. Non modifica le altre impostazioni locali nel bot Amazon Lex V2. Se la localizzazione non esiste, viene creata una nuova locale nel bot Amazon Lex V2.
Tipo: String  
Valori validi: `CREATE_NEW | UPDATE_EXISTING`   
Obbligatorio: sì

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
La versione del bot per la migrazione ad Amazon Lex V2. Puoi migrare la `$LATEST` versione così come qualsiasi versione numerata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
Il nome del bot Amazon Lex V2 su cui stai migrando il bot Amazon Lex V1.   
+ Se il bot Amazon Lex V2 non esiste, devi utilizzare la strategia di `CREATE_NEW` migrazione.
+ Se il bot Amazon Lex V2 esiste, è necessario utilizzare la strategia di `UPDATE_EXISTING` migrazione per modificare i contenuti del bot Amazon Lex V2.
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([0-9a-zA-Z][_-]?)+$`   
Obbligatorio: sì

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obbligatorio: sì

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_StartMigration_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 202.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
L'identificatore univoco assegnato da Amazon Lex alla migrazione.  
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
Tipo: String  
Valori validi: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
La data e l'ora di inizio della migrazione.  
Tipo: Timestamp

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
Le impostazioni locali utilizzate per il bot Amazon Lex V1.   
Tipo: String  
Valori validi: `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>
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
La versione del bot per la migrazione ad Amazon Lex V2.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
L'identificatore univoco per il bot Amazon Lex V2.   
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Errori
<a name="API_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Il tuo utente o ruolo IAM non dispone dell'autorizzazione per chiamare l'Amazon Lex V2 APIs necessario per migrare il bot.  
Codice di stato HTTP: 403

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_StartMigration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration)