GetMigration - Amazon Lex V1
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie 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.

GetMigration

Enthält Details zu einer laufenden oder vollständigen Migration von einem Amazon Lex V1-Bot zu einem Amazon Lex V2-Bot. Verwenden Sie diesen Vorgang, um die Migrationswarnungen und -warnungen im Zusammenhang mit der Migration anzuzeigen.

Anforderungssyntax

GET /migrations/migrationId HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

migrationId

Die eindeutige Kennung der Migration, die angezeigt werden soll. Der migrationID wird von der StartMigration Operation zurückgegeben.

Längenbeschränkungen: Feste Länge von 10.

Pattern: ^[0-9a-zA-Z]+$

Erforderlich: Ja

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "alerts": [ 
      { 
         "details": [ "string" ],
         "message": "string",
         "referenceURLs": [ "string" ],
         "type": "string"
      }
   ],
   "migrationId": "string",
   "migrationStatus": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "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.

alerts

Eine Liste von Warnungen und Warnungen, die auf Probleme bei der Migration des Amazon Lex V1-Bot zu Amazon Lex V2 hinweisen. Sie erhalten eine Warnung, wenn eine Amazon Lex V1-Funktion in Amazon Lex V2 anders implementiert ist.

Weitere Informationen finden Sie unter Einen Bot migrieren im Amazon Lex V2-Entwicklerhandbuch.

Typ: Array von MigrationAlert-Objekten

migrationId

Die eindeutige Kennung der Migration. Dies ist derselbe wie der Bezeichner, der beim Aufrufen der GetMigration Operation verwendet wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von 10.

Pattern: ^[0-9a-zA-Z]+$

migrationStatus

Zeigt den Status der Migration an. Wenn der Status lautet, ist COMPLETE die Migration abgeschlossen und der Bot ist in Amazon Lex V2 verfügbar. Möglicherweise gibt es Warnungen und Warnungen, die behoben werden müssen, um die Migration abzuschließen.

Typ: Zeichenfolge

Zulässige Werte: IN_PROGRESS | COMPLETED | FAILED

migrationStrategy

Die Strategie, mit der die Migration durchgeführt wurde.

  • CREATE_NEW- Erstellt einen neuen Amazon Lex V2-Bot und migriert den Amazon Lex V1-Bot auf den neuen Bot.

  • UPDATE_EXISTING- Überschreibt die vorhandenen Amazon Lex V2-Bot-Metadaten und das zu migrierende Gebietsschema. Es ändert keine anderen Gebietsschemas im Amazon Lex V2-Bot. Wenn das Gebietsschema nicht existiert, wird ein neues Gebietsschema im Amazon Lex V2-Bot erstellt.

Typ: Zeichenfolge

Zulässige Werte: CREATE_NEW | UPDATE_EXISTING

migrationTimestamp

Datum und Uhrzeit des Beginns der Migration.

Typ: Zeitstempel

v1BotLocale

Das Gebietsschema des Amazon Lex V1-Bots wurde auf Amazon Lex V2 migriert.

Typ: Zeichenfolge

Zulässige Werte: de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

v1BotName

Der Name des Amazon Lex V1-Bots, der auf Amazon Lex V2 migriert wurde.

Typ: Zeichenfolge

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

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

v1BotVersion

Die Version des Amazon Lex V1-Bots wurde auf Amazon Lex V2 migriert.

Typ: Zeichenfolge

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

Pattern: \$LATEST|[0-9]+

v2BotId

Die eindeutige Kennung des Amazon Lex V2-Bots, auf den Amazon Lex V1 migriert wird.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von 10.

Pattern: ^[0-9a-zA-Z]+$

v2BotRole

Die IAM-Rolle, die Amazon Lex verwendet, um den Amazon Lex V2-Bot auszuführen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 2048 Zeichen.

Pattern: ^arn:[\w\-]+:iam::[\d]{12}:role/.+$

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

NotFoundException

Die in der Anfrage angegebene Ressource wurde nicht gefunden. Überprüfen Sie die Ressource und versuchen Sie es erneut.

HTTP Status Code: 404

Weitere Informationen finden Sie unter:

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