StartImport - Amazon Lex versione 1

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'StartImportoperazione 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ì

tags

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'GetImportoperazione.

▬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

tags

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: