支援終止通知：在 2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2，請改參閱 Amazon Lex V2 指南。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
開始將機器人從 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 機器人名稱。 Amazon Lex V2
類型：字串
長度限制：長度下限為 2。長度上限為 50。
模式：
^([A-Za-z]_?)+$必要：是
- v1BotVersion
-
要遷移至 Amazon Lex V2 的機器人版本。您可以遷移
$LATEST版本以及任何編號的版本。類型：字串
長度限制：長度下限為 1。長度上限為 64。
模式：
\$LATEST|[0-9]+必要：是
- v2BotName
-
您要將 Amazon Lex V2 機器人遷移至其中的 Amazon Lex V1 機器人名稱。
-
如果 Amazon Lex V2 機器人不存在，您必須使用
CREATE_NEW遷移策略。 -
如果 Amazon Lex V2 機器人存在，您必須使用
UPDATE_EXISTING遷移策略來變更 Amazon Lex V2 機器人的內容。
類型：字串
長度限制：長度下限為 1。長度上限為 100。
模式：
^([0-9a-zA-Z][_-]?)+$必要：是
-
- v2BotRole
-
Amazon Lex 用來執行 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"
}回應元素
如果動作成功，則服務傳回 HTTP 202 回應。
服務會傳回下列 JSON 格式的資料。
- migrationId
-
Amazon Lex 指派給遷移的唯一識別符。
類型：字串
長度限制條件：固定長度為 10。
模式：
^[0-9a-zA-Z]+$ - migrationStrategy
-
用來執行遷移的策略。
類型：字串
有效值:
CREATE_NEW | UPDATE_EXISTING - migrationTimestamp
-
遷移開始的日期和時間。
類型：Timestamp
- v1BotLocale
-
用於 Amazon Lex V1 機器人的地區設定。
類型：字串
有效值:
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
-
您要遷移至 Amazon Lex V2 的 Amazon Lex V1 機器人名稱。 Amazon Lex V2
類型：字串
長度限制：長度下限為 2。長度上限為 50。
模式：
^([A-Za-z]_?)+$ - v1BotVersion
-
要遷移至 Amazon Lex V2 的機器人版本。
類型：字串
長度限制：長度下限為 1。長度上限為 64。
模式：
\$LATEST|[0-9]+ - v2BotId
-
Amazon Lex V2 機器人的唯一識別符。
類型：字串
長度限制條件：固定長度為 10。
模式：
^[0-9a-zA-Z]+$ - v2BotRole
-
Amazon Lex 用來執行 Amazon Lex V2 機器人的 IAM 角色。
類型：字串
長度限制︰長度下限為 20。長度上限為 2048。
模式：
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
錯誤
- AccessDeniedException
-
您的 IAM 使用者或角色沒有呼叫遷移機器人所需的 Amazon Lex V2 APIs 的許可。
HTTP 狀態碼：403
- BadRequestException
-
請求格式不正確。例如，值無效或缺少必要欄位。請檢查欄位值，然後再試一次。
HTTP 狀態碼：400
- InternalFailureException
-
發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。
HTTP 狀態碼：500
- LimitExceededException
-
請求超過限制。請再次嘗試您的請求。
HTTP 狀態碼：429
- NotFoundException
-
找不到請求中指定的資源。請檢查資源，然後再試一次。
HTTP 狀態碼：404
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
