如果您使用的是 Amazon Lex V2,请改为参阅 Amazon Lex V2 指南。
如果您使用的是 Amazon Lex V1,我们建议您将机器人升级到 Amazon Lex V2。我们不再向 V1 添加新功能,强烈建议使用 V2 以获得全新的机器人。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
StartImport
启动作业以将资源导入到 Amazon Lex 中。
请求语法
POST /imports/ HTTP/1.1
Content-type: application/json
{
"mergeStrategy": "string
",
"payload": blob
,
"resourceType": "string
",
"tags": [
{
"key": "string
",
"value": "string
"
}
]
}
URI 请求参数
该请求不使用任何 URI 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- mergeStrategy
-
指定当存在同名的现有资源时,应采取的
StartImport
操作。-
FAIL_ON_CONFLICT — 导入文件中的资源与现有资源发生第一次冲突时,导入操作将停止。导致冲突的资源名称位于对
GetImport
操作的响应的failureReason
字段中。OVERWRITE_LATEST — 即使与现有资源发生冲突,导入操作也会继续进行。现有资源的 $LASTEST 版本会被导入文件中的数据覆盖。
类型:字符串
有效值:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
必需:是
-
- payload
-
二进制格式的 zip 存档。存档应包含一个文件:一个包含要导入的资源的 JSON 文件。资源应与在
resourceType
字段中指定的类型相匹配。类型:Base64 编码的二进制数据对象
必需:是
- resourceType
-
指定要导出的资源的类型。每种资源还会导出它所依赖的任何资源。
-
机器人会导出依赖的意图。
-
意图会导出依赖的插槽类型。
类型:字符串
有效值:
BOT | INTENT | SLOT_TYPE
必需:是
-
-
要添加到导入的机器人的标签列表。您只能在导入机器人时添加标签,不能为意图或插槽类型添加标签。
类型:Tag 对象数组
数组成员:最少 0 个物品。最多 200 项。
必需:否
响应语法
HTTP/1.1 201
Content-type: application/json
{
"createdDate": number,
"importId": "string",
"importStatus": "string",
"mergeStrategy": "string",
"name": "string",
"resourceType": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 201 响应。
服务以 JSON 格式返回的以下数据。
- createdDate
-
请求导入作业的日期和时间的时间戳。
类型:时间戳
- importId
-
特定导入作业的标识符。
类型:字符串
- importStatus
-
导入作业的状态。如果状态为
FAILED
,则可以使用GetImport
操作获取失败的原因。类型:字符串
有效值:
IN_PROGRESS | COMPLETE | FAILED
- mergeStrategy
-
发生合并冲突时要执行的操作。
类型:字符串
有效值:
OVERWRITE_LATEST | FAIL_ON_CONFLICT
- name
-
提供给导入作业的名称。
类型:字符串
长度约束:最小长度为 1。最大长度为 100。
模式:
[a-zA-Z_]+
- resourceType
-
要导入的资源的类型。
类型:字符串
有效值:
BOT | INTENT | SLOT_TYPE
-
添加到导入的机器人的标签列表。
类型:Tag 对象数组
数组成员:最少 0 个物品。最多 200 项。
错误
- BadRequestException
-
请求格式不正确。例如,值无效或必填字段未填充。检查字段值,然后重试。
HTTP 状态代码:400
- InternalFailureException
-
出现内部 Amazon Lex 错误。请再次尝试您的请求。
HTTP 状态代码:500
- LimitExceededException
-
请求超出了限制。请再次尝试您的请求。
HTTP 状态代码:429
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: