リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。

Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

StartMigration

Amazon Lex V1 から Amazon Lex V2 へのボットの移行を開始します。Amazon Lex V2 の新機能を利用する場合は、ボットを移行します。

詳細については、「Amazon Lex developer guide」(Amazon Lex デベロッパーガイド) の「Migrating a bot」(ボットの移行) を参照してください。

リクエストの構文


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

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

URI リクエストパラメータ

リクエストでは URI パラメータを使用しません。

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

migrationStrategy

移行を実行するために使用された戦略。

CREATE_NEW - 新しい Amazon Lex V2 ボットを作成し、Amazon Lex V1 ボットをこの新しいボットに移行します。
UPDATE_EXISTING - 既存の Amazon Lex V2 ボットのメタデータおよび移行されるロケールを上書きします。Amazon Lex V2 ボットの他のロケールは変更されません。ロケールが存在しない場合は、Amazon Lex V2 ボットに新しいロケールが作成されます。

型: 文字列

有効な値: CREATE_NEW | UPDATE_EXISTING

必須: はい

v1BotName

Amazon Lex V2 に移行する Amazon Lex V1 ボットの名前。

型: 文字列

長さの制限: 最小長は 2 です。最大長は 50 です。

パターン: ^([A-Za-z]_?)+$

必須: はい

v1BotVersion

Amazon Lex V2 に移行するボットのバージョン。$LATEST バージョンだけでなく、任意の番号のバージョンを移行することができます。

型: 文字列

長さの制限：最小長は 1 です。最大長は 64 文字です。

パターン: \$LATEST|[0-9]+

必須: はい

v2BotName

Amazon Lex V1 ボットの移行先となる Amazon Lex V2 ボットの名前。

Amazon Lex V2 のボットが存在しない場合は、CREATE_NEW の移行戦略を使用する必要があります。
Amazon Lex V2 ボットが存在する場合、UPDATE_EXISTING 移行戦略を使用して Amazon Lex V2 ボットの内容を変更する必要があります。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 100 です。

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

必須: はい

v2BotRole

Amazon Lex が Amazon Lex V2 ボットの実行に使用する IAM ロール。

型: 文字列

長さの制限: 最小長は 20 です。最大長は 2,048 です。

パターン: ^arn:[\w\-]+:iam::[\d]{12}:role/.+$

必須：はい

レスポンスの構文


HTTP/1.1 202
Content-type: application/json

{
   "migrationId": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}