GetBotVersions - Amazon Lex V1
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅

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

 

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

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

GetBotVersions

获取有关机器人的所有版本的信息。

GetBotVersions 操作会为每个版本的机器人返回一个 BotMetadata 对象。例如，如果机器人有三个带编号的版本，则 GetBotVersions 操作会在响应中返回四个 BotMetadata 对象，每个编号版本一个，$LATEST 版本一个。

GetBotVersions 操作始终返回至少一个版本，即 $LATEST 版本。

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

请求语法

GET /bots/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

maxResults

要在一个响应中返回的机器人版本的最大数量。默认值为 10。

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

name

应返回其版本的自动程序的名称。

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

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

必需：是

nextToken

用于获取下一页机器人版本的分页令牌。如果对此调用的响应被截断，Amazon Lex 将在响应中返回分页令牌。要获取下一页版本，请在下一个请求中指定分页令牌。

请求正文

该请求没有请求正文。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "bots": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "status": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}

响应元素

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

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

bots

BotMetadata 对象数组，每个编号的机器人版本各一个，$LATEST 版本一个。

类型：BotMetadata 对象数组

nextToken

用于获取下一页机器人版本的分页令牌。如果对此调用的响应被截断，Amazon Lex 将在响应中返回分页令牌。要获取下一页版本，请在下一个请求中指定分页令牌。

类型：字符串

错误

BadRequestException

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

HTTP 状态代码：400

InternalFailureException

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

HTTP 状态代码：500

LimitExceededException

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

HTTP 状态代码：429

NotFoundException

找不到在请求中指定的资源。检查资源并重试。

HTTP 状态代码：404

另请参阅

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