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à.

# GetBots
<a name="API_GetBots"></a>

Restituisce le informazioni sul bot come segue: 
+ Se fornite il `nameContains` campo, la risposta include informazioni sulla `$LATEST` versione di tutti i bot il cui nome contiene la stringa specificata.
+ Se non specifichi il `nameContains` campo, l'operazione restituisce informazioni sulla `$LATEST` versione di tutti i tuoi bot.

Questa operazione richiede l’autorizzazione per l'operazione `lex:GetBots`.

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

```
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
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](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
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](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
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
<a name="API_GetBots_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

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

```
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
<a name="API_GetBots_ResponseElements"></a>

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

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

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
Una serie di `botMetadata` oggetti, con un ingresso per ogni bot.   
Tipo: matrice di oggetti [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
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: String

## Errori
<a name="API_GetBots_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

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBots_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/GetBots) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots)