Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
Se utilizzi Amazon Lex V1, ti consigliamo di aggiornare i bot ad Amazon Lex V2. Non stiamo più aggiungendo nuove funzionalità alla V1 e consigliamo vivamente di utilizzare la V2 per tutti i nuovi bot.
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
Restituisce un elenco di tutti i canali associati al bot specificato.
L'GetBotChannelAssociationsoperazione richiede le autorizzazioni per l'lex:GetBotChannelAssociationsazione.
Sintassi della richiesta
GET /bots/botName/aliases/aliasName/channels/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- aliasName
-
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]_?)+$)$Campo obbligatorio: sì
- botName
-
Il nome del bot Amazon Lex nell'associazione.
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.
Modello:
^([A-Za-z]_?)+$Campo obbligatorio: sì
- maxResults
-
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
-
Sottostringa da abbinare nei nomi delle associazioni di canale. Un'associazione verrà restituita 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.
nameContainsLimitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello:
^([A-Za-z]_?)+$ - nextToken
-
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
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
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
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- botChannelAssociations
-
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
- nextToken
-
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: stringa
Errori
- 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
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
