Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
Se utilizzi Amazon Lex V1, ti consigliamo di aggiornare i bot ad Amazon Lex V2. Non stiamo più aggiungendo nuove funzionalità alla V1 e consigliamo vivamente di utilizzare la V2 per tutti i nuovi bot.
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 uno degli AWS SDK specifici della lingua, consulta quanto segue: