StartImport - Amazon Lex V1

如果您使用的是 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

必需:是

tags

要添加到导入的机器人的标签列表。您只能在导入机器人时添加标签,不能为意图或插槽类型添加标签。

类型: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

tags

添加到导入的机器人的标签列表。

类型:Tag 对象数组

数组成员:最少 0 个物品。最多 200 项。

错误

BadRequestException

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

HTTP 状态代码:400

InternalFailureException

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

HTTP 状态代码:500

LimitExceededException

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

HTTP 状态代码:429

另请参阅

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