サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# GetBotChannelAssociation
<a name="API_GetBotChannelAssociation"></a>

Amazon Lex ボットとメッセージングプラットフォームの間の関連付けに関する情報を返します。

このオペレーションには、`lex:GetBotChannelAssociation` アクションに対する許可が必要です。

## リクエストの構文
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

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

## URI リクエストパラメータ
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
この関連付けが作成されている Amazon Lex ボットの特定のバージョンを指すエイリアス。  
長さの制限：最小長 1、最大長は 100 です。  
パターン: `^([A-Za-z]_?)+$`   
必須: はい

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
Amazon Lex ボットの名前。  
長さの制限: 最小長は 2 です。最大長は 50 です。  
パターン: `^([A-Za-z]_?)+$`   
必須: はい

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
ボットとチャンネル間の関連付けの名前。名前は、大文字と小文字が区別されます。  
長さの制限：最小長 1、最大長は 100 です。  
パターン: `^([A-Za-z]_?)+$`   
必須: はい

## リクエストボディ
<a name="API_GetBotChannelAssociation_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_GetBotChannelAssociation_ResponseSyntax"></a>

```
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"
}
```

## レスポンス要素
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
この関連付けが作成されている Amazon Lex ボットの特定のバージョンを指すエイリアス。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 100 です。  
パターン: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
メッセージングプラットフォームが Amazon Lex ボットと通信するために必要な情報を提供します。  
型: 文字列間のマッピング  
マップエントリ: 10 の項目の最大数。

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
Amazon Lex ボットの名前。  
タイプ: 文字列  
長さの制限: 最小長は 2 です。最大長は 50 です。  
パターン: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
ボットとチャンネルの関連付けが作成された日付。  
型: タイムスタンプ

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
ボットとチャンネル間の関連付けの説明。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 200 です。

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
`status` が `FAILED` の場合、Amazon Lex は関連性の作成に失敗した理由を提示します。  
タイプ: 文字列

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
ボットとチャンネル間の関連付けの名前。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 100 です。  
パターン: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
ボットチャンネルのステータス。  
+  `CREATED` - チャンネルが作成され、使用可能な状態です。
+  `IN_PROGRESS` - チャンネルの作成中。
+  `FAILED` - チャンネルの作成中にエラーが発生しました。失敗の原因については、「`failureReason`」フィールドを参照してください。
型: 文字列  
有効な値：`IN_PROGRESS | CREATED | FAILED`

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
メッセージングプラットフォームのタイプ。  
型: 文字列  
有効な値：`Facebook | Slack | Twilio-Sms | Kik`

## エラー
<a name="API_GetBotChannelAssociation_Errors"></a>

 ** BadRequestException **   
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。  
HTTP ステータスコード: 400

 ** InternalFailureException **   
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。  
HTTP ステータスコード: 500

 ** LimitExceededException **   
リクエストが制限を超えました。リクエストを再試行してください。  
HTTP ステータスコード: 429

 ** NotFoundException **   
リクエストで指定されたリソースは見つかりませんでした。リソースを確認して、もう一度お試しください。  
HTTP ステータスコード: 404

## 以下の資料も参照してください。
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation)