Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Depois de 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 ou os recursos do Amazon Lex V1. Se você estiver usando o Amazon Lex V2, consulte o guia do Amazon Lex V2 em vez disso.
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á.
Cria um alias para a versão especificada do bot ou substitui um alias para o bot especificado. Para alterar a versão do bot para a qual o alias aponta, substitua o alias. Para obter mais informações sobre aliases, consulte Versionamento e aliases.
Essa operação exige permissões para a ação lex:PutBotAlias.
Sintaxe da Solicitação
PUT /bots/botName/aliases/name HTTP/1.1
Content-type: application/json
{
"botVersion": "string",
"checksum": "string",
"conversationLogs": {
"iamRoleArn": "string",
"logSettings": [
{
"destination": "string",
"kmsKeyArn": "string",
"logType": "string",
"resourceArn": "string"
}
]
},
"description": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
}Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- botVersion
-
A versão do bot.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
\$LATEST|[0-9]+Exigido: Sim
- checksum
-
Identifica uma revisão específica da versão
$LATEST.Ao criar um novo alias de bot, deixe o campo
checksumem branco. Se você especificar uma soma de verificação, obterá uma exceçãoBadRequestException.Quando quiser atualizar um alias de bot, defina o campo
checksumcomo a soma de verificação da revisão mais recente da versão$LATEST. Se você não especificar o campochecksumou se a soma de verificação não corresponder à versão$LATEST, você receberá uma exceçãoPreconditionFailedException.Tipo: String
Obrigatório: Não
- conversationLogs
-
Configurações para logs de conversas para o alias.
Tipo: objeto ConversationLogsRequest
Obrigatório: não
- description
-
Uma descrição do alias.
Tipo: String
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.
Obrigatório: não
-
Uma lista de tags a serem adicionadas ao alias de bot. Você só pode adicionar tags ao criar um alias de bot; não pode usar a operação
PutBotAliaspara atualizar as tags em um alias de bot. Para atualizar tags, use a operaçãoTagResource.Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: não
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"botName": "string",
"botVersion": "string",
"checksum": "string",
"conversationLogs": {
"iamRoleArn": "string",
"logSettings": [
{
"destination": "string",
"kmsKeyArn": "string",
"logType": "string",
"resourceArn": "string",
"resourcePrefix": "string"
}
]
},
"createdDate": number,
"description": "string",
"lastUpdatedDate": number,
"name": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- botName
-
O nome do bot para o qual o alias aponta.
Tipo: String
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.
Padrão:
^([A-Za-z]_?)+$ - botVersion
-
A versão do bot para o qual o alias aponta.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
\$LATEST|[0-9]+ - checksum
-
A soma de verificação para a versão atual do alias.
Tipo: String
- conversationLogs
-
As configurações que determinam como o Amazon Lex usa logs de conversa para o alias.
Tipo: objeto ConversationLogsResponse
- createdDate
-
A data em que o alias do bot foi criado.
Tipo: carimbo de data/hora
- description
-
Uma descrição do alias.
Tipo: String
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.
- lastUpdatedDate
-
A data em que o alias do bot foi atualizado. Quando você cria um recurso, a data de criação e a data da última atualização são as mesmas.
Tipo: carimbo de data/hora
- name
-
O nome do alias.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.
Padrão:
^([A-Za-z]_?)+$ -
Uma lista de tags associadas a um bot.
Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
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
- ConflictException
-
Houve um conflito ao processar a solicitação. Tente sua solicitação novamente.
Código de Status HTTP: 409
- 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
- PreconditionFailedException
-
A soma de verificação do recurso que você está tentando alterar não corresponde à soma de verificação na solicitação. Verifique a soma de verificação e tente novamente.
Código de status HTTP: 412
Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
