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

StartMigration

Startet die Migration eines Bots von Amazon Lex V1 zu Amazon Lex V2. Migrieren Sie Ihren Bot, wenn Sie die neuen Funktionen von Amazon Lex V2 nutzen möchten.

Weitere Informationen finden Sie unter Einen Bot migrieren im Amazon Lex Developer Guide.

Anforderungssyntax

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

{
   "migrationStrategy": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotName": "string",
   "v2BotRole": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

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

Erforderlich: Ja

v1BotName

Der Name des Amazon Lex V1-Bots, den Sie zu Amazon Lex V2 migrieren.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

v1BotVersion

Die Version des Bots, der auf Amazon Lex V2 migriert werden soll. Sie können die $LATEST Version sowie jede nummerierte Version migrieren.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

v2BotName

Der Name des Amazon Lex V2-Bots, zu dem Sie den Amazon Lex V1-Bot migrieren.

  • Wenn der Amazon Lex V2-Bot nicht existiert, müssen Sie die CREATE_NEW Migrationsstrategie verwenden.

  • Wenn der Amazon Lex V2-Bot vorhanden ist, müssen Sie die UPDATE_EXISTING Migrationsstrategie verwenden, um den Inhalt des Amazon Lex V2-Bots zu ändern.

Typ: Zeichenfolge

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

Pattern: ^([0-9a-zA-Z][_-]?)+$

Erforderlich: Ja

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/.+$

Erforderlich: Ja

Antwortsyntax

HTTP/1.1 202
Content-type: application/json

{
   "migrationId": "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 202-Antwort zurück.

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

migrationId

Die eindeutige Kennung, die Amazon Lex der Migration zugewiesen hat.

Typ: Zeichenfolge

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

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

migrationStrategy

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

Typ: Zeichenfolge

Zulässige Werte: CREATE_NEW | UPDATE_EXISTING

migrationTimestamp

Datum und Uhrzeit des Beginns der Migration.

Typ: Zeitstempel

v1BotLocale

Das für den Amazon Lex V1-Bot verwendete Gebietsschema.

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, den Sie zu Amazon Lex V2 migrieren.

Typ: Zeichenfolge

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

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

v1BotVersion

Die Version des Bots, der auf Amazon Lex V2 migriert werden soll.

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 für den Amazon Lex V2-Bot.

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

AccessDeniedException

Ihr IAM-Benutzer oder Ihre IAM-Rolle ist nicht berechtigt, die Amazon Lex V2-APIs aufzurufen, die für die Migration Ihres Bots erforderlich sind.

HTTP Status Code: 403

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: