PutBotAlias - Amazon Lex V1

如果您使用的是 Amazon Lex V2,请改为参阅 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,我们建议您将机器人升级到 Amazon Lex V2。我们不再向 V1 添加新功能,强烈建议使用 V2 以获得全新的机器人。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

PutBotAlias

为指定版本的机器人创建别名,或替换指定机器人的别名。要更改别名指向的机器人的版本,请替换别名。有关别名的更多信息,请参阅版本控制和别名

此操作需要 lex:PutBotAlias 操作的权限。

请求语法

PUT /bots/botName/aliases/name HTTP/1.1 Content-type: application/json { "botVersion": "string", "checksum": "string", "conversationLogs": { "iamRoleArn": "string", "logSettings": [ { "destination": "string", "kmsKeyArn": "string", "logType": "string", "resourceArn": "string" } ] }, "description": "string", "tags": [ { "key": "string", "value": "string" } ] }

URI 请求参数

请求使用以下 URI 参数。

botName

机器人的名称。

长度限制:最小长度为 2。最大长度为 50。

模式:^([A-Za-z]_?)+$

必需:是

name

别名的名称。名称区分大小写。

长度限制:长度下限为 1。最大长度为 100。

模式:^([A-Za-z]_?)+$

必需:是

请求体

请求接受采用 JSON 格式的以下数据。

botVersion

自动程序的版本。

类型:字符串

长度限制:长度下限为 1。长度上限为 64。

模式:\$LATEST|[0-9]+

必需:是

checksum

标识 $LATEST 版本的特定修订版。

创建新机器人别名时,请将 checksum 字段留空。如果指定校验和,则会出现 BadRequestException 异常。

当您想更新机器人别名时,请将 checksum 字段设置为 $LATEST 版本最新修订版的校验和。如果您未指定 checksum 字段,或者校验和与 $LATEST 版本不匹配,则会出现 PreconditionFailedException 异常。

类型:字符串

必需:否

conversationLogs

别名的对话日志的设置。

类型:ConversationLogsRequest 对象

必需:否

description

别名的描述。

类型:字符串

长度约束:最小长度为 0。最大长度为 200。

必需:否

tags

要添加到机器人的标签列表。您只能在创建别名时添加标签,不能使用 PutBotAlias 操作来更新机器人别名上的标签。要更新标签,请使用 TagResource 操作。

类型:Tag 对象数组

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

必需:否

响应语法

HTTP/1.1 200 Content-type: application/json { "botName": "string", "botVersion": "string", "checksum": "string", "conversationLogs": { "iamRoleArn": "string", "logSettings": [ { "destination": "string", "kmsKeyArn": "string", "logType": "string", "resourceArn": "string", "resourcePrefix": "string" } ] }, "createdDate": number, "description": "string", "lastUpdatedDate": number, "name": "string", "tags": [ { "key": "string", "value": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

botName

别名指向的自动程序的名称。

类型:字符串

长度限制:最小长度为 2。最大长度为 50。

模式:^([A-Za-z]_?)+$

botVersion

别名指向的机器人的版本。

类型:字符串

长度限制:长度下限为 1。长度上限为 64。

模式:\$LATEST|[0-9]+

checksum

别名的最新版本的校验和。

类型:字符串

conversationLogs

确定 Amazon Lex 如何使用对话日志作为别名的设置。

类型:ConversationLogsResponse 对象

createdDate

机器人别名的创建日期。

类型:时间戳

description

别名的描述。

类型:字符串

长度约束:最小长度为 0。最大长度为 200。

lastUpdatedDate

机器人别名的更新日期。创建资源时,创建日期和上次更新日期相同。

类型:时间戳

name

别名的名称。

类型:字符串

长度约束:最小长度为 1。最大长度为 100。

模式:^([A-Za-z]_?)+$

tags

与机器人关联的标签的列表。

类型:Tag 对象数组

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

错误

BadRequestException

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

HTTP 状态代码:400

ConflictException

处理请求时出现冲突。请再次尝试您的请求。

HTTP 状态代码:409

InternalFailureException

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

HTTP 状态代码:500

LimitExceededException

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

HTTP 状态代码:429

PreconditionFailedException

您尝试更改的资源的校验和与请求中的校验和不匹配。检查资源的校验和并重试。

HTTP 状态代码:412

另请参阅

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