终止支持通知:2025年9月15日, AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后,您将无法再访问亚马逊 Lex V1 主机或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2,请改为参阅 Amazon Lex V2 指南。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
提供有关从 Amazon Lex V1 机器人到 Amazon Lex V2 机器人的持续或完整迁移的详细信息。使用此操作可查看与迁移相关的迁移警报和警告。
请求语法
GET /migrations/migrationId
HTTP/1.1
URI 请求参数
请求使用以下 URI 参数。
- migrationId
-
要查看的迁移的唯一标识符。由 StartMigration 操作返回
migrationID
。长度限制:固定长度为 10。
模式:
^[0-9a-zA-Z]+$
必需:是
请求体
该请求没有请求正文。
响应语法
HTTP/1.1 200
Content-type: application/json
{
"alerts": [
{
"details": [ "string" ],
"message": "string",
"referenceURLs": [ "string" ],
"type": "string"
}
],
"migrationId": "string",
"migrationStatus": "string",
"migrationStrategy": "string",
"migrationTimestamp": number,
"v1BotLocale": "string",
"v1BotName": "string",
"v1BotVersion": "string",
"v2BotId": "string",
"v2BotRole": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- alerts
-
警报和警告列表,这些警报和警告表明 Amazon Lex V1 机器人迁移到 Amazon Lex V2 时存在问题。当 Amazon Lex V1 功能在 Amazon Lex V2 中有不同的实现方式时,您会收到警告。
有关更多信息,请参阅《Amazon Lex V2 开发人员指南》中的迁移机器人。
类型:MigrationAlert 对象数组
- migrationId
-
迁移的唯一标识符。这与调用
GetMigration
操作时使用的标识符相同。类型:字符串
长度限制:固定长度为 10。
模式:
^[0-9a-zA-Z]+$
- migrationStatus
-
表示迁移的状态。当迁移完成并且机器人在 Amazon Lex V2 中可用时,状态为
COMPLETE
。可能需要解决警报和警告才能完成迁移。类型:字符串
有效值:
IN_PROGRESS | COMPLETED | FAILED
- migrationStrategy
-
用于进行迁移的策略。
-
CREATE_NEW
— 创建新的 Amazon Lex V2 机器人并将 Amazon Lex V1 机器人迁移到新机器人。 -
UPDATE_EXISTING
— 覆盖现有的 Amazon Lex V2 机器人元数据和正在迁移的区域设置。它不会更改 Amazon Lex V2 机器人中的任何其他区域设置。如果该区域设置不存在,则会在 Amazon Lex V2 机器人中创建一个新的区域设置。
类型:字符串
有效值:
CREATE_NEW | UPDATE_EXISTING
-
- migrationTimestamp
-
启动迁移的日期和时间。
类型:时间戳
- v1BotLocale
-
已迁移到 Amazon Lex V2 的 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 的 Amazon Lex V1 机器人的版本。
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
模式:
\$LATEST|[0-9]+
- v2BotId
-
Amazon Lex V1 要迁移到的 Amazon Lex V2 机器人的唯一标识符。
类型:字符串
长度限制:固定长度为 10。
模式:
^[0-9a-zA-Z]+$
- v2BotRole
-
Amazon Lex 用来运行 Amazon Lex V2 机器人的 IAM 角色。
类型:字符串
长度约束:最小长度为 20。最大长度为 2048。
模式:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
错误
- BadRequestException
-
请求格式不正确。例如,值无效或必填字段未填充。检查字段值,然后重试。
HTTP 状态代码:400
- InternalFailureException
-
出现内部 Amazon Lex 错误。请再次尝试您的请求。
HTTP 状态代码:500
- LimitExceededException
-
请求超出了限制。请再次尝试您的请求。
HTTP 状态代码:429
- NotFoundException
-
找不到在请求中指定的资源。检查资源并重试。
HTTP 状态代码:404
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs,请参阅以下内容: