如果您使用的是 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 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- botVersion
-
自动程序的版本。
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
模式:
\$LATEST|[0-9]+
必需:是
- checksum
-
标识
$LATEST
版本的特定修订版。创建新机器人别名时,请将
checksum
字段留空。如果指定校验和,则会出现BadRequestException
异常。当您想更新机器人别名时,请将
checksum
字段设置为$LATEST
版本最新修订版的校验和。如果您未指定checksum
字段,或者校验和与$LATEST
版本不匹配,则会出现PreconditionFailedException
异常。类型:字符串
必需:否
- conversationLogs
-
别名的对话日志的设置。
类型:ConversationLogsRequest 对象
必需:否
- description
-
别名的描述。
类型:字符串
长度约束:最小长度为 0。最大长度为 200。
必需:否
-
要添加到机器人的标签列表。您只能在创建别名时添加标签,不能使用
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]_?)+$
-
与机器人关联的标签的列表。
类型:Tag 对象数组
数组成员:最少 0 个物品。最多 200 项。
错误
- BadRequestException
-
请求格式不正确。例如,值无效或必填字段未填充。检查字段值,然后重试。
HTTP 状态代码:400
- ConflictException
-
处理请求时出现冲突。请再次尝试您的请求。
HTTP 状态代码:409
- InternalFailureException
-
出现内部 Amazon Lex 错误。请再次尝试您的请求。
HTTP 状态代码:500
- LimitExceededException
-
请求超出了限制。请再次尝试您的请求。
HTTP 状态代码:429
- PreconditionFailedException
-
您尝试更改的资源的校验和与请求中的校验和不匹配。检查资源的校验和并重试。
HTTP 状态代码:412
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: