GetBots - Amazon Lex versione 1
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

GetBots

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

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 botMetadata oggetti, 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 uno degli AWS SDK specifici della lingua, consulta quanto segue: