Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.
Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
GetBotVersions
Obtém informações sobre todas as versões de um bot.
A operação GetBotVersions
retorna um objeto BotMetadata
para cada versão de um bot. Por exemplo, se um bot tiver três versões numeradas, a operação GetBotVersions
retornará quatro objetos BotMetadata
na resposta, um para cada versão numerada e um para a versão $LATEST
.
A operação GetBotVersions
sempre retorna pelo menos uma versão, a versão$LATEST
.
Essa operação exige permissões para a ação lex:GetBotVersions
.
Sintaxe da Solicitação
GET /bots/name
/versions/?maxResults=maxResults
&nextToken=nextToken
HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- maxResults
-
O número máximo de versões de bot a ser retornado em uma resposta. O padrão é 10.
Faixa válida: valor mínimo de 1. Valor máximo de 50.
- name
-
O nome do bot para o qual as versões devem ser retornadas.
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.
Padrão:
^([A-Za-z]_?)+$
Exigido: Sim
- nextToken
-
Um token de paginação para buscar a próxima página de versões de bot. Se a resposta a essa chamada for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de versões, especifique o token de paginação na próxima solicitação.
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da Resposta
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 Resposta
Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- bots
-
Uma matriz de objetos
BotMetadata
, um para cada versão numerada do bot mais um para a versão$LATEST
.Tipo: matriz de objetos BotMetadata
- nextToken
-
Um token de paginação para buscar a próxima página de versões de bot. Se a resposta a essa chamada for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de versões, especifique o token de paginação na próxima solicitação.
Tipo: String
Erros
- BadRequestException
-
A solicitação não está bem formada. Por exemplo, um valor é inválido ou um campo obrigatório está faltando. Verifique os valores dos campos e tente novamente.
Código de Status HTTP: 400
- InternalFailureException
-
Ocorreu um erro interno do Amazon Lex. Tente sua solicitação novamente.
Código de Status HTTP: 500
- LimitExceededException
-
A solicitação excedeu um limite. Tente sua solicitação novamente.
Código de Status HTTP: 429
- NotFoundException
-
O atributo especificado na solicitação não foi encontrado. Verifique o atributo e tente novamente.
Código de Status HTTP: 404
Consulte Também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: