GetMigrations - 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.

GetMigrations

Ruft eine Liste der Migrationen zwischen Amazon Lex V1 und Amazon Lex V2 ab.

Anforderungssyntax

GET /migrations?maxResults=maxResults&migrationStatusEquals=migrationStatusEquals&nextToken=nextToken&sortByAttribute=sortByAttribute&sortByOrder=sortByOrder&v1BotNameContains=v1BotNameContains HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

maxResults

Die maximale Anzahl von Migrationen, die in der Antwort zurückgegeben werden sollen. Der Standardwert ist 10.

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 50.

migrationStatusEquals

Filtert die Liste so, dass sie nur Migrationen im angegebenen Status enthält.

Zulässige Werte: IN_PROGRESS | COMPLETED | FAILED

nextToken

Ein Paginierungstoken, das die nächste Seite mit Migrationen abruft. Wenn die Antwort auf diesen Vorgang gekürzt wird, gibt Amazon Lex in der Antwort ein Paginierungstoken zurück. Um die nächste Seite mit Migrationen abzurufen, geben Sie das Paginierungstoken in der Anfrage an.

sortByAttribute

Das Feld, nach dem die Liste der Migrationen sortiert werden soll. Sie können nach dem Namen des Amazon Lex V1-Bots oder dem Datum und der Uhrzeit des Starts der Migration sortieren.

Zulässige Werte: V1_BOT_NAME | MIGRATION_DATE_TIME

sortByOrder

Die Reihenfolge, in der die Liste sortiert wird.

Zulässige Werte: ASCENDING | DESCENDING

v1BotNameContains

Filtert die Liste so, dass sie nur Bots enthält, deren Name die angegebene Zeichenfolge enthält. Die Zeichenfolge entspricht einer beliebigen Stelle im Bot-Namen.

Längenbeschränkungen: Mindestlänge von 2. Maximale Länge = 50 Zeichen.

Pattern: ^([A-Za-z]_?)+$

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "migrationSummaries": [ 
      { 
         "migrationId": "string",
         "migrationStatus": "string",
         "migrationStrategy": "string",
         "migrationTimestamp": number,
         "v1BotLocale": "string",
         "v1BotName": "string",
         "v1BotVersion": "string",
         "v2BotId": "string",
         "v2BotRole": "string"
      }
   ],
   "nextToken": "string"
}

Antwortelemente

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

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

migrationSummaries

Eine Reihe von Zusammenfassungen für Migrationen von Amazon Lex V1 zu Amazon Lex V2. Einzelheiten der Migration finden Sie in der migrationId Zusammenfassung in einem Aufruf des Vorgangs. GetMigration

Typ: Array von MigrationSummary-Objekten

nextToken

Wenn die Antwort gekürzt ist, enthält sie ein Paginierungstoken, das Sie in Ihrer nächsten Anfrage angeben können, um die nächste Seite mit Migrationen abzurufen.

Typ: Zeichenfolge

Fehler

BadRequestException

Die Anfrage ist nicht korrekt formuliert. 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: