StartMigration

開始將機器人從 Amazon Lex V1 遷移到 Amazon Lex V2。當您想要利用 Amazon Lex V2 的新功能時，請移轉您的機器人。

如需詳細資訊，請參閱 Amazon Lex 開發人員指南中的移轉機器人。

請求語法


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。

模式：^([0-9a-zA-Z][_-]?)+$

必要：是

v2BotRole

亞馬遜萊克斯用來執行亞馬遜萊克 Amazon Lex V2 機器人的 IAM 角色。

類型：字串

長度限制︰長度下限為 20。長度上限為 2048。

模式：^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"
}