Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la guía Amazon Lex V2.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
GetBots
Devuelve información del bot de la siguiente forma:
-
Si proporciona el campo
nameContains, la respuesta incluye información sobre la versión$LATESTde todos los bots cuyo nombre contiene la cadena especificada. -
Si no especifica el campo
nameContains, la operación devuelve información sobre la versión$LATESTde todos los bots.
Esta operación necesita permiso para la acción lex:GetBots.
Sintaxis de la solicitud
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- maxResults
-
El número máximo de bots que se devuelve en la respuesta de la solicitud. El valor predeterminado es 10.
Rango válido: valor mínimo de 1. Valor máximo de 50.
- nameContains
-
La subcadena que debe coincidir con los nombres de bots. Se devolverá un bot si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.
Patrón:
^([A-Za-z]_?)+$ - nextToken
-
Un token de paginación que obtiene la siguiente página de bots. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de bots, especifique el token de paginación en la siguiente solicitud.
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"bots": [
{
"createdDate": number,
"description": "string",
"lastUpdatedDate": number,
"name": "string",
"status": "string",
"version": "string"
}
],
"nextToken": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- bots
-
Una matriz de objetos
botMetadata, con una entrada para cada bot.Tipo: matriz de objetos BotMetadata
- nextToken
-
Si la respuesta está truncada, incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de bots.
Tipo: cadena
Errores
- BadRequestException
-
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.
Código de estado HTTP: 400
- InternalFailureException
-
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.
Código de estado HTTP: 500
- LimitExceededException
-
La solicitud ha superado un límite. Intente volver a realizar la solicitud.
Código de estado HTTP: 429
- NotFoundException
-
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.
Código de estado HTTP: 404
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
