StartMigration - Amazon Lex V1

如果您使用的是 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 开发人员指南中的迁移机器人

请求语法

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 用来运行 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

启动迁移的日期和时间。

类型:时间戳

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 机器人的名称。

类型:字符串

长度限制:最小长度为 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 API。

HTTP 状态代码:403

BadRequestException

请求格式不正确。例如,值无效或必填字段未填充。检查字段值,然后重试。

HTTP 状态代码:400

InternalFailureException

出现内部 Amazon Lex 错误。请再次尝试您的请求。

HTTP 状态代码:500

LimitExceededException

请求超出了限制。请再次尝试您的请求。

HTTP 状态代码:429

NotFoundException

找不到在请求中指定的资源。检查资源并重试。

HTTP 状态代码:404

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: