StartImport - Amazon Lex V1
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie auch unter:

Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

 

Wenn Sie Amazon Lex V1 verwenden, empfehlen wir, Ihre Bots auf Amazon Lex V2 zu aktualisieren. Wir fügen V1 keine neuen Funktionen mehr hinzu und empfehlen dringend, V2 für alle neuen Bots zu verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

StartImport

Startet einen Auftrag zum Importieren einer Ressource in Amazon Lex.

Anforderungssyntax

POST /imports/ HTTP/1.1
Content-type: application/json

{
   "mergeStrategy": "string",
   "payload": blob,
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

mergeStrategy

Gibt die Aktion an, die der StartImport Vorgang ausführen soll, wenn eine Ressource mit demselben Namen vorhanden ist.

  • FAIL_ON_CONFLICT — Der Importvorgang wird beim ersten Konflikt zwischen einer Ressource in der Importdatei und einer vorhandenen Ressource gestoppt. Der Name der Ressource, die den Konflikt verursacht hat, steht im failureReason Feld der Antwort auf den Vorgang. GetImport

    OVERWRITE_LATEST — Der Importvorgang wird auch dann fortgesetzt, wenn ein Konflikt mit einer vorhandenen Ressource besteht. Die $LASTST-Version der vorhandenen Ressource wird mit den Daten aus der Importdatei überschrieben.

Typ: Zeichenfolge

Zulässige Werte: OVERWRITE_LATEST | FAIL_ON_CONFLICT

Erforderlich: Ja

payload

Ein ZIP-Archiv im Binärformat. Das Archiv sollte eine Datei enthalten, eine JSON-Datei, die die zu importierende Ressource enthält. Die Ressource sollte dem im resourceType Feld angegebenen Typ entsprechen.

Typ: Base64-kodiertes Binärdatenobjekt

Erforderlich: Ja

resourceType

Gibt den Typ der zu exportierenden Ressource an. Jede Ressource exportiert auch alle Ressourcen, von denen sie abhängig ist.

  • Ein Bot exportiert abhängige Absichten.

  • Ein Intent exportiert abhängige Slot-Typen.

Typ: Zeichenfolge

Zulässige Werte: BOT | INTENT | SLOT_TYPE

Erforderlich: Ja

tags

Eine Liste von Tags, die dem importierten Bot hinzugefügt werden sollen. Sie können Tags nur hinzufügen, wenn Sie einen Bot importieren. Sie können keine Tags zu einer Absicht oder einem Slot-Typ hinzufügen.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

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"
      }
   ]
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

createdDate

Ein Zeitstempel für das Datum und die Uhrzeit, zu der der Importjob angefordert wurde.

Typ: Zeitstempel

importId

Der Bezeichner für den spezifischen Importjob.

Typ: Zeichenfolge

importStatus

Der Status des Importauftrags. Wenn der Status lautetFAILED, können Sie den Grund für den Fehler mithilfe der GetImport Operation ermitteln.

Typ: Zeichenfolge

Zulässige Werte: IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

Die Aktion, die ergriffen werden soll, wenn ein Zusammenführungskonflikt vorliegt.

Typ: Zeichenfolge

Zulässige Werte: OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

Der Name, der dem Importauftrag gegeben wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 100 Zeichen.

Pattern: [a-zA-Z_]+

resourceType

Der Typ der zu importierenden Ressource.

Typ: Zeichenfolge

Zulässige Werte: BOT | INTENT | SLOT_TYPE

tags

Eine Liste von Tags, die dem importierten Bot hinzugefügt wurden.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Fehler

BadRequestException

Die Anfrage ist nicht wohlformuliert. Beispielsweise ist ein Wert ungültig oder ein erforderliches Feld fehlt. Überprüfen Sie die Feldwerte und versuchen Sie es erneut.

HTTP Status Code: 400

InternalFailureException

Ein interner Amazon Lex Lex-Fehler ist aufgetreten. Versuchen Sie es erneut.

HTTP Status Code: 500

LimitExceededException

Die Anfrage hat ein Limit überschritten. Versuchen Sie es erneut.

HTTP-Statuscode: 429

Weitere Informationen finden Sie auch unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: