终止支持通知：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 机器人的名称。类型：字符串长度限制：最小长度为 2。最大长度为 50。模式：`^([A-Za-z]_?)+$` 是否必需：是 ** [v1BotVersion](#API_StartMigration_RequestSyntax) ** 要迁移到 Amazon Lex V2 的机器人的版本。您可以迁移 `$LATEST` 版本以及任何编号的版本。类型：字符串长度限制：最小长度为 1。长度上限为 64。模式：`\$LATEST|[0-9]+` 是否必需：是 ** [v2BotName](#API_StartMigration_RequestSyntax) ** 要将 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](#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) ** 启动迁移的日期和时间。类型：时间戳 ** [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 机器人的名称。类型：字符串长度限制：最小长度为 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 用户或角色无权调用迁移机器人 APIs 所需的 Amazon Lex V2。 HTTP 状态代码：403 ** BadRequestException ** 请求格式不正确。例如，值无效或必填字段未填充。检查字段值，然后重试。 HTTP 状态代码：400 ** InternalFailureException ** 出现内部 Amazon Lex 错误。请再次尝试您的请求。 HTTP 状态代码：500 ** LimitExceededException ** 请求超出了限制。请再次尝试您的请求。 HTTP 状态代码：429 ** NotFoundException ** 找不到在请求中指定的资源。检查资源并重试。 HTTP 状态代码：404 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) + [AWS Python 软件开发工具包](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)