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 Amazon Lex V1 o alle risorse Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
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à.
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 nella guida per sviluppatori di Amazon Lex.
Sintassi della richiesta
POST /migrations HTTP/1.1
Content-type: application/json
{
"migrationStrategy": "string",
"v1BotName": "string",
"v1BotVersion": "string",
"v2BotName": "string",
"v2BotRole": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- migrationStrategy
-
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 locale non esiste, viene creata una nuova locale nel bot Amazon Lex V2.
Tipo: stringa
Valori validi:
CREATE_NEW | UPDATE_EXISTINGCampo obbligatorio: sì
-
- v1BotName
-
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.
Tipo: stringa
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.
Modello:
^([A-Za-z]_?)+$Campo obbligatorio: sì
- v1BotVersion
-
La versione del bot per la migrazione ad Amazon Lex V2. Puoi migrare la
$LATESTversione così come qualsiasi versione numerata.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
\$LATEST|[0-9]+Campo obbligatorio: sì
- v2BotName
-
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_NEWmigrazione. -
Se il bot Amazon Lex V2 esiste, è necessario utilizzare la strategia di
UPDATE_EXISTINGmigrazione per modificare i contenuti del bot Amazon Lex V2.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello:
^([0-9a-zA-Z][_-]?)+$Campo obbligatorio: sì
-
- v2BotRole
-
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.
Modello:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$Campo obbligatorio: sì
Sintassi della risposta
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
Se l'operazione riesce, il servizio restituisce una risposta HTTP 202.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- migrationId
-
L'identificatore univoco assegnato da Amazon Lex alla migrazione.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 10.
Modello:
^[0-9a-zA-Z]+$ - migrationStrategy
-
La strategia utilizzata per condurre la migrazione.
Tipo: stringa
Valori validi:
CREATE_NEW | UPDATE_EXISTING - migrationTimestamp
-
La data e l'ora di inizio della migrazione.
Tipo: Timestamp
- v1BotLocale
-
Le impostazioni locali utilizzate per il bot Amazon Lex V1.
Tipo: stringa
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
-
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.
Tipo: stringa
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.
Modello:
^([A-Za-z]_?)+$ - v1BotVersion
-
La versione del bot per la migrazione ad Amazon Lex V2.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
\$LATEST|[0-9]+ - v2BotId
-
L'identificatore univoco per il bot Amazon Lex V2.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 10.
Modello:
^[0-9a-zA-Z]+$ - v2BotRole
-
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.
Modello:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
Errori
- 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
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
