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 Amazon Lex V1 o alle risorse Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
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à.
Restituisce le informazioni sul bot come segue:
-
Se fornite il
nameContainscampo, la risposta include informazioni sulla$LATESTversione di tutti i bot il cui nome contiene la stringa specificata. -
Se non specifichi il
nameContainscampo, l'operazione restituisce informazioni sulla$LATESTversione di tutti i tuoi bot.
Questa operazione richiede l’autorizzazione per l'operazione lex:GetBots.
Sintassi della richiesta
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- maxResults
-
Il numero massimo di bot da restituire nella risposta che la richiesta restituirà. Il valore predefinito è 10.
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.
- nameContains
-
Sottostringa da abbinare nei nomi dei bot. Un bot verrà restituito se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.
Modello:
^([A-Za-z]_?)+$ - nextToken
-
Un token di impaginazione che recupera la pagina successiva dei bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva dei bot, 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
{
"bots": [
{
"createdDate": number,
"description": "string",
"lastUpdatedDate": number,
"name": "string",
"status": "string",
"version": "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.
- bots
-
Una serie di
botMetadataoggetti, con un ingresso per ogni bot.Tipo: matrice di oggetti BotMetadata
- nextToken
-
Se la risposta viene troncata, include un token di impaginazione che puoi specificare nella tua prossima richiesta per recuperare la pagina successiva dei bot.
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
- NotFoundException
-
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.
Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
