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」符合「XYZ」和「阿卡茲」。

長度限制：長度下限為 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

如果回應遭到截斷，則回應會包含一個分頁 Token，您可以在下一個要求中指定，以擷取下一頁的意圖。

類型：字串

錯誤

BadRequestException

請求的格式不正確。例如，值無效或缺少必填欄位。請檢查欄位值，然後再試一次。

HTTP 狀態碼：400

InternalFailureException

發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。

HTTP 狀態碼：500

LimitExceededException

請求超過限制。請再次嘗試您的請求。

HTTP 狀態碼：429

NotFoundException

找不到要求中指定的資源。請檢查資源，然後再試一次。

HTTP 狀態碼：404

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：