支援終止通知：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2，請改參閱 [Amazon Lex V2 指南](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartMigration 開始將機器人從 Amazon Lex V1 遷移至 Amazon Lex V2。當您想要利用 Amazon Lex V2 的新功能時，請遷移您的機器人。如需詳細資訊，請參閱《*Amazon Lex 開發人員指南*》中的[遷移機器人](https://docs.aws.amazon.com/lex/latest/dg/migrate.html)。 ## 請求語法 ``` POST /migrations HTTP/1.1 Content-type: application/json { "migrationStrategy": "string", "v1BotName": "string", "v1BotVersion": "string", "v2BotName": "string", "v2BotRole": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [migrationStrategy](#API_StartMigration_RequestSyntax) ** 用來執行遷移的策略。 + `CREATE_NEW` - 建立新的 Amazon Lex V2 機器人，並將 Amazon Lex V1 機器人遷移至新的機器人。 + `UPDATE_EXISTING` - 覆寫現有的 Amazon Lex V2 機器人中繼資料和要遷移的地區設定。它不會變更 Amazon Lex V2 機器人中的任何其他地區設定。如果地區設定不存在，則會在 Amazon Lex V2 機器人中建立新的地區設定。類型：字串有效值:`CREATE_NEW | UPDATE_EXISTING` 必要：是 ** [v1BotName](#API_StartMigration_RequestSyntax) ** 您要遷移至 Amazon Lex V2 的 Amazon Lex V1 機器人名稱。 Amazon Lex V2 類型：字串長度限制：長度下限為 2。長度上限為 50。模式：`^([A-Za-z]_?)+$` 必要：是 ** [v1BotVersion](#API_StartMigration_RequestSyntax) ** 要遷移至 Amazon Lex V2 的機器人版本。您可以遷移`$LATEST`版本以及任何編號的版本。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`\$LATEST|[0-9]+` 必要：是 ** [v2BotName](#API_StartMigration_RequestSyntax) ** 您要遷移 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](#API_StartMigration_RequestSyntax) ** 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](#API_StartMigration_ResponseSyntax) ** Amazon Lex 指派給遷移的唯一識別符。類型：字串長度限制：固定長度為 10。模式：`^[0-9a-zA-Z]+$` ** [migrationStrategy](#API_StartMigration_ResponseSyntax) ** 用來執行遷移的策略。類型：字串有效值:`CREATE_NEW | UPDATE_EXISTING` ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) ** 遷移開始的日期和時間。類型：Timestamp ** [v1BotLocale](#API_StartMigration_ResponseSyntax) ** 用於 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](#API_StartMigration_ResponseSyntax) ** 您要遷移至 Amazon Lex V2 的 Amazon Lex V1 機器人名稱。 Amazon Lex V2 類型：字串長度限制：長度下限為 2。長度上限為 50。模式：`^([A-Za-z]_?)+$` ** [v1BotVersion](#API_StartMigration_ResponseSyntax) ** 要遷移至 Amazon Lex V2 的機器人版本。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`\$LATEST|[0-9]+` ** [v2BotId](#API_StartMigration_ResponseSyntax) ** Amazon Lex V2 機器人的唯一識別符。類型：字串長度限制：固定長度為 10。模式：`^[0-9a-zA-Z]+$` ** [v2BotRole](#API_StartMigration_ResponseSyntax) ** 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 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration)