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

回應中要傳回的 Bot 版本數目上限。預設為 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 的詳細資訊，請參閱下列內容：