如果您使用的是 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 的更多信息,请参阅以下内容: