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

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

 

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

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

GetBotChannelAssociation

傳回 Amazon Lex 機器人與簡訊平台之間關聯的相關資訊。

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

請求語法

GET /bots/botName/aliases/aliasName/channels/name HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

aliasName

指向建立此關聯之特定 Amazon Lex 機器人版本的別名。

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

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

必要：是

botName

Amazon Lex 機器人的名稱。

長度約束：最小長度為 2。長度上限為 50。

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

必要：是

name

機器人與通道之間的關聯名稱。名稱區分大小寫。

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

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

必要：是

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botConfiguration": { 
      "string" : "string" 
   },
   "botName": "string",
   "createdDate": number,
   "description": "string",
   "failureReason": "string",
   "name": "string",
   "status": "string",
   "type": "string"
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

botAlias

指向建立此關聯之特定 Amazon Lex 機器人版本的別名。

類型：字串

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

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

botConfiguration

提供簡訊平台與 Amazon Lex 機器人通訊所需的資訊。

類型：字串到字串映射

地圖項目：最多 10 個項目。

botName

Amazon Lex 機器人的名稱。

類型：字串

長度約束：最小長度為 2。長度上限為 50。

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

createdDate

建立機器人與通道之間關聯的日期。

類型：Timestamp

description

機器人與通道之間關聯的說明。

類型：字串

長度限制：長度下限為 0。長度上限為 200。

failureReason

如果status是FAILED，Amazon Lex 會提供無法建立關聯的原因。

類型：字串

name

機器人與通道之間的關聯名稱。

類型：字串

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

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

status

機器人通道的狀態。

  • CREATED-該頻道已創建並準備使用。

  • IN_PROGRESS-頻道創建正在進行中。

  • FAILED-建立頻道時發生錯誤。如需失敗原因的相關資訊，請參閱failureReason欄位。

類型：字串

有效值:IN_PROGRESS | CREATED | FAILED

type

訊息平台的類型。

類型：字串

有效值:Facebook | Slack | Twilio-Sms | Kik

錯誤

BadRequestException

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

HTTP 狀態碼：400

InternalFailureException

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

HTTP 狀態碼：500

LimitExceededException

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

HTTP 狀態碼：429

NotFoundException

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

HTTP 狀態碼：404

另請參閱

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