GetBotAliases - Amazon Lex V1

终止支持通知:2025年9月15日, AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后,您将无法再访问亚马逊 Lex V1 主机或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2,请改为参阅 Amazon Lex V2 指南

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

GetBotAliases

返回指定 Amazon Lex 机器人的别名列表。

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

请求语法

GET /bots/botName/aliases/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

botName

机器人的名称。

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

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

必需:是

maxResults

要在响应中返回的别名的最大数量。默认值为 50。

有效范围:最小值为 1。最大值为 50。

nameContains

机器人别名中要匹配的子字符串。如果别名名称的任何部分与子字符串匹配,则将返回别名。例如,“xyz”同时匹配“xyzabc”和“abcxyz”。

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

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

nextToken

用于获取下一页别名的分页令牌。如果对此调用的响应被截断,Amazon Lex 将在响应中返回分页令牌。要获取下一页的别名,请在下一个请求中指定分页令牌。

请求正文

该请求没有请求正文。

响应语法

HTTP/1.1 200 Content-type: application/json { "BotAliases": [ { "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" } ], "nextToken": "string" }

响应元素

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

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

BotAliases

BotAliasMetadata 对象数组,每个对象都描述一个机器人别名。

类型:BotAliasMetadata 对象数组

nextToken

用于获取下一页别名的分页令牌。如果对此调用的响应被截断,Amazon Lex 将在响应中返回分页令牌。要获取下一页的别名,请在下一个请求中指定分页令牌。

类型:字符串

错误

BadRequestException

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

HTTP 状态代码:400

InternalFailureException

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

HTTP 状态代码:500

LimitExceededException

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

HTTP 状态代码:429

另请参阅

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