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à.
StartImport
Avvia un'attività per importare una risorsa in Amazon Lex.
Sintassi della richiesta
POST /imports/ HTTP/1.1
Content-type: application/json
{
"mergeStrategy": "string
",
"payload": blob
,
"resourceType": "string
",
"tags": [
{
"key": "string
",
"value": "string
"
}
]
}
Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- mergeStrategy
-
Speciifica l'azione che l'
StartImport
operazione deve intraprendere quando esiste una risorsa con lo stesso nome.-
FAIL_ON_CONFLICT - L'operazione di importazione viene interrotta al primo conflitto tra una risorsa nel file di importazione e una risorsa esistente. Il nome della risorsa che causa il conflitto si trova nel
failureReason
campo della risposta all'operazione.GetImport
OVERWRITE_LATEST - L'operazione di importazione procede anche in caso di conflitto con una risorsa esistente. La versione $LASTEST della risorsa esistente viene sovrascritta con i dati del file di importazione.
Tipo: stringa
Valori validi:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
Campo obbligatorio: sì
-
- payload
-
Un archivio zip in formato binario. L'archivio deve contenere un file, un file JSON contenente la risorsa da importare. La risorsa deve corrispondere al tipo specificato nel
resourceType
campo.Tipo: oggetto dati binari con codifica Base64
Campo obbligatorio: sì
- resourceType
-
Speciifica il tipo di risorsa da esportare. Ogni risorsa esporta anche tutte le risorse da cui dipende.
-
Un bot esporta intenti dipendenti.
-
Un intento esporta i tipi di slot dipendenti.
Tipo: stringa
Valori validi:
BOT | INTENT | SLOT_TYPE
Campo obbligatorio: sì
-
-
Un elenco di tag da aggiungere al bot importato. Puoi aggiungere tag solo quando importi un bot, non puoi aggiungere tag a un intento o a un tipo di slot.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 201
Content-type: application/json
{
"createdDate": number,
"importId": "string",
"importStatus": "string",
"mergeStrategy": "string",
"name": "string",
"resourceType": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- createdDate
-
Un timestamp per la data e l'ora in cui è stato richiesto il processo di importazione.
Tipo: Timestamp
- importId
-
L'identificatore per il processo di importazione specifico.
Tipo: stringa
- importStatus
-
Lo stato del processo di importazione. Se lo stato è
FAILED
, è possibile ottenere il motivo dell'errore utilizzando l'GetImport
operazione.Tipo: stringa
Valori validi:
IN_PROGRESS | COMPLETE | FAILED
- mergeStrategy
-
L'azione da intraprendere in caso di conflitto di fusione.
Tipo: stringa
Valori validi:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
- name
-
Il nome assegnato al processo di importazione.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello:
[a-zA-Z_]+
- resourceType
-
Il tipo di risorsa da importare.
Tipo: stringa
Valori validi:
BOT | INTENT | SLOT_TYPE
-
Un elenco di tag aggiunti al bot importato.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Errori
- BadRequestException
-
La richiesta non è ben formata. 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
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: