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

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

 

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

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

GetIntents

返回意图信息，如下所示：

  • 如果指定 nameContains 字段，则返回包含指定字符串的所有意图的 $LATEST 版本。

  • 如果未指定 nameContains 字段，则返回有关所有意图的 $LATEST 版本的信息。

该操作需要 lex:GetIntents 操作的权限。

请求语法

GET /intents/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

maxResults

要在响应中返回的意图的最大数量。默认值为 10。

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

nameContains

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

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

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

nextToken

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

请求正文

该请求没有请求正文。

响应语法

HTTP/1.1 200
Content-type: application/json

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

响应元素

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

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

intents

Intent 对象数组。有关更多信息，请参阅 PutBot。

类型：IntentMetadata 对象数组

nextToken

如果响应被截断，则响应会包含一个分页令牌，您可以在下次请求中指定该令牌来获取下一页意图。

类型：字符串

错误

BadRequestException

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

HTTP 状态代码：400

InternalFailureException

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

HTTP 状态代码：500

LimitExceededException

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

HTTP 状态代码：429

NotFoundException

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

HTTP 状态代码：404

另请参阅

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