GetBotVersions - Amazon Lex V1

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: