GetIntentVersions - Amazon Lex V1
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

如果您使用的是 Amazon Lex V2，請改參閱 Amazon Lex V2 指南。

 

如果您使用的是 Amazon Lex V1，我們建議您將機器人升級至 Amazon Lex V2。我們不再將新功能新增至 V1，並強烈建議對所有新機器人使用 V2。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

GetIntentVersions

獲取有關意圖的所有版本的信息。

此GetIntentVersions作業會針IntentMetadata對每個意圖版本傳回物件。例如，如果意圖有三個編號版本，則GetIntentVersions作業會在回應中傳回四個IntentMetadata物件，每個物件會傳回一個編號版本，另一個用於$LATEST版本。

該GetIntentVersions操作始終返回至少一個版本，即$LATEST版本。

這項操作需要 lex:GetIntentVersions 動作的許可。

請求語法

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

URI 請求參數

請求會使用下列 URI 參數。

maxResults

回應中要傳回的意圖版本數目上限。預設為 10。

有效範圍：最小值為 1。最大值為 50。

name

應該返回哪些版本的意圖的名稱。

長度限制：長度下限為 1。長度上限為 100。

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

必要：是

nextToken

用於獲取意圖版本的下一頁的分頁令牌。如果截斷對此呼叫的回應，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

IntentMetadata物件陣列，意圖的每個編號版本各有一個，另外一個用於$LATEST版本。

類型：IntentMetadata 物件陣列

nextToken

用於獲取意圖版本的下一頁的分頁令牌。如果截斷對此呼叫的回應，Amazon Lex 會在回應中傳回分頁權杖。要獲取版本的下一頁，請在下一個請求中指定分頁令牌。

類型：字串

錯誤

BadRequestException

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

HTTP 狀態碼：400

InternalFailureException

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

HTTP 狀態碼：500

LimitExceededException

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

HTTP 狀態碼：429

NotFoundException

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

HTTP 狀態碼：404

另請參閱

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