GetBotVersions - Amazon Lex versione 1

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

GetBotVersions

Ottiene informazioni su tutte le versioni di un bot.

L'GetBotVersionsoperazione restituisce un BotMetadata oggetto per ogni versione di un bot. Ad esempio, se un bot ha tre versioni numerate, l'GetBotVersionsoperazione restituisce quattro BotMetadata oggetti nella risposta, uno per ogni versione numerata e uno per la $LATEST versione.

L'GetBotVersionsoperazione restituisce sempre almeno una versione, la $LATEST versione.

Questa operazione richiede le autorizzazioni per l'operazione lex:GetBotVersions.

Sintassi della richiesta

GET /bots/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

maxResults

Il numero massimo di versioni del bot da restituire nella risposta. Il valore predefinito è 10.

Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

name

Il nome del bot per il quale restituire le versioni.

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

Modello: ^([A-Za-z]_?)+$

Campo obbligatorio: sì

nextToken

Un token di impaginazione per recuperare la pagina successiva delle versioni dei bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, 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, uno per ogni versione numerata del bot più uno per la versione. $LATEST

Tipo: matrice di oggetti BotMetadata

nextToken

Un token di impaginazione per recuperare la pagina successiva delle versioni del bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, 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

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: