Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# GetBotChannelAssociations
<a name="API_GetBotChannelAssociations"></a>

 Restituisce un elenco di tutti i canali associati al bot specificato. 

L'`GetBotChannelAssociations`operazione richiede le autorizzazioni per l'`lex:GetBotChannelAssociations`azione.

## Sintassi della richiesta
<a name="API_GetBotChannelAssociations_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetBotChannelAssociations_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
Un alias che indica la versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^(-|^([A-Za-z]_?)+$)$`   
Obbligatorio: sì

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
Il nome del bot Amazon Lex nell'associazione.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
Il numero massimo di associazioni da restituire nella risposta. L'impostazione predefinita è 50.   
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi delle associazioni di canale. Verrà restituita un'associazione se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz». Per restituire tutte le associazioni dei canali dei bot, utilizzate un trattino («-») come parametro. `nameContains`  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva di associazioni. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di associazioni, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetBotChannelAssociations_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBotChannelAssociations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botChannelAssociations": [ 
      { 
         "botAlias": "string",
         "botConfiguration": { 
            "string" : "string" 
         },
         "botName": "string",
         "createdDate": number,
         "description": "string",
         "failureReason": "string",
         "name": "string",
         "status": "string",
         "type": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementi di risposta
<a name="API_GetBotChannelAssociations_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Una serie di oggetti, uno per ogni associazione, che fornisce informazioni sul bot Amazon Lex e sulla sua associazione con il canale.   
Tipo: matrice di oggetti [BotChannelAssociation](API_BotChannelAssociation.md)

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva di associazioni. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di associazioni, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

## Errori
<a name="API_GetBotChannelAssociations_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations)