Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 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á.

# Referência da API
<a name="API_Reference"></a>

Esta seção fornece a documentação das operações de API do Amazon Lex. Para obter uma lista de regiões da AWS onde o Amazon Lex está disponível, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#lex_region) na *Referência geral do Amazon Web Services*.

**Tópicos**
+ [Ações](API_Operations.md)
+ [Tipos de dados](API_Types.md)

# Ações
<a name="API_Operations"></a>

As seguintes ações são compatíveis com o Serviço de criação de modelos do Amazon Lex:
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

As seguintes ações são compatíveis com o Serviço de runtime do Amazon Lex:
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# Serviço de criação de modelos do Amazon Lex
<a name="API_Operations_Amazon_Lex_Model_Building_Service"></a>

As seguintes ações são compatíveis com o Serviço de criação de modelos do Amazon Lex:
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

# CreateBotVersion
<a name="API_CreateBotVersion"></a>

Cria uma nova versão do bot com base na versão do `$LATEST`. Se a versão `$LATEST` deste recurso não tiver sido alterada desde que você criou a última versão, o Amazon Lex não criará uma nova versão e retorna a última versão criada. Ele retorna a última versão criada.

**nota**  
Você pode atualizar apenas a versão `$LATEST` do bot. Você não pode atualizar as versões numeradas que você cria com a operação `CreateBotVersion`.

 Quando você cria a primeira versão de um bot, o Amazon Lex define essa versão como 1. As versões subsequentes são incrementadas em 1. Para obter mais informações, consulte [Versionamento](versioning-aliases.md#versioning-intro). 

 Essa operação exige permissão para a ação `lex:CreateBotVersion`. 

## Sintaxe da Solicitação
<a name="API_CreateBotVersion_RequestSyntax"></a>

```
POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Parâmetros da Solicitação de URI
<a name="API_CreateBotVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
O nome do bot do qual você deseja criar uma nova versão. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_CreateBotVersion_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Identifica uma revisão específica da versão `$LATEST` do bot. Se você especificar uma soma de verificação e a versão `$LATEST` do bot tiver uma soma de verificação diferente, uma exceção `PreconditionFailedException` será retornada e o Amazon Lex não publicará uma nova versão. Se você não especificar uma soma de verificação, o Amazon Lex publicará a versão `$LATEST`.  
Tipo: String  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}
```

## Elementos de resposta
<a name="API_CreateBotVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
A mensagem que o Amazon Lex usa para cancelar uma conversa. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
Soma de verificação que identifica a versão do bot que foi criado.  
Tipo: string

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Para cada bot do Amazon Lex criado com o Serviço de criação de modelo do Amazon Lex, você deve especificar se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à Lei de Proteção à Privacidade Online Infantil (COPPA), especificando `true` ou `false` no `childDirected` campo. Ao especificar `true` no campo `childDirected`, você confirma que seu uso do Amazon Lex **está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Ao especificar `false` no campo `childDirected`, você confirma que seu uso do Amazon Lex **não está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Você não pode especificar um valor padrão para o campo `childDirected` que não reflita com precisão se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA.  
Se o uso do Amazon Lex estiver relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos, você deverá obter qualquer consentimento parental verificável exigido pela COPPA. Para obter informações sobre o uso do Amazon Lex em conexão com sites, programas ou outros aplicativos direcionados, total ou parcialmente, a crianças menores de 13 anos, consulte as [perguntas frequentes do Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: booliano

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
A mensagem que o Amazon Lex usa quando não entende a solicitação do usuário. Para obter mais informações, consulte [PutBot](API_PutBot.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
A data em que a versão do bot foi criada.  
Tipo: Timestamp

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
Uma descrição do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Indica se as declarações inseridas pelo usuário devem ser enviadas ao Amazon Comprehend para análise de sentimento.  
Tipo: booliano

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
Indica se o bot usa melhorias de precisão. `true` indica que o bot está usando as melhorias, caso contrário, é `false`.  
Tipo: booliano

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha na criação do bot.  
Tipo: string

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
O tempo máximo em segundos que o Amazon Lex retém os dados coletados em uma conversa. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: inteiro  
Faixa válida: valor mínimo de 60. Valor máximo de 86.400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
Uma matriz de objetos `Intent`. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
A data em que a versão `$LATEST` deste bot foi atualizada.   
Tipo: Timestamp

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Especifica a localidade de destino deste bot.   
Tipo: string  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [name](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-name"></a>
O nome do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Ao enviar uma solicitação para criar ou atualizar um bot, o Amazon Lex define o elemento de resposta `status` como `BUILDING`. Depois que o Amazon Lex cria o bot, ele define `status` como `READY`. Se o Amazon Lex não puder criar o bot, ele define `status` como `FAILED`. O Amazon Lex retorna o motivo da falha no elemento de resposta `failureReason`.   
Tipo: string  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
A versão do bot.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
O ID de voz do Amazon Polly que o Amazon Lex usa para interações de voz com o usuário.  
Tipo: string

## Erros
<a name="API_CreateBotVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** 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
<a name="API_CreateBotVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion) 

# CreateIntentVersion
<a name="API_CreateIntentVersion"></a>

Cria uma nova versão de uma intenção com base na versão `$LATEST` da intenção. Se a versão `$LATEST` desta intenção não tiver sido alterada desde que você a criou, o Amazon Lex não criará uma nova versão. Ele retorna a última versão criada.

**nota**  
Você pode atualizar apenas a versão `$LATEST` da intenção. Você não pode atualizar as versões numeradas que você cria com a operação `CreateIntentVersion`.

 Quando você cria uma versão de uma intenção, o Amazon Lex define a versão como 1. As versões subsequentes são incrementadas em 1. Para obter mais informações, consulte [Versionamento](versioning-aliases.md#versioning-intro). 

Essa operação exige permissões para executar a ação `lex:CreateIntentVersion`. 

## Sintaxe da Solicitação
<a name="API_CreateIntentVersion_RequestSyntax"></a>

```
POST /intents/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Parâmetros da Solicitação de URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
O nome da intenção da qual você deseja criar uma nova versão. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_CreateIntentVersion_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Soma de verificação da versão `$LATEST` da intenção que deve ser usada para criar a nova versão. Se você especificar uma soma de verificação e a versão `$LATEST` da intenção tiver uma soma de verificação diferente, o Amazon Lex retornará uma exceção `PreconditionFailedException` e não publicará uma nova versão. Se você não especificar uma soma de verificação, o Amazon Lex publicará a versão `$LATEST`.  
Tipo: String  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Elementos de resposta
<a name="API_CreateIntentVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Soma de verificação da versão de intenção criada.  
Tipo: String

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Depois que a função do Lambda especificada no campo `fulfillmentActivity` cumpre a intenção, o Amazon Lex transmite essa declaração ao usuário.   
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Se definido, o prompt que o Amazon Lex usa para confirmar a intenção do usuário antes de atendê-la.   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
A data em que a intenção foi criada.  
Tipo: Timestamp

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Uma descrição da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Se definido, o Amazon Lex invoca essa função do Lambda para cada entrada do usuário.  
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Se definido, o Amazon Lex usa esse prompt para solicitar atividades adicionais do usuário depois que a intenção for atendida.   
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Descreve como a intenção é atendida.   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Uma matriz de objetos `InputContext` que lista os contextos que devem estar ativos para que o Amazon Lex escolha a intenção em uma conversa com o usuário.  
Tipo: matriz de [InputContext](API_InputContext.md) objetos  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informações de configuração, se houver, para conectar um índice do Amazon Kendra com a intenção `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
A data em que a intenção foi atualizada.   
Tipo: Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
O nome da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Uma matriz de objetos `OutputContext` que lista os contextos que a intenção ativa quando a intenção é atendida.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Um identificador exclusivo de uma intenção integrada.  
Tipo: string

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Quando o usuário responde “não” à pergunta definida em `confirmationPrompt`, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Uma matriz de amostra de declarações configurada para a intenção.   
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 1.500 itens.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Uma variedade de tipos de slots que define as informações necessárias para atender a intenção.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
O número da versão atribuída à nova versão da intenção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_CreateIntentVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** 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
<a name="API_CreateIntentVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion) 

# CreateSlotTypeVersion
<a name="API_CreateSlotTypeVersion"></a>

Cria uma nova versão com base na versão `$LATEST` do tipo de slot especificado. Se a versão `$LATEST` deste recurso não tiver sido alterada desde que você criou a última versão, o Amazon Lex não criará uma nova versão e retorna a última versão criada. Ele retorna a última versão criada. 

**nota**  
Você pode atualizar apenas a versão `$LATEST` de um tipo de slot. Não é possível atualizar as versões numeradas que você cria com a operação `CreateSlotTypeVersion`.

Quando você cria uma versão de um tipo de slot, o Amazon Lex define a versão como 1. As versões subsequentes são incrementadas em 1. Para obter mais informações, consulte [Versionamento](versioning-aliases.md#versioning-intro). 

Essa operação exige permissões para a ação `lex:CreateSlotTypeVersion`.

## Sintaxe da Solicitação
<a name="API_CreateSlotTypeVersion_RequestSyntax"></a>

```
POST /slottypes/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Parâmetros da Solicitação de URI
<a name="API_CreateSlotTypeVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-uri-name"></a>
O nome do tipo de slot do qual você deseja criar uma nova versão. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_CreateSlotTypeVersion_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [checksum](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-checksum"></a>
Soma de verificação da versão `$LATEST` do tipo de slot que você deseja publicar. Se você especificar uma soma de verificação e a versão `$LATEST` da intenção tiver uma soma de verificação diferente, o Amazon Lex retornará uma exceção `PreconditionFailedException` e não publicará a nova versão. Se você não especificar uma soma de verificação, o Amazon Lex publicará a versão `$LATEST`.  
Tipo: String  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Elementos de resposta
<a name="API_CreateSlotTypeVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [checksum](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-checksum"></a>
Soma de verificação da versão `$LATEST` do tipo de slot.  
Tipo: String

 ** [createdDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-createdDate"></a>
A data em que o tipo de slot foi criado.  
Tipo: Timestamp

 ** [description](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-description"></a>
Uma descrição do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [enumerationValues](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-enumerationValues"></a>
Uma lista de objetos `EnumerationValue` que define os valores que o tipo de slot pode ter.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10.000 itens.

 ** [lastUpdatedDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-lastUpdatedDate"></a>
A data em que o tipo de slot foi atualizado. Quando você cria um recurso, a data de criação e a data da última atualização são as mesmas.  
Tipo: Timestamp

 ** [name](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-name"></a>
O nome do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-parentSlotTypeSignature"></a>
O tipo de slot integrado usado como pai do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-slotTypeConfigurations"></a>
Informações de configuração que estendem o tipo de slot integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [valueSelectionStrategy](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-valueSelectionStrategy"></a>
A estratégia que o Amazon Lex usa para determinar o valor de slot. Para obter mais informações, consulte [PutSlotType](API_PutSlotType.md).  
Tipo: String  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-version"></a>
A versão atribuída à nova versão do tipo de slot.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_CreateSlotTypeVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** 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
<a name="API_CreateSlotTypeVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateSlotTypeVersion) 

# DeleteBot
<a name="API_DeleteBot"></a>

Exclui todas as versões do bot, incluindo a versão `$LATEST`. Para excluir uma versão específica do bot, use a operação [DeleteBotVersion](API_DeleteBotVersion.md). A operação `DeleteBot` não remove imediatamente o esquema do bot. Em vez disso, ele é marcado para exclusão e removido posteriormente.

O Amazon Lex armazena declarações indefinidamente para melhorar a capacidade do seu bot de responder às entradas do usuário. Essas declarações não são removidas quando o bot é excluído. Para remover as declarações, use a operação [DeleteUtterances](API_DeleteUtterances.md).

Se um bot tiver um alias, você não conseguirá excluí-lo. Em vez disso, a operação `DeleteBot` retorna uma exceção `ResourceInUseException` que inclui uma referência ao alias que se refere ao bot. Para remover a referência ao bot, exclua o alias. Se você receber a mesma exceção novamente, exclua o alias de referência até que a operação `DeleteBot` seja bem-sucedida.

Essa operação exige permissões para a ação `lex:DeleteBot`.

## Sintaxe da Solicitação
<a name="API_DeleteBot_RequestSyntax"></a>

```
DELETE /bots/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteBot_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteBot_RequestSyntax) **   <a name="lex-DeleteBot-request-uri-name"></a>
O nome do bot. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteBot_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteBot_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteBot_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteBot_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteBot_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBot) 

# DeleteBotAlias
<a name="API_DeleteBotAlias"></a>

Exclui um alias de um bot especificado. 

Não é possível excluir um alias usado na associação entre um bot e um canal de mensagens. Se um alias for usado em uma associação de canal, a operação `DeleteBot` retornará uma exceção `ResourceInUseException` que inclui uma referência à associação de canal referente ao bot. Você pode remover a referência ao alias excluindo a associação do canal. Se você receber a mesma exceção novamente, exclua a associação de referência até que a operação `DeleteBotAlias` seja bem-sucedida.

## Sintaxe da Solicitação
<a name="API_DeleteBotAlias_RequestSyntax"></a>

```
DELETE /bots/botName/aliases/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteBotAlias_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botName](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-botName"></a>
O nome do bot para o qual o alias aponta.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-name"></a>
O nome do alias a ser excluído. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteBotAlias_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteBotAlias_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteBotAlias_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteBotAlias_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotAlias) 

# DeleteBotChannelAssociation
<a name="API_DeleteBotChannelAssociation"></a>

Exclui a associação entre um bot do Amazon Lex e uma plataforma de mensagens.

Essa operação exige permissão para a ação `lex:DeleteBotChannelAssociation`.

## Sintaxe da Solicitação
<a name="API_DeleteBotChannelAssociation_RequestSyntax"></a>

```
DELETE /bots/botName/aliases/aliasName/channels/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteBotChannelAssociation_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [aliasName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [botName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botName"></a>
O nome do bot do Amazon Lex.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-name"></a>
O nome da associação. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteBotChannelAssociation_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteBotChannelAssociation_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteBotChannelAssociation_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_DeleteBotChannelAssociation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 

# DeleteBotVersion
<a name="API_DeleteBotVersion"></a>

Exclui uma versão específica de um bot. Para excluir todas as versão de um bot, use a operação [DeleteBot](API_DeleteBot.md). 

Essa operação exige permissões para a ação `lex:DeleteBotVersion`.

## Sintaxe da Solicitação
<a name="API_DeleteBotVersion_RequestSyntax"></a>

```
DELETE /bots/name/versions/version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteBotVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-name"></a>
O nome do bot.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [version](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-version"></a>
A versão do bot a excluir. Você não pode excluir a versão `$LATEST` do bot. Para excluir a versão `$LATEST`, use a operação [DeleteBot](API_DeleteBot.md).  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteBotVersion_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteBotVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteBotVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteBotVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotVersion) 

# DeleteIntent
<a name="API_DeleteIntent"></a>

Exclui todas as versões da intenção, incluindo a versão `$LATEST`. Para excluir uma versão específica da intenção, use a operação [DeleteIntentVersion](API_DeleteIntentVersion.md).

 Você só pode excluir uma versão de uma intenção se ela não for referenciada. Para excluir uma intenção mencionada em um ou mais bots (consulte[Amazon Lex: como funciona](how-it-works.md)), primeiro você deve remover essas referências. 

**nota**  
 Se você receber a exceção `ResourceInUseException`, ela fornecerá um exemplo de referência que mostra onde a intenção é referenciada. Para remover a referência à intenção, atualize o bot ou exclua-o. Se você receber a mesma exceção ao tentar excluir a intenção novamente, repita até que a intenção não tenha referências e a chamada para `DeleteIntent` seja bem-sucedida. 

 Essa operação exige permissão para a ação `lex:DeleteIntent`. 

## Sintaxe da Solicitação
<a name="API_DeleteIntent_RequestSyntax"></a>

```
DELETE /intents/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteIntent_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteIntent_RequestSyntax) **   <a name="lex-DeleteIntent-request-uri-name"></a>
O nome da intenção. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteIntent_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteIntent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteIntent_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteIntent_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteIntent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntent) 

# DeleteIntentVersion
<a name="API_DeleteIntentVersion"></a>

Exclui uma versão específica de uma intenção. Para excluir todas as versões de uma intenção, use a operação [DeleteIntent](API_DeleteIntent.md). 

Essa operação exige permissões para a ação `lex:DeleteIntentVersion`.

## Sintaxe da Solicitação
<a name="API_DeleteIntentVersion_RequestSyntax"></a>

```
DELETE /intents/name/versions/version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteIntentVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-name"></a>
O nome da intenção.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [version](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-version"></a>
A versão da intenção a ser excluída. Você não pode excluir a versão `$LATEST` da intenção. Para excluir a versão `$LATEST`, use a operação [DeleteIntent](API_DeleteIntent.md).  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteIntentVersion_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteIntentVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteIntentVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteIntentVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntentVersion) 

# DeleteSlotType
<a name="API_DeleteSlotType"></a>

Exclui todas as versões do tipo de slot, incluindo a versão `$LATEST`. Para excluir uma versão específica do tipo de slot, use a operação [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md).

 Você só pode excluir uma versão de um tipo de slot se ela não for referenciada. Para excluir um tipo de slot mencionado em uma ou mais intenções, primeiro você deve remover essas referências. 

**nota**  
 Se você receber a exceção `ResourceInUseException`, ela fornecerá um exemplo de referência que mostra a intenção onde o tipo de slot é referenciado. Para remover a referência ao tipo de slot, atualize a intenção ou exclua-o. Se você receber a mesma exceção ao tentar excluir o tipo de slot novamente, repita até que o tipo de slot não tenha referências e a chamada para `DeleteSlotType` seja bem-sucedida. 

Essa operação exige permissão para a ação `lex:DeleteSlotType`.

## Sintaxe da Solicitação
<a name="API_DeleteSlotType_RequestSyntax"></a>

```
DELETE /slottypes/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteSlotType_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteSlotType_RequestSyntax) **   <a name="lex-DeleteSlotType-request-uri-name"></a>
O nome do tipo de slot. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteSlotType_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteSlotType_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteSlotType_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteSlotType_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteSlotType_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotType) 

# DeleteSlotTypeVersion
<a name="API_DeleteSlotTypeVersion"></a>

Exclui uma versão específica de um tipo de slot. Para excluir todas as versões de um tipo de slot, use a operação [DeleteSlotType](API_DeleteSlotType.md). 

Essa operação exige permissões para a ação `lex:DeleteSlotTypeVersion`.

## Sintaxe da Solicitação
<a name="API_DeleteSlotTypeVersion_RequestSyntax"></a>

```
DELETE /slottypes/name/version/version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteSlotTypeVersion_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-name"></a>
O nome do tipo de slot.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [version](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-version"></a>
A versão do tipo de slot a ser excluída. Você não pode excluir a versão `$LATEST` do tipo de slot. Para excluir a versão `$LATEST`, use a operação [DeleteSlotType](API_DeleteSlotType.md).  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteSlotTypeVersion_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteSlotTypeVersion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteSlotTypeVersion_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

 ** ResourceInUseException **   
O recurso que você está tentando excluir é referenciado por outro recurso. Use essas informações para remover referências ao recurso que você está tentando excluir.  
O corpo da exceção contém um objeto JSON que descreve o recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteSlotTypeVersion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 

# DeleteUtterances
<a name="API_DeleteUtterances"></a>

Exclui as declarações armazenadas.

O Amazon Lex armazena as declarações que os usuários enviam para o seu bot. As declarações são armazenadas por 15 dias para uso com a operação [GetUtterancesView](API_GetUtterancesView.md) e, em seguida, armazenadas indefinidamente para uso na melhoria da capacidade do seu bot de responder às entradas do usuário.

Use a operação `DeleteUtterances` para excluir declarações armazenadas por um usuário específico. Quando você usa a operação `DeleteUtterances`, as declarações armazenadas para melhorar a capacidade do seu bot de responder às entradas do usuário são excluídas imediatamente. As declarações armazenadas para uso com a operação `GetUtterancesView` são excluídas após 15 dias.

Essa operação exige permissões para a ação `lex:DeleteUtterances`.

## Sintaxe da Solicitação
<a name="API_DeleteUtterances_RequestSyntax"></a>

```
DELETE /bots/botName/utterances/userId HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_DeleteUtterances_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
O nome do bot que armazenou as declarações.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 Um identificador exclusivo para o usuário que fez as declarações. Esse é o ID do usuário que foi enviado na solicitação de [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)operação [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)ou que continha o enunciado.  
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteUtterances_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_DeleteUtterances_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_DeleteUtterances_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_DeleteUtterances_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances) 

# GetBot
<a name="API_GetBot"></a>

Retorna informações de metadados para um bot específico. Você deve fornecer o nome do bot e a versão ou o alias do bot. 

 Essa operação exige permissões para a ação `lex:GetBot`. 

## Sintaxe da Solicitação
<a name="API_GetBot_RequestSyntax"></a>

```
GET /bots/name/versions/versionoralias HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBot_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
O nome do bot. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [versionoralias](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
A versão do alias do bot.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetBot_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "nluIntentConfidenceThreshold": number,
   "status": "string",
   "version": "string",
   "voiceId": "string"
}
```

## Elementos de resposta
<a name="API_GetBot_ResponseElements"></a>

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.

 ** [abortStatement](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-abortStatement"></a>
A mensagem que o Amazon Lex retorna quando o usuário decide encerrar a conversa sem concluí-la. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-checksum"></a>
Soma de verificação do bot usada para identificar uma revisão específica da versão `$LATEST` do bot.  
Tipo: String

 ** [childDirected](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-childDirected"></a>
Para cada bot do Amazon Lex criado com o Serviço de criação de modelo do Amazon Lex, você deve especificar se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à Lei de Proteção à Privacidade Online Infantil (COPPA), especificando `true` ou `false` no `childDirected` campo. Ao especificar `true` no campo `childDirected`, você confirma que seu uso do Amazon Lex **está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Ao especificar `false` no campo `childDirected`, você confirma que seu uso do Amazon Lex **não está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Você não pode especificar um valor padrão para o campo `childDirected` que não reflita com precisão se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA.  
Se o uso do Amazon Lex estiver relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos, você deverá obter qualquer consentimento parental verificável exigido pela COPPA. Para obter informações sobre o uso do Amazon Lex em conexão com sites, programas ou outros aplicativos direcionados, total ou parcialmente, a crianças menores de 13 anos, consulte as [perguntas frequentes do Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: booliano

 ** [clarificationPrompt](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
A mensagem que o Amazon Lex usa quando não entende a solicitação do usuário. Para obter mais informações, consulte [PutBot](API_PutBot.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-createdDate"></a>
A data e a hora em que o bot foi criado.  
Tipo: Timestamp

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
Uma descrição do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
Indica se as declarações inseridas pelo usuário devem ser enviadas ao Amazon Comprehend para análise de sentimento.  
Tipo: booliano

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
Indica se o bot usa melhorias de precisão. `true` indica que o bot está usando as melhorias, caso contrário, é `false`.  
Tipo: booliano

 ** [failureReason](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex explica por que não conseguiu criar o bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
O tempo máximo em segundos que o Amazon Lex retém os dados coletados em uma conversa. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: inteiro  
Faixa válida: valor mínimo de 60. Valor máximo de 86.400.

 ** [intents](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-intents"></a>
Uma matriz de objetos `intent`. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-lastUpdatedDate"></a>
A data em que o 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: Timestamp

 ** [locale](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-locale"></a>
 O local de destino deste bot.   
Tipo: String  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [name](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-name"></a>
O nome do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
A pontuação que determina onde o Amazon Lex insere o`AMAZON.FallbackIntent`,`AMAZON.KendraSearchIntent`, ou ambos ao retornar intenções alternativas em uma resposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html). [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) `AMAZON.FallbackIntent`será inserido se a pontuação de confiança para todas as intenções estiver abaixo desse valor. `AMAZON.KendraSearchIntent`só é inserido se estiver configurado para o bot.  
Tipo: duplo  
Intervalo válido: valor mínimo de 0. Valor máximo de 1.

 ** [status](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-status"></a>
O status do bot.   
Quando o status é `BUILDING`, o Amazon Lex está criando o bot para teste e uso.  
Se o status do bot for `READY_BASIC_TESTING`, você poderá testar o bot usando as declarações exatas especificadas nas intenções do bot. Quando o bot estiver pronto para o teste completo ou para ser executado, o status será `READY`.  
Se houve um problema com a criação do bot, o status será `FAILED` e o campo `failureReason` explica por que o bot não foi criado.  
Se o bot tiver sido salvo, mas não criado, o status será `NOT_BUILT`.  
Tipo: string  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-version"></a>
A versão do bot. Para um novo bot, a versão é sempre `$LATEST`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-voiceId"></a>
O ID de voz do Amazon Polly que o Amazon Lex usa para a interação de voz com o usuário. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: string

## Erros
<a name="API_GetBot_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBot_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot) 

# GetBotAlias
<a name="API_GetBotAlias"></a>

Retorna informações sobre um alias de bot do Amazon Lex. Para obter mais informações sobre aliases, consulte [Versionamento e aliases](versioning-aliases.md).

Essa operação exige permissões para a ação `lex:GetBotAlias`.

## Sintaxe da Solicitação
<a name="API_GetBotAlias_RequestSyntax"></a>

```
GET /bots/botName/aliases/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBotAlias_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botName](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-botName"></a>
O nome do bot.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-name"></a>
O nome do alias do bot. O nome diferencia maiúsculas e minúsculas.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetBotAlias_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotAlias_ResponseSyntax"></a>

```
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"
}
```

## Elementos de resposta
<a name="API_GetBotAlias_ResponseElements"></a>

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](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botName"></a>
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](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botVersion"></a>
A versão do bot para o qual o alias aponta.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [checksum](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-checksum"></a>
Soma de verificação do alias do bot.  
Tipo: string

 ** [conversationLogs](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-conversationLogs"></a>
As configurações que determinam como o Amazon Lex usa logs de conversa para o alias.  
Tipo: objeto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-createdDate"></a>
A data em que o alias do bot foi criado.  
Tipo: Timestamp

 ** [description](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-description"></a>
Uma descrição do alias do bot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [lastUpdatedDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-lastUpdatedDate"></a>
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: Timestamp

 ** [name](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-name"></a>
O nome do alias do bot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

## Erros
<a name="API_GetBotAlias_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBotAlias_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAlias) 

# GetBotAliases
<a name="API_GetBotAliases"></a>

Retorna uma lista de alias para um bot específico do Amazon Lex.

Essa operação exige permissões para a ação `lex:GetBotAliases`.

## Sintaxe da Solicitação
<a name="API_GetBotAliases_RequestSyntax"></a>

```
GET /bots/botName/aliases/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBotAliases_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botName](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-botName"></a>
O nome do bot.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [maxResults](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-maxResults"></a>
O número máximo de aliases a ser retornado na resposta. O padrão é 50.   
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nameContains"></a>
Substring para corresponder aos nomes de alias do bot. Um alias será retornado se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nextToken"></a>
Um token de paginação para buscar a próxima página de aliases. 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 aliases, especifique o token de paginação na próxima solicitação. 

## Corpo da Solicitação
<a name="API_GetBotAliases_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotAliases_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BotAliases": [ 
      { 
         "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"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetBotAliases_ResponseElements"></a>

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.

 ** [BotAliases](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-BotAliases"></a>
Uma matriz de objetos `BotAliasMetadata`, cada um descrevendo um alias de bot.  
Tipo: matriz de objetos [BotAliasMetadata](API_BotAliasMetadata.md)

 ** [nextToken](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-nextToken"></a>
Um token de paginação para buscar a próxima página de aliases. 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 aliases, especifique o token de paginação na próxima solicitação.   
Tipo: string

## Erros
<a name="API_GetBotAliases_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetBotAliases_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAliases) 

# GetBotChannelAssociation
<a name="API_GetBotChannelAssociation"></a>

Retorna informações sobre a associação entre um bot do Amazon Lex e uma plataforma de mensagens.

Essa operação exige permissões para a ação `lex:GetBotChannelAssociation`.

## Sintaxe da Solicitação
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/name HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
O nome do bot do Amazon Lex.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
O nome da associação entre o bot e o canal. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetBotChannelAssociation_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botConfiguration": { 
      "string" : "string" 
   },
   "botName": "string",
   "createdDate": number,
   "description": "string",
   "failureReason": "string",
   "name": "string",
   "status": "string",
   "type": "string"
}
```

## Elementos de resposta
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

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.

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
Fornece as informações que a plataforma de mensagens precisa para se comunicar com o bot do Amazon Lex.  
Tipo: mapa de string para string  
Entradas do mapa: número máximo de 10 itens.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
O nome do bot do Amazon Lex.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
A data em que a associação entre o bot e o canal foi criada.  
Tipo: Timestamp

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
A descrição da associação entre o bot e o canal.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha na criação da associação.  
Tipo: string

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
O nome da associação entre o bot e o canal.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
O status do canal do bot.   
+  `CREATED` - O canal foi criado e está pronto para uso.
+  `IN_PROGRESS` - A criação do canal está em andamento.
+  `FAILED` - Houve um erro ao criar o canal. Para obter informações sobre o motivo da falha, consulte o campo `failureReason`.
Tipo: string  
Valores válidos: `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
O tipo da plataforma de mensagens.  
Tipo: string  
Valores válidos: `Facebook | Slack | Twilio-Sms | Kik` 

## Erros
<a name="API_GetBotChannelAssociation_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation) 

# GetBotChannelAssociations
<a name="API_GetBotChannelAssociations"></a>

 Retorna uma lista de todos os canais associados a um bot específico. 

A operação `GetBotChannelAssociations` exige permissões para a ação `lex:GetBotChannelAssociations`.

## Sintaxe da Solicitação
<a name="API_GetBotChannelAssociations_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBotChannelAssociations_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^(-|^([A-Za-z]_?)+$)$`   
Obrigatório: Sim

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
O nome do bot do Amazon Lex na associação.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
O número máximo de associações a ser retornado na resposta. O padrão é 50.   
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
Substring a ser correspondente nos nomes das associações de canais. Uma associação será retornada se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”. Para retornar todas as associações de canais de bots, use um hífen (“-”) como `nameContains` parâmetro.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
Um token de paginação para buscar a próxima página de associações. 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 associações, especifique o token de paginação na próxima solicitação. 

## Corpo da Solicitação
<a name="API_GetBotChannelAssociations_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotChannelAssociations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botChannelAssociations": [ 
      { 
         "botAlias": "string",
         "botConfiguration": { 
            "string" : "string" 
         },
         "botName": "string",
         "createdDate": number,
         "description": "string",
         "failureReason": "string",
         "name": "string",
         "status": "string",
         "type": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetBotChannelAssociations_ResponseElements"></a>

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.

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Uma matriz de objetos, uma para cada associação, que fornece informações sobre o bot do Amazon Lex e sua associação com o canal.   
Tipo: matriz de objetos [BotChannelAssociation](API_BotChannelAssociation.md)

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
Um token de paginação que busca a próxima página de associações. 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 associações, especifique o token de paginação na próxima solicitação.   
Tipo: string

## Erros
<a name="API_GetBotChannelAssociations_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations) 

# GetBots
<a name="API_GetBots"></a>

Retorna as informações do bot da seguinte forma: 
+ Se você fornecer o campo `nameContains`, a resposta incluirá informações sobre a versão `$LATEST` de todos os bots cujo nome contém a string especificada.
+ Se você não especificar o campo `nameContains`, a operação retornará informações sobre a versão `$LATEST` de todos os seus bots.

Essa operação exige permissão para a ação `lex:GetBots`.

## Sintaxe da Solicitação
<a name="API_GetBots_RequestSyntax"></a>

```
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBots_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
O número máximo de bots a ser retornado na resposta retornada pela solicitação. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
Substring para corresponder aos nomes do bot. Um bot será retornado se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de bots. 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 bots, especifique o token de paginação na próxima solicitação. 

## Corpo da Solicitação
<a name="API_GetBots_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBots_ResponseSyntax"></a>

```
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
<a name="API_GetBots_ResponseElements"></a>

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.

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
Uma matriz de objetos `botMetadata`, com uma entrada para cada bot.   
Tipo: matriz de objetos [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
Se a resposta for truncada, ela incluirá um token de paginação que você pode especificar em sua próxima solicitação para buscar a próxima página de bots.   
Tipo: string

## Erros
<a name="API_GetBots_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBots_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots) 

# GetBotVersions
<a name="API_GetBotVersions"></a>

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
<a name="API_GetBotVersions_RequestSyntax"></a>

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

## Parâmetros da Solicitação de URI
<a name="API_GetBotVersions_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-maxResults"></a>
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](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-name"></a>
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]_?)+$`   
Obrigatório: Sim

 ** [nextToken](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-nextToken"></a>
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
<a name="API_GetBotVersions_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBotVersions_ResponseSyntax"></a>

```
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
<a name="API_GetBotVersions_ResponseElements"></a>

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.

 ** [bots](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-bots"></a>
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](API_BotMetadata.md)

 ** [nextToken](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-nextToken"></a>
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
<a name="API_GetBotVersions_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBotVersions_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotVersions) 

# GetBuiltinIntent
<a name="API_GetBuiltinIntent"></a>

Retorna informações sobre uma intenção embutida.

Essa operação exige permissão para a ação `lex:GetBuiltinIntent`.

## Sintaxe da Solicitação
<a name="API_GetBuiltinIntent_RequestSyntax"></a>

```
GET /builtins/intents/signature HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBuiltinIntent_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [signature](#API_GetBuiltinIntent_RequestSyntax) **   <a name="lex-GetBuiltinIntent-request-uri-signature"></a>
O identificador exclusivo de uma intenção integrada. Para encontrar a assinatura de uma intenção, consulte [Intenções integradas padrão](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) no *Alexa Skills Kit*.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetBuiltinIntent_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBuiltinIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "signature": "string",
   "slots": [ 
      { 
         "name": "string"
      }
   ],
   "supportedLocales": [ "string" ]
}
```

## Elementos de resposta
<a name="API_GetBuiltinIntent_ResponseElements"></a>

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.

 ** [signature](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-signature"></a>
O identificador exclusivo de uma intenção integrada.  
Tipo: string

 ** [slots](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-slots"></a>
Uma matriz de objetos `BuiltinIntentSlot`, uma entrada para cada tipo de slot na intenção.  
Tipo: matriz de objetos [BuiltinIntentSlot](API_BuiltinIntentSlot.md)

 ** [supportedLocales](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-supportedLocales"></a>
Uma lista de localidades compatíveis com a intenção.  
Tipo: matriz de strings  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

## Erros
<a name="API_GetBuiltinIntent_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetBuiltinIntent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntent) 

# GetBuiltinIntents
<a name="API_GetBuiltinIntents"></a>

Obtém uma lista de intenções integradas que atendem aos critérios especificados.

Essa operação exige permissão para a ação `lex:GetBuiltinIntents`.

## Sintaxe da Solicitação
<a name="API_GetBuiltinIntents_RequestSyntax"></a>

```
GET /builtins/intents/?locale=locale&maxResults=maxResults&nextToken=nextToken&signatureContains=signatureContains HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBuiltinIntents_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [locale](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-locale"></a>
Uma lista de localidades compatíveis com a intenção.  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [maxResults](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-maxResults"></a>
O número máximo de intenções a serem incluídas na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nextToken](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de intenções. Se a chamada de API for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de intenções, especifique o token de paginação na próxima solicitação.

 ** [signatureContains](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-signatureContains"></a>
Substring para corresponder às assinaturas de intenção integradas. Uma intenção será retornada se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”. Para encontrar a assinatura de uma intenção, consulte [Intenções integradas padrão](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) no *Alexa Skills Kit*.

## Corpo da Solicitação
<a name="API_GetBuiltinIntents_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBuiltinIntents_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "signature": "string",
         "supportedLocales": [ "string" ]
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetBuiltinIntents_ResponseElements"></a>

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.

 ** [intents](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-intents"></a>
Uma matriz de objetos `builtinIntentMetadata`, uma para cada intenção na resposta.  
Tipo: matriz de objetos [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md)

 ** [nextToken](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-nextToken"></a>
Um token de paginação que busca a próxima página de intenções. Se a resposta a essa chamada de API for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de intenções, especifique o token de paginação na próxima solicitação.  
Tipo: string

## Erros
<a name="API_GetBuiltinIntents_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetBuiltinIntents_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntents) 

# GetBuiltinSlotTypes
<a name="API_GetBuiltinSlotTypes"></a>

Obtém uma lista dos tipos de slots integrados que atendem aos critérios especificados.

Para obter uma lista de tipos de slot integrados, consulte [Referência do tipo de slot](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) no *Alexa Skills Kit*.

Essa operação exige permissão para a ação `lex:GetBuiltInSlotTypes`.

## Sintaxe da Solicitação
<a name="API_GetBuiltinSlotTypes_RequestSyntax"></a>

```
GET /builtins/slottypes/?locale=locale&maxResults=maxResults&nextToken=nextToken&signatureContains=signatureContains HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetBuiltinSlotTypes_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [locale](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-locale"></a>
Uma lista de localidades compatíveis pelo tipo de slot.  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [maxResults](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-maxResults"></a>
O número máximo de tipo de slot a serem incluídos na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nextToken](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de tipos de slot. Se a resposta a essa chamada de API for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de tipos de slot, especifique o token de paginação na próxima solicitação.

 ** [signatureContains](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-signatureContains"></a>
Substring para corresponder às assinaturas de tipo de slot integradas. Um tipo de slot será retornado se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”.

## Corpo da Solicitação
<a name="API_GetBuiltinSlotTypes_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetBuiltinSlotTypes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "signature": "string",
         "supportedLocales": [ "string" ]
      }
   ]
}
```

## Elementos de resposta
<a name="API_GetBuiltinSlotTypes_ResponseElements"></a>

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.

 ** [nextToken](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-nextToken"></a>
Se a resposta for truncada, ela incluirá um token de paginação que você pode usar em sua próxima solicitação para buscar a próxima página de tipos de slot.  
Tipo: string

 ** [slotTypes](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-slotTypes"></a>
Uma matriz de objetos `BuiltInSlotTypeMetadata`, uma entrada para cada tipo de slot retornado.  
Tipo: matriz de objetos [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md)

## Erros
<a name="API_GetBuiltinSlotTypes_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetBuiltinSlotTypes_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 

# GetExport
<a name="API_GetExport"></a>

Exporta o conteúdo de um recurso do Amazon Lex em um formato especificado. 

## Sintaxe da Solicitação
<a name="API_GetExport_RequestSyntax"></a>

```
GET /exports/?exportType=exportType&name=name&resourceType=resourceType&version=version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetExport_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [exportType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-exportType"></a>
O formato dos dados exportados.  
Valores válidos: `ALEXA_SKILLS_KIT | LEX`   
Obrigatório: Sim

 ** [name](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-name"></a>
O nome do bot a ser exportado.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 100.  
Padrão: `[a-zA-Z_]+`   
Obrigatório: Sim

 ** [resourceType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-resourceType"></a>
O tipo de recurso a ser exportado.   
Valores válidos: `BOT | INTENT | SLOT_TYPE`   
Obrigatório: Sim

 ** [version](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-version"></a>
A versão do bot a ser exportado.  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.  
Padrão: `[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetExport_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetExport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "exportStatus": "string",
   "exportType": "string",
   "failureReason": "string",
   "name": "string",
   "resourceType": "string",
   "url": "string",
   "version": "string"
}
```

## Elementos de resposta
<a name="API_GetExport_ResponseElements"></a>

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.

 ** [exportStatus](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportStatus"></a>
O status da exportação.   
+  `IN_PROGRESS` - A exportação está em andamento.
+  `READY` - A exportação foi concluída.
+  `FAILED` - A exportação não pôde ser concluída.
Tipo: string  
Valores válidos: `IN_PROGRESS | READY | FAILED` 

 ** [exportType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportType"></a>
O formato dos dados exportados.  
Tipo: string  
Valores válidos: `ALEXA_SKILLS_KIT | LEX` 

 ** [failureReason](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha da exportação do recurso.  
Tipo: string

 ** [name](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-name"></a>
O nome do bot que está sendo exportado.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-resourceType"></a>
O tipo do recurso exportado.  
Tipo: string  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

 ** [url](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-url"></a>
Uma URL pré-assinada do S3 que fornece a localização do recurso exportado. O recurso exportado é um arquivo ZIP que contém o recurso exportado no formato JSON. A estrutura do arquivamento pode mudar. Seu código não deve depender da estrutura de arquivamento.  
Tipo: string

 ** [version](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-version"></a>
A versão do bot que está sendo exportado.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+` 

## Erros
<a name="API_GetExport_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetExport_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetExport) 

# GetImport
<a name="API_GetImport"></a>

Obtém informações sobre um trabalho de importação iniciado com a operação `StartImport`.

## Sintaxe da Solicitação
<a name="API_GetImport_RequestSyntax"></a>

```
GET /imports/importId HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetImport_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [importId](#API_GetImport_RequestSyntax) **   <a name="lex-GetImport-request-uri-importId"></a>
O identificador das informações do trabalho de importação a serem retornadas.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetImport_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetImport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "createdDate": number,
   "failureReason": [ "string" ],
   "importId": "string",
   "importStatus": "string",
   "mergeStrategy": "string",
   "name": "string",
   "resourceType": "string"
}
```

## Elementos de resposta
<a name="API_GetImport_ResponseElements"></a>

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.

 ** [createdDate](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-createdDate"></a>
Um carimbo de data e hora para a data e a hora em que a tarefa de importação foi criada.  
Tipo: Timestamp

 ** [failureReason](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-failureReason"></a>
Uma sequência de caracteres que descreve por que um trabalho de importação não foi concluído.  
Tipo: matriz de strings

 ** [importId](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importId"></a>
O identificador para a tarefa de importação específica.  
Tipo: String

 ** [importStatus](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importStatus"></a>
O status do trabalho de importação. Se o status for `FAILED`, você poderá obter o motivo da falha no campo `failureReason`.  
Tipo: string  
Valores válidos: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-mergeStrategy"></a>
A ação tomada quando houve um conflito entre um recurso existente e um recurso no arquivo de importação.  
Tipo: string  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-name"></a>
O nome dado ao trabalho de importação.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-resourceType"></a>
O tipo do recurso a ser importado.  
Tipo: string  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

## Erros
<a name="API_GetImport_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetImport_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetImport) 

# GetIntent
<a name="API_GetIntent"></a>

 Retorna informações sobre uma intenção. Além do nome da intenção, você deve especificar a versão da intenção. 

 Essa operação exige permissões para executar a ação `lex:GetIntent`. 

## Sintaxe da Solicitação
<a name="API_GetIntent_RequestSyntax"></a>

```
GET /intents/name/versions/version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetIntent_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
O nome da intenção. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
A versão da intenção.  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetIntent_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Elementos de resposta
<a name="API_GetIntent_ResponseElements"></a>

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.

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
A soma de verificação da intenção.  
Tipo: String

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
Depois que a função do Lambda especificada no elemento `fulfillmentActivity` cumpre a intenção, o Amazon Lex transmite essa declaração ao usuário.  
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
Se definido no bot, o prompt que o Amazon Lex usa para confirmar a intenção do usuário antes de atendê-la. Para obter mais informações, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
A data em que a intenção foi criada.  
Tipo: Timestamp

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
Uma descrição da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
Se definido no bot, o Amazon Lex invoca essa função do Lambda para cada entrada do usuário. Para obter mais informações, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
Se definido no bot, o Amazon Lex usa esse prompt para solicitar atividades adicionais do usuário depois que a intenção for atendida. Para obter mais informações, consulte [PutIntent](API_PutIntent.md).  
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
Descreve como a intenção é atendida. Para obter mais informações, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Uma matriz de objetos `InputContext` que lista os contextos que devem estar ativos para que o Amazon Lex escolha a intenção em uma conversa com o usuário.  
Tipo: matriz de [InputContext](API_InputContext.md) objetos  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Informações de configuração, se houver, para conectar um índice do Amazon Kendra com a intenção `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
A data em que a intenção foi atualizada. Quando você cria um recurso, a data de criação e a data da última atualização são as mesmas.   
Tipo: Timestamp

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
O nome da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
Uma matriz de objetos `OutputContext` que lista os contextos que a intenção ativa quando a intenção é atendida.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
Um identificador exclusivo de uma intenção integrada.  
Tipo: string

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
Quando o usuário responde “não” à pergunta definida em `confirmationPrompt`, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
Uma matriz de amostra de declarações configurada para a intenção.  
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 1.500 itens.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
Uma matriz de slots de intenção configurados para a intenção.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
A versão da intenção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_GetIntent_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetIntent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent) 

# GetIntents
<a name="API_GetIntents"></a>

Retorna as informações da intenção da seguinte forma: 
+ Se você especificar o campo `nameContains`, retornará a versão `$LATEST` de todas as intenções que contêm a string especificada.
+  Se você não especificar o campo `nameContains`, a operação retornará informações sobre a versão `$LATEST` de todas as intenções. 

 A operação exige permissões para a ação `lex:GetIntents`. 

## Sintaxe da Solicitação
<a name="API_GetIntents_RequestSyntax"></a>

```
GET /intents/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetIntents_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-maxResults"></a>
O número máximo de intenções a serem incluídas na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nameContains"></a>
Substring para corresponder aos nomes da intenção. Uma intenção será retornada se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de intenções. Se a resposta a essa chamada de API for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de intenções, especifique o token de paginação na próxima solicitação. 

## Corpo da Solicitação
<a name="API_GetIntents_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetIntents_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetIntents_ResponseElements"></a>

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.

 ** [intents](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-intents"></a>
Uma matriz de objetos `Intent`. Para obter mais informações, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-nextToken"></a>
Se a resposta for truncada, ela incluirá um token de paginação que você pode especificar em sua próxima solicitação para buscar a próxima página de intenções.   
Tipo: String

## Erros
<a name="API_GetIntents_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetIntents_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntents) 

# GetIntentVersions
<a name="API_GetIntentVersions"></a>

Obtém informações sobre todas as versões de uma intenção.

A operação `GetIntentVersions` retorna um objeto `IntentMetadata` para cada versão de uma intenção. Por exemplo, se uma intenção tiver três versões numeradas, a operação `GetIntentVersions` retornará quatro objetos `IntentMetadata` na resposta, um para cada versão numerada e um para a versão `$LATEST`. 

A operação `GetIntentVersions` sempre retorna pelo menos uma versão, a versão`$LATEST`.

Essa operação exige permissões para a ação `lex:GetIntentVersions`.

## Sintaxe da Solicitação
<a name="API_GetIntentVersions_RequestSyntax"></a>

```
GET /intents/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetIntentVersions_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-maxResults"></a>
O número máximo de versões de intenção a ser retornado em uma resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [name](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-name"></a>
O nome da intenção para a qual as versões devem ser retornadas.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [nextToken](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-nextToken"></a>
Um token de paginação para buscar a próxima página de versões de intenção. 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
<a name="API_GetIntentVersions_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetIntentVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetIntentVersions_ResponseElements"></a>

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.

 ** [intents](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-intents"></a>
Uma matriz de objetos `IntentMetadata`, um para cada versão numerada da intenção mais um para a versão `$LATEST`.  
Tipo: matriz de objetos [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-nextToken"></a>
Um token de paginação para buscar a próxima página de versões de intenção. 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
<a name="API_GetIntentVersions_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetIntentVersions_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntentVersions) 

# GetMigration
<a name="API_GetMigration"></a>

Fornece detalhes sobre uma migração contínua ou completa de um bot do Amazon Lex V1 para um bot do Amazon Lex V2. Use essa operação para visualizar os alertas e avisos de migração relacionados à migração.

## Sintaxe da Solicitação
<a name="API_GetMigration_RequestSyntax"></a>

```
GET /migrations/migrationId HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetMigration_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
O identificador exclusivo da migração a ser visualizada. O `migrationID` é retornado pela operação [StartMigration](API_StartMigration.md).  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetMigration_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetMigration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "alerts": [ 
      { 
         "details": [ "string" ],
         "message": "string",
         "referenceURLs": [ "string" ],
         "type": "string"
      }
   ],
   "migrationId": "string",
   "migrationStatus": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

## Elementos de resposta
<a name="API_GetMigration_ResponseElements"></a>

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.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Uma lista de alertas e avisos que indicam problemas com a migração do bot do Amazon Lex V1 para o Amazon Lex V2. Você recebe um aviso quando um atributo do Amazon Lex V1 tem uma implementação diferente no Amazon Lex V2.  
Para obter mais informações, consulte [Migração de um bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) no *Guia do desenvolvedor do Amazon Lex V2*.  
Tipo: matriz de objetos [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
O identificador exclusivo da migração. É o mesmo identificador usado ao chamar a operação `GetMigration`.  
Tipo: string  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indica o status da migração. Quando o status é `COMPLETE`, a migração é concluída e o bot está disponível no Amazon Lex V2. Pode haver alertas e avisos que precisem ser resolvidos para concluir a migração.  
Tipo: String  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
A estratégia usada para conduzir a migração.  
+  `CREATE_NEW` - Cria um novo bot do Amazon Lex V2 e migra o bot do Amazon Lex V1 para o novo bot.
+  `UPDATE_EXISTING` - Substitui os metadados existentes do bot do Amazon Lex V2 e a localidade que está sendo migrada. Isso não altera nenhuma outra localidade no bot do Amazon Lex V2. Se a localidade não existir, uma nova localidade será criada no bot do Amazon Lex V2.
Tipo: String  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
A data e hora em que a migração foi iniciada.  
Tipo: Timestamp

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
A localidade do bot do Amazon Lex V1 foi migrada para o Amazon Lex V2.  
Tipo: string  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [v1BotName](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotName"></a>
O nome do bot do Amazon Lex V1 foi migrado para o Amazon Lex V2.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
A versão do bot do Amazon Lex V1 foi migrado para o Amazon Lex V2.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
O identificador exclusivo do bot do Amazon Lex V2 para o qual o Amazon Lex V1 está sendo migrado.  
Tipo: string  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
O perfil do IAM que o Amazon Lex usa para executar a versão do bot do Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Erros
<a name="API_GetMigration_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetMigration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration) 

# GetMigrations
<a name="API_GetMigrations"></a>

Obtém uma lista das migrações entre o Amazon Lex V1 e o Amazon Lex V2.

## Sintaxe da Solicitação
<a name="API_GetMigrations_RequestSyntax"></a>

```
GET /migrations?maxResults=maxResults&migrationStatusEquals=migrationStatusEquals&nextToken=nextToken&sortByAttribute=sortByAttribute&sortByOrder=sortByOrder&v1BotNameContains=v1BotNameContains HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetMigrations_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
O número máximo de migrações a serem retornadas na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
Filtra a lista para conter somente migrações no estado especificado.  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de migrações. Se a resposta a essa operação for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de migrações, especifique o token de paginação na solicitação.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
O campo pelo qual classificar a lista de migrações. Você pode classificar pelo nome do bot do Amazon Lex V1 ou pela data e hora em que a migração foi iniciada.  
Valores válidos: `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
A ordem para classificar a lista.  
Valores válidos: `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
Filtra a lista para conter somente bots cujo nome contenha a string especificada. A string é correspondida em qualquer lugar no nome do bot.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

## Corpo da Solicitação
<a name="API_GetMigrations_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetMigrations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "migrationSummaries": [ 
      { 
         "migrationId": "string",
         "migrationStatus": "string",
         "migrationStrategy": "string",
         "migrationTimestamp": number,
         "v1BotLocale": "string",
         "v1BotName": "string",
         "v1BotVersion": "string",
         "v2BotId": "string",
         "v2BotRole": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de resposta
<a name="API_GetMigrations_ResponseElements"></a>

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.

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Uma matriz de resumos para migrações do Amazon Lex V1 para o Amazon Lex V2. Para ver detalhes da migração, use o `migrationId` do resumo em uma chamada para a operação [GetMigration](API_GetMigration.md).  
Tipo: matriz de objetos [MigrationSummary](API_MigrationSummary.md)

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
Se a resposta for truncada, ela incluirá um token de paginação que você pode especificar em sua próxima solicitação para buscar a próxima página de migrações.  
Tipo: string

## Erros
<a name="API_GetMigrations_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetMigrations_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations) 

# GetSlotType
<a name="API_GetSlotType"></a>

Retorna informações sobre uma versão específica de um tipo de slot. Além de especificar o nome do tipo de slot, você deve especificar a versão do tipo de slot.

Essa operação exige permissões para a ação `lex:GetSlotType`.

## Sintaxe da Solicitação
<a name="API_GetSlotType_RequestSyntax"></a>

```
GET /slottypes/name/versions/version HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetSlotType_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-name"></a>
O nome do tipo de slot. O nome diferencia maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [version](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-version"></a>
A versão do tipo de slot.   
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetSlotType_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetSlotType_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Elementos de resposta
<a name="API_GetSlotType_ResponseElements"></a>

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.

 ** [checksum](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-checksum"></a>
Soma de verificação da versão `$LATEST` do tipo de slot.  
Tipo: String

 ** [createdDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-createdDate"></a>
A data em que o tipo de slot foi criado.  
Tipo: Timestamp

 ** [description](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-description"></a>
Uma descrição do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [enumerationValues](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-enumerationValues"></a>
Uma lista de objetos `EnumerationValue` que define os valores que o tipo de slot pode ter.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10.000 itens.

 ** [lastUpdatedDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-lastUpdatedDate"></a>
A data em que o tipo de slot foi atualizado. Quando você cria um recurso, a data de criação e a data da última atualização são as mesmas.  
Tipo: Timestamp

 ** [name](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-name"></a>
O nome do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-parentSlotTypeSignature"></a>
O tipo de slot integrado usado como pai do tipo de slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-slotTypeConfigurations"></a>
Informações de configuração que estendem o tipo de slot integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [valueSelectionStrategy](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-valueSelectionStrategy"></a>
A estratégia que o Amazon Lex usa para determinar o valor de slot. Para obter mais informações, consulte [PutSlotType](API_PutSlotType.md).  
Tipo: String  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-version"></a>
A versão do tipo de slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_GetSlotType_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetSlotType_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotType) 

# GetSlotTypes
<a name="API_GetSlotTypes"></a>

Retorna as informações do tipo de slot da seguinte forma: 
+ Se você especificar o campo `nameContains`, retornará a versão `$LATEST` de todos os tipos de slot que contêm a string especificada.
+  Se você não especificar o campo `nameContains`, a operação retornará informações sobre a versão `$LATEST` de todos os tipos de slot. 

 A operação exige permissões para a ação `lex:GetSlotTypes`. 

## Sintaxe da Solicitação
<a name="API_GetSlotTypes_RequestSyntax"></a>

```
GET /slottypes/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetSlotTypes_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-maxResults"></a>
O número máximo de tipo de slot a serem incluídos na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nameContains"></a>
Substring para corresponder aos nomes do tipo de slot. Um tipo de slot será retornado se alguma parte de seu nome corresponder ao substring. Por exemplo, “xyz” corresponde a “xyzabc” e “abcxyz”.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nextToken"></a>
Um token de paginação que busca a próxima página de tipos de slot. Se a resposta a essa chamada de API for truncada, o Amazon Lex retornará um token de paginação na resposta. Para buscar a próxima página de tipos de slot, especifique o token de paginação na próxima solicitação.

## Corpo da Solicitação
<a name="API_GetSlotTypes_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetSlotTypes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ]
}
```

## Elementos de resposta
<a name="API_GetSlotTypes_ResponseElements"></a>

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.

 ** [nextToken](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-nextToken"></a>
Se a resposta for truncada, ela incluirá um token de paginação que você pode especificar em sua próxima solicitação para buscar a próxima página de tipos de slot.  
Tipo: String

 ** [slotTypes](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-slotTypes"></a>
Uma matriz de objetos, um para cada tipo de slot, que fornece informações como o nome do tipo de slot, a versão e uma descrição.  
Tipo: matriz de objetos [SlotTypeMetadata](API_SlotTypeMetadata.md)

## Erros
<a name="API_GetSlotTypes_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetSlotTypes_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypes) 

# GetSlotTypeVersions
<a name="API_GetSlotTypeVersions"></a>

Obtém informações sobre todas as versões de um tipo de slot.

A operação `GetSlotTypeVersions` retorna um objeto `SlotTypeMetadata` para cada versão de um tipo de slot. Por exemplo, se um tipo de slot tiver três versões numeradas, a operação `GetSlotTypeVersions` retornará quatro objetos `SlotTypeMetadata` na resposta, um para cada versão numerada e um para a versão `$LATEST`. 

A operação `GetSlotTypeVersions` sempre retorna pelo menos uma versão, a versão`$LATEST`.

Essa operação exige permissões para a ação `lex:GetSlotTypeVersions`.

## Sintaxe da Solicitação
<a name="API_GetSlotTypeVersions_RequestSyntax"></a>

```
GET /slottypes/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetSlotTypeVersions_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [maxResults](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-maxResults"></a>
O número máximo de versões de tipo de slot a serem incluídos na resposta. O padrão é 10.  
Faixa válida: valor mínimo de 1. Valor máximo de 50.

 ** [name](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-name"></a>
O nome do tipo de slot para o qual as versões devem ser retornadas.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [nextToken](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-nextToken"></a>
Um token de paginação para buscar a próxima página de versões de tipo de slot. 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
<a name="API_GetSlotTypeVersions_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetSlotTypeVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ]
}
```

## Elementos de resposta
<a name="API_GetSlotTypeVersions_ResponseElements"></a>

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.

 ** [nextToken](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-nextToken"></a>
Um token de paginação para buscar a próxima página de versões de tipo de slot. 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

 ** [slotTypes](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-slotTypes"></a>
Uma matriz de objetos `SlotTypeMetadata`, um para cada versão numerada do tipo de versão mais um para a versão `$LATEST`.  
Tipo: matriz de objetos [SlotTypeMetadata](API_SlotTypeMetadata.md)

## Erros
<a name="API_GetSlotTypeVersions_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_GetSlotTypeVersions_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypeVersions) 

# GetUtterancesView
<a name="API_GetUtterancesView"></a>

Use a operação `GetUtterancesView` para obter informações sobre as declarações que seus usuários fizeram ao seu bot. Você pode usar essa lista para ajustar as declarações aos quais seu bot responde.

Por exemplo, digamos que você crie um bot para pedir flores. Depois que seus usuários usarem seu bot por um tempo, use a operação `GetUtterancesView` para ver as solicitações que eles fizeram e se foram bem-sucedidas. Você pode descobrir que a declaração “Eu quero flores” não está sendo reconhecida. Você pode adicionar essa declaração à intenção `OrderFlowers` para que seu bot reconheça essa declaração.

Depois de publicar uma nova versão de um bot, você pode obter informações sobre a versão antiga e a nova para poder comparar o desempenho entre as duas versões. 

As estatísticas de declaração são geradas uma vez por dia. Os dados ficam disponíveis nos últimos 15 dias. Você pode solicitar informações de até 5 versões do seu bot em cada solicitação. O Amazon Lex retorna as declarações mais frequentes recebidas pelo bot nos últimos 15 dias. A resposta contém informações sobre um máximo de 100 declarações para cada versão.

As estatísticas de declaração não são geradas nas seguintes condições:
+ O campo `childDirected` foi definido como verdadeiro quando o bot foi criado.
+ Você está usando a ofuscação de slots com um ou mais slots.
+ Você optou por não participar da melhoria do Amazon Lex.

Essa operação exige permissões para a ação `lex:GetUtterancesView`.

## Sintaxe da Solicitação
<a name="API_GetUtterancesView_RequestSyntax"></a>

```
GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetUtterancesView_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botname](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botName"></a>
O nome do bot para o qual as informações da declaração devem ser retornadas.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [botVersions](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botVersions"></a>
Uma matriz de versões de bot para o qual as informações da declaração devem ser retornadas. O limite é de 5 versões por solicitação.  
Membros da Matriz: número mínimo de 1 item. Número máximo de 5 itens.  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Sim

 ** [statusType](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-statusType"></a>
Para retornar declarações que foram reconhecidas e tratadas, use `Detected`. Para retornar declarações que não foram reconhecidas, use `Missed`.  
Valores válidos: `Detected | Missed`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetUtterancesView_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetUtterancesView_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "utterances": [ 
      { 
         "botVersion": "string",
         "utterances": [ 
            { 
               "count": number,
               "distinctUsers": number,
               "firstUtteredDate": number,
               "lastUtteredDate": number,
               "utteranceString": "string"
            }
         ]
      }
   ]
}
```

## Elementos de resposta
<a name="API_GetUtterancesView_ResponseElements"></a>

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](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-botName"></a>
O nome do bot para o qual as informações da declaração foram retornadas.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [utterances](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-utterances"></a>
Uma matriz de objetos [UtteranceList](API_UtteranceList.md), cada um contendo uma lista de [UtteranceData](API_UtteranceData.md) objetos descrevendo as declarações que foram processadas pelo seu bot. A resposta contém no máximo 100 objetos `UtteranceData` para cada versão. O Amazon Lex retorna as declarações mais frequentes recebidas pelo bot nos últimos 15 dias.  
Tipo: matriz de objetos [UtteranceList](API_UtteranceList.md)

## Erros
<a name="API_GetUtterancesView_Errors"></a>

 ** 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

## Consulte também
<a name="API_GetUtterancesView_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Obtém uma lista de tags associadas a um recurso especificado. Somente bots, aliases de bots e canais de bots podem ter tags associadas a eles.

## Sintaxe da Solicitação
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_ListTagsForResource_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="lex-ListTagsForResource-request-uri-resourceArn"></a>
O nome do recurso da Amazon (ARN) do recurso para o qual você deseja a lista de tags.  
Restrições de Tamanho: tamanho mínimo 1. O comprimento máximo é 1011.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_ListTagsForResource_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Elementos de resposta
<a name="API_ListTagsForResource_ResponseElements"></a>

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.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="lex-ListTagsForResource-response-tags"></a>
As tags associadas a um recurso.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

## Erros
<a name="API_ListTagsForResource_Errors"></a>

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ListTagsForResource) 

# PutBot
<a name="API_PutBot"></a>

Cria um bot de conversa do Amazon Lex ou substitui um bot existente. Ao criar ou atualizar um bot, você só precisa especificar um nome, uma localidade e se o bot é direcionado a crianças menores de 13 anos. Você pode usar isso para adicionar intenções posteriormente ou para remover intenções de um bot existente. Quando você cria um bot com o mínimo de informações, o bot é criado ou atualizado, mas o Amazon Lex retorna a resposta `` `FAILED`. Você pode criar o bot depois de adicionar uma ou mais intenções. Para obter mais informações sobre o Amazon Lex, consulte o [Amazon Lex: como funciona](how-it-works.md). 

Se você especificar o nome de um bot existente, os campos na solicitação substituirão os valores existentes na versão `$LATEST` do bot. O Amazon Lex remove todos os campos para os quais você não fornece valores na solicitação, exceto os campos `idleTTLInSeconds` e `privacySettings`, que são definidos com seus valores padrão. Se você não especificar valores para os campos obrigatórios, o Amazon Lex lançará uma exceção.

Essa operação exige permissões para a ação `lex:PutBot`. Para obter mais informações, consulte [Gerenciamento de identidade e acesso para o Amazon Lex](security-iam.md).

## Sintaxe da Solicitação
<a name="API_PutBot_RequestSyntax"></a>

```
PUT /bots/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createVersion": boolean,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "locale": "string",
   "nluIntentConfidenceThreshold": number,
   "processBehavior": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "voiceId": "string"
}
```

## Parâmetros da Solicitação de URI
<a name="API_PutBot_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-uri-name"></a>
O nome do bot. O nome *não* é sensível a maiúsculas e minúsculas.   
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_PutBot_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [abortStatement](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-abortStatement"></a>
Quando o Amazon Lex não consegue entender a entrada do usuário no contexto, ele tenta extrair as informações algumas vezes. Depois disso, o Amazon Lex envia a mensagem definida no `abortStatement` para o usuário e, em seguida, cancela a conversa. Para definir o número de novas tentativas, use o campo `valueElicitationPrompt` para o tipo de slot.   
Por exemplo, em um bot de pedidos de pizza, o Amazon Lex pode perguntar a um usuário “Que tipo de massa você quer?” Se a resposta do usuário não for uma das esperadas (por exemplo, “massa fina”, “prato fundo” etc.), o Amazon Lex tentará obter uma resposta correta mais algumas vezes.   
Por exemplo, em um aplicativo de pedidos de pizza, `OrderPizza` pode ser uma das intenções. Essa intenção pode exigir o slot `CrustType`. Você especifica o campo `valueElicitationPrompt` ao criar o slot `CrustType`.  
Se você tiver definido uma intenção de fallback, a declaração de cancelamento não será enviada ao usuário; em vez disso, a intenção de fallback será usada. Para obter mais informações, consulte [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Tipo: objeto [Statement](API_Statement.md)  
Obrigatório: não

 ** [checksum](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-checksum"></a>
Identifica uma revisão específica da versão `$LATEST`.  
Ao criar um novo bot, deixe o campo `checksum` em branco. Se você especificar uma soma de verificação, obterá uma exceção `BadRequestException`.  
Quando quiser atualizar um bot, defina o campo `checksum` como a soma de verificação da revisão mais recente da versão `$LATEST`. Se você não especificar o campo ` checksum` ou se a soma de verificação não corresponder à versão `$LATEST`, você receberá uma exceção `PreconditionFailedException`.  
Tipo: String  
Obrigatório: não

 ** [childDirected](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-childDirected"></a>
Para cada bot do Amazon Lex criado com o Serviço de criação de modelo do Amazon Lex, você deve especificar se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à Lei de Proteção à Privacidade Online Infantil (COPPA), especificando `true` ou `false` no `childDirected` campo. Ao especificar `true` no campo `childDirected`, você confirma que seu uso do Amazon Lex **está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Ao especificar `false` no campo `childDirected`, você confirma que seu uso do Amazon Lex **não está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Você não pode especificar um valor padrão para o campo `childDirected` que não reflita com precisão se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA.  
Se o uso do Amazon Lex estiver relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos, você deverá obter qualquer consentimento parental verificável exigido pela COPPA. Para obter informações sobre o uso do Amazon Lex em conexão com sites, programas ou outros aplicativos direcionados, total ou parcialmente, a crianças menores de 13 anos, consulte as [perguntas frequentes do Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: booliano  
Obrigatório: Sim

 ** [clarificationPrompt](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-clarificationPrompt"></a>
Quando o Amazon Lex não entende a intenção do usuário, ele usa essa mensagem para obter esclarecimentos. Para especificar quantas vezes o Amazon Lex deve repetir o prompt de esclarecimento, use o campo `maxAttempts`. Se o Amazon Lex ainda não entender, ele enviará a mensagem no campo `abortStatement`.   
Ao criar um prompt de esclarecimento, certifique-se de que ela sugira a resposta correta do usuário. Por exemplo, para um bot que pede pizza e bebidas, você pode criar este prompt de esclarecimento: “O que você gostaria de fazer? Você pode dizer "Pedir uma bebida" ou "Pedir uma pizza".  
Se você tiver definido uma intenção de fallback, ela será invocada se o prompt de esclarecimento for repetido o número de vezes definido no campo `maxAttempts`. Para obter mais informações, consulte [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Se você não definir um prompt de esclarecimento, no runtime, o Amazon Lex retornará uma exceção de 400 solicitações inválidas em três casos:   
+ Prompt de acompanhamento - Quando o usuário responde a um prompt de acompanhamento, mas não fornece uma intenção. Por exemplo, em resposta a um prompt de acompanhamento que diz “Você gostaria de mais alguma coisa hoje?” O usuário diz: “Sim”. Como o Amazon Lex não tem um prompt de esclarecimento para obter uma intenção do usuário, ele retorna uma exceção 400 Solicitação inválida.
+ Função do Lambda - Ao usar uma função do Lambda, você retorna um tipo de diálogo `ElicitIntent`. Como o Amazon Lex não tem um prompt de esclarecimento para obter uma intenção do usuário, ele retorna uma exceção 400 Solicitação inválida.
+ PutSession operação - Ao usar a `PutSession` operação, você envia um tipo `ElicitIntent` de diálogo. Como o Amazon Lex não tem um prompt de esclarecimento para obter uma intenção do usuário, ele retorna uma exceção 400 Solicitação inválida.
Tipo: objeto [Prompt](API_Prompt.md)  
Obrigatório: não

 ** [createVersion](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-createVersion"></a>
Quando configurado para `true`, uma nova versão numerada do bot é criada. Isso é o mesmo que chamar a operação `CreateBotVersion`. Se `createVersion` não for especificado, o valor padrão será `false`.  
Tipo: booliano  
Obrigatório: não

 ** [description](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-description"></a>
Uma descrição do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** [detectSentiment](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-detectSentiment"></a>
Quando configurado para o usuário `true`, as declarações do usuário são enviadas ao Amazon Comprehend para análise de sentimento. Se `detectSentiment` não for especificado, o valor padrão será `false`.  
Tipo: booliano  
Obrigatório: não

 ** [enableModelImprovements](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-enableModelImprovements"></a>
Defina como `true` para permitir o acesso a melhorias na compreensão de linguagem natural.   
Ao definir o parâmetro `enableModelImprovements` como `true`, você pode usar o parâmetro `nluIntentConfidenceThreshold` para configurar pontuações de confiança. Para obter mais informações, consulte [Pontuações de confiança](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
Você só pode definir o parâmetro `enableModelImprovements` em determinadas regiões. Se você definir o parâmetro como `true`, seu bot terá acesso a melhorias de precisão.  
As regiões nas quais você pode definir o parâmetro `enableModelImprovements` como `false` a para a localidade en-US:  
+ Leste dos EUA (Norte da Virgínia) (us-east-1)
+ Oeste dos EUA (Oregon) (us-west-2)
+ Ásia-Pacífico (Sydney) (ap-southeast-2)
+ Europa (Irlanda) (eu-west-1)
Em outras regiões e localidades, o parâmetro `enableModelImprovements` é definido como `true` por padrão. Nessas regiões e localidades, definir o parâmetro como `false` gera uma exceção `ValidationException`.  
Tipo: booliano  
Obrigatório: não

 ** [idleSessionTTLInSeconds](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-idleSessionTTLInSeconds"></a>
O tempo máximo em segundos que o Amazon Lex retém os dados coletados em uma conversa.  
Uma sessão de interação do usuário permanecerá ativa pelo tempo especificado. Se nenhuma conversa ocorrer durante esse período, a sessão expirará, e o Amazon Lex excluirá todos os dados fornecidos antes do tempo limite.  
Por exemplo, suponha que um usuário escolha a OrderPizza intenção, mas se distraia na metade do processo de fazer um pedido. Se o usuário não concluir o pedido dentro do prazo especificado, o Amazon Lex descartará as informações do slot coletadas e o usuário deverá começar de novo.  
Se você não incluir o elemento `idleSessionTTLInSeconds` em uma solicitação da operação `PutBot`, o Amazon Lex usará o valor padrão. Isso também se aplica se a solicitação substituir um bot existente.  
O padrão é 300 segundos (5 minutos).  
Tipo: inteiro  
Faixa válida: valor mínimo de 60. Valor máximo de 86.400.  
Obrigatório: não

 ** [intents](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-intents"></a>
Uma matriz de objetos `Intent`. Cada intenção representa um comando que um usuário pode expressar. Por exemplo, um bot de pedido de pizza pode apoiar uma OrderPizza intenção. Para obter mais informações, consulte [Amazon Lex: como funciona](how-it-works.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)  
Obrigatório: não

 ** [locale](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-locale"></a>
 Especifica a localidade de destino deste bot. Qualquer intenção usada no bot deve ser compatível com a localidade do bot.   
O padrão é `en-US`.  
Tipo: String  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR`   
Obrigatório: Sim

 ** [nluIntentConfidenceThreshold](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-nluIntentConfidenceThreshold"></a>
Determina o limite em que o Amazon Lex inserirá o `AMAZON.FallbackIntent``AMAZON.KendraSearchIntent`,, ou ambos ao retornar intenções alternativas em uma resposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html). [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) `AMAZON.FallbackIntent`e só `AMAZON.KendraSearchIntent` são inseridos se estiverem configurados para o bot.  
Você deve definir o parâmetro `enableModelImprovements` como `true` para usar pontuações de confiança nas seguintes regiões.  
+ Leste dos EUA (Norte da Virgínia) (us-east-1)
+ Oeste dos EUA (Oregon) (us-west-2)
+ Ásia-Pacífico (Sydney) (ap-southeast-2)
+ Europa (Irlanda) (eu-west-1)
Em outras regiões, o parâmetro `enableModelImprovements` é definido como `true` por padrão.  
Por exemplo, suponha que um bot esteja configurado com o limite de confiança de 0,80 e o `AMAZON.FallbackIntent`. O Amazon Lex retorna três intenções alternativas com as seguintes pontuações de confiança: IntentA (0,70), IntentB (0,60), IntentC (0,50). A resposta da operação `PostText` seria:  
+ AMAZÔNIA. FallbackIntent
+ IntentA
+ IntentB
+ IntentC
Tipo: duplo  
Intervalo válido: valor mínimo de 0. Valor máximo de 1.  
Obrigatório: não

 ** [processBehavior](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-processBehavior"></a>
Se você definir o elemento `processBehavior` como `BUILD`, o Amazon Lex criará o bot para que ele possa ser executado. Se você definir o elemento como `SAVE`, o Amazon Lex salva o bot, mas não o cria.   
Se você não especificar este valor, o valor padrão é `BUILD`.  
Tipo: String  
Valores válidos: `SAVE | BUILD`   
Obrigatório: não

 ** [tags](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-tags"></a>
Uma lista de tags a serem adicionadas ao bot. Você só pode adicionar tags ao criar um bot; não pode usar a operação `PutBot` para atualizar as tags em um bot. Para atualizar tags, use a operação `TagResource`.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

 ** [voiceId](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-voiceId"></a>
O ID de voz do Amazon Polly que você quer que o Amazon Lex use para interações de voz com o usuário. A localidade configurada para a voz deve corresponder à localidade do bot. Para obter mais informações, consulte [Vozes no Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) no *Guia do desenvolvedor do Amazon Polly*.  
Tipo: String  
Obrigatório: não

## Sintaxe da resposta
<a name="API_PutBot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "nluIntentConfidenceThreshold": number,
   "status": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "version": "string",
   "voiceId": "string"
}
```

## Elementos de resposta
<a name="API_PutBot_ResponseElements"></a>

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.

 ** [abortStatement](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-abortStatement"></a>
A mensagem que o Amazon Lex usa para cancelar uma conversa. Para obter mais informações, consulte [PutBot](#API_PutBot).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-checksum"></a>
Soma de verificação do bot que você criou.  
Tipo: String

 ** [childDirected](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-childDirected"></a>
Para cada bot do Amazon Lex criado com o Serviço de criação de modelo do Amazon Lex, você deve especificar se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à Lei de Proteção à Privacidade Online Infantil (COPPA), especificando `true` ou `false` no `childDirected` campo. Ao especificar `true` no campo `childDirected`, você confirma que seu uso do Amazon Lex **está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Ao especificar `false` no campo `childDirected`, você confirma que seu uso do Amazon Lex **não está** relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA. Você não pode especificar um valor padrão para o campo `childDirected` que não reflita com precisão se o uso do Amazon Lex está relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos e sujeito à COPPA.  
Se o uso do Amazon Lex estiver relacionado a um site, programa ou outro aplicativo direcionado, total ou parcialmente, a crianças menores de 13 anos, você deverá obter qualquer consentimento parental verificável exigido pela COPPA. Para obter informações sobre o uso do Amazon Lex em conexão com sites, programas ou outros aplicativos direcionados, total ou parcialmente, a crianças menores de 13 anos, consulte as [perguntas frequentes do Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: booliano

 ** [clarificationPrompt](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-clarificationPrompt"></a>
 Os prompts que o Amazon Lex usa quando não entende a intenção do usuário. Para obter mais informações, consulte [PutBot](#API_PutBot).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createdDate"></a>
A data e a hora em que o bot foi criado.  
Tipo: Timestamp

 ** [createVersion](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createVersion"></a>
 `True` se uma nova versão do bot tiver sido criada. Se o campo `createVersion` não tiver sido especificado na solicitação, o campo `createVersion` será definido como falso na resposta.  
Tipo: booliano

 ** [description](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-description"></a>
Uma descrição do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [detectSentiment](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-detectSentiment"></a>
 `true` se o bot estiver configurado para enviar declarações do usuário ao Amazon Comprehend para análise de sentimento. Se o campo `detectSentiment` não tiver sido especificado na solicitação, o campo `detectSentiment` será `false` na resposta.  
Tipo: booliano

 ** [enableModelImprovements](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-enableModelImprovements"></a>
Indica se o bot usa melhorias de precisão. `true` indica que o bot está usando as melhorias, caso contrário, é `false`.  
Tipo: booliano

 ** [failureReason](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha na criação do bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-idleSessionTTLInSeconds"></a>
O tempo máximo que o Amazon Lex retém os dados coletados em uma conversa. Para obter mais informações, consulte [PutBot](#API_PutBot).  
Tipo: inteiro  
Faixa válida: valor mínimo de 60. Valor máximo de 86.400.

 ** [intents](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-intents"></a>
Uma matriz de objetos `Intent`. Para obter mais informações, consulte [PutBot](#API_PutBot).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-lastUpdatedDate"></a>
A data em que o 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: Timestamp

 ** [locale](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-locale"></a>
 O local de destino deste bot.   
Tipo: String  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [name](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-name"></a>
O nome do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-nluIntentConfidenceThreshold"></a>
A pontuação que determina onde o Amazon Lex insere o`AMAZON.FallbackIntent`,`AMAZON.KendraSearchIntent`, ou ambos ao retornar intenções alternativas em uma resposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html). [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) `AMAZON.FallbackIntent`será inserido se a pontuação de confiança para todas as intenções estiver abaixo desse valor. `AMAZON.KendraSearchIntent`só é inserido se estiver configurado para o bot.  
Tipo: duplo  
Intervalo válido: valor mínimo de 0. Valor máximo de 1.

 ** [status](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-status"></a>
 Ao enviar uma solicitação para criar um bot com `processBehavior` definido como `BUILD`, o Amazon Lex define o elemento de resposta `status` como `BUILDING`.  
No estado `READY_BASIC_TESTING`, você pode testar o bot com entradas do usuário que correspondem exatamente as declarações configuradas para as intenções e valores do bot nos tipos de slot.  
Se o Amazon Lex não puder criar o bot, ele define `status` como `FAILED`. O Amazon Lex retorna o motivo da falha no elemento de resposta `failureReason`.   
Quando você define `processBehavior` como `SAVE`, o Amazon Lex define o código de status como `NOT BUILT`.  
Quando o bot está no estado `READY`, você pode testar e publicar o bot.  
Tipo: String  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [tags](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-tags"></a>
Uma lista de tags associadas ao bot.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

 ** [version](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-version"></a>
A versão do bot. Para um novo bot, a versão é sempre `$LATEST`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-voiceId"></a>
O ID de voz do Amazon Polly que o Amazon Lex usa para a interação de voz com o usuário. Para obter mais informações, consulte [PutBot](#API_PutBot).  
Tipo: string

## Erros
<a name="API_PutBot_Errors"></a>

 ** 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
<a name="API_PutBot_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBot) 

# PutBotAlias
<a name="API_PutBotAlias"></a>

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](versioning-aliases.md).

Essa operação exige permissões para a ação `lex:PutBotAlias`. 

## Sintaxe da Solicitação
<a name="API_PutBotAlias_RequestSyntax"></a>

```
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 name="API_PutBotAlias_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
O nome do bot.  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
O nome do alias. O nome *não* é sensível a maiúsculas e minúsculas.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_PutBotAlias_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></a>
A versão do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Sim

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
Identifica uma revisão específica da versão `$LATEST`.  
Ao criar um novo alias de bot, deixe o campo `checksum` em branco. Se você especificar uma soma de verificação, obterá uma exceção `BadRequestException`.  
Quando quiser atualizar um alias de bot, defina o campo `checksum` como a soma de verificação da revisão mais recente da versão `$LATEST`. Se você não especificar o campo ` checksum` ou se a soma de verificação não corresponder à versão `$LATEST`, você receberá uma exceção `PreconditionFailedException`.  
Tipo: String  
Obrigatório: não

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
Configurações para logs de conversas para o alias.  
Tipo: objeto [ConversationLogsRequest](API_ConversationLogsRequest.md)  
Obrigatório: não

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
Uma descrição do alias.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
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 `PutBotAlias` para atualizar as tags em um alias de bot. Para atualizar tags, use a operação `TagResource`.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_PutBotAlias_ResponseSyntax"></a>

```
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
<a name="API_PutBotAlias_ResponseElements"></a>

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](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
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](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
A versão do bot para o qual o alias aponta.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
A soma de verificação para a versão atual do alias.  
Tipo: String

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
As configurações que determinam como o Amazon Lex usa logs de conversa para o alias.  
Tipo: objeto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
A data em que o alias do bot foi criado.  
Tipo: Timestamp

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
Uma descrição do alias.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
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: Timestamp

 ** [name](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-name"></a>
O nome do alias.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
Uma lista de tags associadas a um bot.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

## Erros
<a name="API_PutBotAlias_Errors"></a>

 ** 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
<a name="API_PutBotAlias_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias) 

# PutIntent
<a name="API_PutIntent"></a>

Cria uma intenção ou substitui uma intenção existente.

Para definir a interação entre o usuário e seu bot, você usa uma ou mais intenções. Para um bot de pedidos de pizza, por exemplo, você criaria uma intenção `OrderPizza`. 

Para criar uma intenção ou substituir uma intenção existente, você deve fornecer o seguinte:
+ Nome da intenção. Por exemplo, .`OrderPizza`
+ Amostra de declarações. Por exemplo, “Posso pedir uma pizza, por favor.” e “Quero pedir uma pizza”.
+ Informações a serem coletadas. Você especifica os tipos de slots para as informações que seu bot solicitará do usuário. Você pode especificar tipos de compartimentos padrão, como data ou hora, ou tipos de compartimentos personalizados, como o tamanho e a massa de uma pizza.
+ Como a intenção será atendida. Você pode fornecer uma função do Lambda ou configurar a intenção para retornar as informações da intenção ao aplicativo cliente. Se você usa uma função do Lambda, quando todas as informações de intenção estão disponíveis, o Amazon Lex invoca sua função do Lambda. Se você configurar sua intenção para retornar as informações de intenção para o aplicativo cliente. 

Você pode especificar outras informações opcionais na solicitação, como:
+ Um prompt de confirmação para solicitar que o usuário confirme uma intenção. Por exemplo, “Devo pedir sua pizza?”
+ Uma declaração de conclusão a ser enviada ao usuário após o atendimento da intenção. Por exemplo, “Devo pedir sua pizza?”.
+ Um prompt de acompanhamento que solicita atividades adicionais ao usuário. Por exemplo, perguntar “Você quer pedir uma bebida com a sua pizza?”

Se você especificar um nome de intenção existente para atualizar a intenção, o Amazon Lex substituirá os valores na versão `$LATEST` da intenção pelos valores na solicitação. O Amazon Lex remove campos que você não fornece na solicitação. Se você não especificar os campos obrigatórios, o Amazon Lex lançará uma exceção. Quando você atualiza a versão `$LATEST` de uma intenção, o campo `status` de qualquer bot que usa a versão `$LATEST` da intenção é definido como `NOT_BUILT`.

Para obter mais informações, consulte [Amazon Lex: como funciona](how-it-works.md).

Essa operação exige permissões para a ação `lex:PutIntent`.

## Sintaxe da Solicitação
<a name="API_PutIntent_RequestSyntax"></a>

```
PUT /intents/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createVersion": boolean,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ]
}
```

## Parâmetros da Solicitação de URI
<a name="API_PutIntent_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-uri-name"></a>
O nome da intenção. O nome *não* é sensível a maiúsculas e minúsculas.   
O nome não pode corresponder a um nome de intenção incorporado ou a um nome de intenção incorporado com “AMAZON.” removido. Por exemplo, como há uma intenção integrada chamada `AMAZON.HelpIntent`, você não pode criar uma intenção personalizada chamada `HelpIntent`.   
Para obter uma lista de intenções integradas, consulte [Intenções integradas padrão](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) no *Alexa Skills Kit*.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_PutIntent_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [checksum](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-checksum"></a>
Identifica uma revisão específica da versão `$LATEST`.  
Ao criar uma nova intenção, deixe o campo `checksum` em branco. Se você especificar uma soma de verificação, obterá uma exceção `BadRequestException`.  
Quando quiser atualizar uma intenção, defina o campo `checksum` como a soma de verificação da revisão mais recente da versão `$LATEST`. Se você não especificar o campo ` checksum` ou se a soma de verificação não corresponder à versão `$LATEST`, você receberá uma exceção `PreconditionFailedException`.  
Tipo: String  
Obrigatório: não

 ** [conclusionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-conclusionStatement"></a>
 A declaração que você deseja que o Amazon Lex transmita ao usuário após a intenção ser atendida com sucesso pela função do Lambda.   
Esse elemento é relevante somente se você fornecer uma função do Lambda no `fulfillmentActivity`. Se você retornar a intenção ao aplicativo cliente, não poderá especificar esse elemento.  
Os `followUpPrompt` e `conclusionStatement` são mutuamente exclusivos. Você pode especificar apenas um.
Tipo: objeto [Statement](API_Statement.md)  
Obrigatório: não

 ** [confirmationPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-confirmationPrompt"></a>
Solicita que o usuário confirme a intenção. Essa pergunta deve ter uma resposta afirmativa ou negativa.  
O Amazon Lex usa esse prompt para garantir que o usuário reconheça que a intenção está pronta para ser atendida. Por exemplo, com a intenção `OrderPizza`, talvez você queira confirmar que o pedido está correto antes de fazer o pedido. Para outras finalidades, como intenções que simplesmente respondem às perguntas do usuário, talvez não seja necessário pedir confirmação ao usuário antes de fornecer as informações.   
Você deve fornecer tanto o `rejectionStatement` quanto o `confirmationPrompt`, ou nenhum.
Tipo: objeto [Prompt](API_Prompt.md)  
Obrigatório: não

 ** [createVersion](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-createVersion"></a>
Quando configurado para `true`, uma nova versão numerada da intenção é criada. Isso é o mesmo que chamar a operação `CreateIntentVersion`. Se você não especificar `createVersion`, o valor padrão será `false`.  
Tipo: booliano  
Obrigatório: não

 ** [description](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-description"></a>
Uma descrição da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** [dialogCodeHook](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-dialogCodeHook"></a>
 Especifica uma função do Lambda do alias para invocar cada entrada do usuário. Você pode invocar essa função do Lambda para personalizar a interação do usuário.   
Por exemplo, suponha que seu bot determine que o usuário é John. Sua função do Lambda pode recuperar as informações de John de um banco de dados de back-end e preencher previamente alguns dos valores. Por exemplo, se achar que John é intolerante ao glúten, você pode definir o intervalo de intenção correspondente, `GlutenIntolerant`, como verdadeiro. Você pode encontrar o número de telefone de John e definir o atributo de sessão correspondente.   
Tipo: objeto [CodeHook](API_CodeHook.md)  
Obrigatório: não

 ** [followUpPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-followUpPrompt"></a>
O Amazon Lex usa esse prompt para solicitar atividades adicionais do usuário depois de atender uma intenção. Por exemplo, depois que a intenção `OrderPizza` for atendida, você pode solicitar que o usuário peça uma bebida.  
A ação que o Amazon Lex executa depende da resposta do usuário, da seguinte forma:  
+ Se o usuário disser “Sim”, ele responderá com o prompt de esclarecimento configurado para o bot.
+ Se o usuário disser “Sim” e continuar com uma declaração que aciona uma intenção, ele iniciará uma conversa sobre a intenção.
+ Se o usuário disser “Não”, ele responderá com a declaração de rejeição configurada para o prompt de acompanhamento.
+ Se ele não reconhecer a declaração, ele repetirá o prompt de acompanhamento novamente.
O campo `followUpPrompt` e o campo `conclusionStatement` são mutuamente exclusivos. Você pode especificar apenas um.   
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)  
Obrigatório: não

 ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-fulfillmentActivity"></a>
Obrigatório. Descreve como a intenção é atendida. Por exemplo, depois que um usuário fornece todas as informações de um pedido de pizza, `fulfillmentActivity` define como o bot faz um pedido em uma pizzaria local.   
 Você pode configurar o Amazon Lex para retornar todas as informações de intenção ao aplicativo cliente ou direcioná-lo para invocar uma função do Lambda que possa processar a intenção (por exemplo, fazer um pedido em uma pizzaria).   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)  
Obrigatório: não

 ** [inputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-inputContexts"></a>
Uma matriz de objetos `InputContext` que lista os contextos que devem estar ativos para que o Amazon Lex escolha a intenção em uma conversa com o usuário.  
Tipo: matriz de [InputContext](API_InputContext.md) objetos  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.  
Obrigatório: não

 ** [kendraConfiguration](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-kendraConfiguration"></a>
Informações de configuração necessárias para usar a intenção `AMAZON.KendraSearchIntent`para se conectar a um índice do Amazon Kendra. Para obter mais informações, consulte [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)  
Obrigatório: não

 ** [outputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-outputContexts"></a>
Uma matriz de objetos `OutputContext` que lista os contextos que a intenção ativa quando a intenção é atendida.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.  
Obrigatório: não

 ** [parentIntentSignature](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-parentIntentSignature"></a>
O identificador exclusivo da intenção integrada a ser usada como base para essa intenção. Para encontrar a assinatura de uma intenção, consulte [Intenções integradas padrão](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) no *Alexa Skills Kit*.  
Tipo: String  
Obrigatório: não

 ** [rejectionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-rejectionStatement"></a>
Quando o usuário responde “não” à pergunta definida em `confirmationPrompt`, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.   
Você deve fornecer tanto o `rejectionStatement` quanto o `confirmationPrompt`, ou nenhum.
Tipo: objeto [Statement](API_Statement.md)  
Obrigatório: não

 ** [sampleUtterances](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-sampleUtterances"></a>
Uma lista das declarações (strings) que um usuário pode fazer para sinalizar a intenção. Por exemplo, “Quero \$1PizzaSize\$1 pizza”, “Pedir \$1Quantidade\$1 \$1PizzaSize\$1 pizzas”.   
Em cada declaração, o nome de um slot é colocado entre chaves.   
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 1.500 itens.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Obrigatório: não

 ** [slots](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-slots"></a>
Uma matriz de slots de intenção. Em runtime, o Amazon Lex extrai os valores de slot necessários do usuário usando prompts definidos nos slots. Para obter mais informações, consulte [Amazon Lex: como funciona](how-it-works.md).   
Tipo: matriz de objetos [Slot](API_Slot.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_PutIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Elementos de resposta
<a name="API_PutIntent_ResponseElements"></a>

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.

 ** [checksum](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-checksum"></a>
Soma de verificação da versão `$LATEST` de intenção criada ou atualizada.  
Tipo: String

 ** [conclusionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-conclusionStatement"></a>
Depois que a função do Lambda especificada no elemento `fulfillmentActivity` atende a intenção, o Amazon Lex transmite essa declaração ao usuário.  
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-confirmationPrompt"></a>
Se definido na intenção, o Amazon Lex solicita que o usuário confirme a intenção antes de atendê-la.  
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createdDate"></a>
A data em que a intenção foi criada.  
Tipo: Timestamp

 ** [createVersion](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createVersion"></a>
 `True` se uma nova versão da intenção tiver sido criada. Se o campo `createVersion` não tiver sido especificado na solicitação, o campo `createVersion` será definido como falso na resposta.  
Tipo: booliano

 ** [description](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-description"></a>
Uma descrição da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-dialogCodeHook"></a>
Se definido na intenção, o Amazon Lex invoca essa função do Lambda para cada entrada do usuário.  
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-followUpPrompt"></a>
Se definido na intenção, o Amazon Lex usa esse prompt para solicitar atividades adicionais do usuário depois que a intenção for atendida.  
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-fulfillmentActivity"></a>
Se definido na intenção, o Amazon Lex invoca essa função do Lambda para cumprir a intenção depois que o usuário fornece todas as informações exigidas pela intenção.  
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-inputContexts"></a>
Uma matriz de objetos `InputContext` que lista os contextos que devem estar ativos para que o Amazon Lex escolha a intenção em uma conversa com o usuário.  
Tipo: matriz de [InputContext](API_InputContext.md) objetos  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.

 ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-kendraConfiguration"></a>
Informações de configuração, se houver, necessárias para se conectar a um índice do Amazon Kendra e usar na intenção `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-lastUpdatedDate"></a>
A data em que a intenção foi atualizada. Quando você cria um recurso, a data de criação e a data da última atualização são as mesmas.  
Tipo: Timestamp

 ** [name](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-name"></a>
O nome da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-outputContexts"></a>
Uma matriz de objetos `OutputContext` que lista os contextos que a intenção ativa quando a intenção é atendida.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-parentIntentSignature"></a>
Um identificador exclusivo da intenção integrada na qual essa intenção se baseia.  
Tipo: string

 ** [rejectionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-rejectionStatement"></a>
Quando o usuário responde “não” à pergunta definida em `confirmationPrompt`, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-sampleUtterances"></a>
 Uma matriz de amostras de declarações que são configuradas para a intenção.   
Tipo: matriz de strings  
Membros da matriz: número mínimo de 0 itens. Número máximo de 1.500 itens.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.

 ** [slots](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-slots"></a>
Uma matriz de slots de intenção configurados para a intenção.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.

 ** [version](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-version"></a>
A versão da intenção. Para uma nova intenção, a versão é sempre `$LATEST`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_PutIntent_Errors"></a>

 ** 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
<a name="API_PutIntent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent) 

# PutSlotType
<a name="API_PutSlotType"></a>

Cria um tipo de slot personalizado ou substitui um tipo de slot personalizado existente.

Para criar um tipo de slot personalizado, especifique um nome para o tipo de slot e um conjunto de valores de enumeração, que são os valores que um slot desse tipo pode assumir. Para obter mais informações, consulte [Amazon Lex: como funciona](how-it-works.md).

Se você especificar o nome de um tipo de slot existente, os campos na solicitação substituirão os valores existentes na versão `$LATEST` do tipo de slot. O Amazon Lex remove campos que você não fornece na solicitação. Se você não especificar os campos obrigatórios, o Amazon Lex lançará uma exceção. Quando você atualiza a versão `$LATEST` de um tipo de slot, o campo `$LATEST` de qualquer bot que usa a versão `status` do tipo de slot é definido como `NOT_BUILT`. 

Essa operação exige permissões para a ação `lex:PutSlotType`.

## Sintaxe da Solicitação
<a name="API_PutSlotType_RequestSyntax"></a>

```
PUT /slottypes/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string"
}
```

## Parâmetros da Solicitação de URI
<a name="API_PutSlotType_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-uri-name"></a>
O nome do tipo de slot. O nome *não* é sensível a maiúsculas e minúsculas.   
O nome não pode corresponder a um nome de tipo de slot incorporado ou a um nome de tipo de slot incorporado com “AMAZON.” removido. Por exemplo, como há um tipo de slot integrado chamado `AMAZON.DATE`, você não pode criar um tipo de slot personalizado chamado `DATE`.   
Para obter uma lista de tipos de slot integrados, consulte [Referência do tipo de slot](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) no *Alexa Skills Kit*.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_PutSlotType_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [checksum](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-checksum"></a>
Identifica uma revisão específica da versão `$LATEST`.  
Ao criar um novo tipo de slot, deixe o campo `checksum` em branco. Se você especificar uma soma de verificação, obterá uma exceção `BadRequestException`.  
Quando quiser atualizar um tipo de slot, defina o campo `checksum` como a soma de verificação da revisão mais recente da versão `$LATEST`. Se você não especificar o campo ` checksum` ou se a soma de verificação não corresponder à versão `$LATEST`, você receberá uma exceção `PreconditionFailedException`.  
Tipo: String  
Obrigatório: não

 ** [createVersion](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-createVersion"></a>
Quando configurado para `true`, uma nova versão numerada do tipo de slot é criada. Isso é o mesmo que chamar a operação `CreateSlotTypeVersion`. Se você não especificar `createVersion`, o valor padrão será `false`.  
Tipo: booliano  
Obrigatório: não

 ** [description](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-description"></a>
Uma descrição do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** [enumerationValues](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-enumerationValues"></a>
Uma lista de objetos `EnumerationValue` que define os valores que o tipo de slot pode ter. Cada valor pode ter uma lista de `synonyms`, que são valores adicionais que ajudam a treinar o modelo de machine learning sobre os valores que ele resolve para o slot.   
Um tipo de slot de expressão regular não exige valores de enumeração. Todos os outros tipos de slots exigem uma lista de valores de enumeração.  
Quando o Amazon Lex resolve um valor de slot, ele gera uma lista de resolução que contém até cinco valores possíveis para o slot. Se você estiver usando uma função do Lambda, essa lista de resolução será passada para a função. Se você não estiver usando uma função do Lambda, poderá optar por retornar o valor que o usuário inseriu ou o primeiro valor na lista como o valor de slot. O campo `valueSelectionStrategy` indica a opção a ser usada.   
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10.000 itens.  
Obrigatório: não

 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-parentSlotTypeSignature"></a>
O tipo de slot integrado usado como pai do tipo de slot. Quando você define um tipo de slot pai, o novo tipo de slot tem todas as mesmas configurações do pai.  
Somente `AMAZON.AlphaNumeric` é suportado.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obrigatório: não

 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-slotTypeConfigurations"></a>
Informações de configuração que estendem o tipo de slot integrado principal. A configuração é adicionada às configurações do tipo de slot principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.  
Obrigatório: não

 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-valueSelectionStrategy"></a>
Determina a estratégia de resolução de slots que o Amazon Lex usa para retornar valores do tipo de slot. O campo pode ser definido com os dos seguintes valores:  
+  `ORIGINAL_VALUE` - Retorna o valor inserido pelo usuário, se o valor do usuário for semelhante ao valor de um slot.
+  `TOP_RESOLUTION` - Se houver uma lista de resolução para o slot, retornará o primeiro valor na lista como o valor do tipo de slot. Se não houver uma lista de resolução, retornará o valor “null”.
Se `valueSelectionStrategy` não for especificado, o valor padrão será `ORIGINAL_VALUE`.  
Tipo: String  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION`   
Obrigatório: não

## Sintaxe da resposta
<a name="API_PutSlotType_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Elementos de resposta
<a name="API_PutSlotType_ResponseElements"></a>

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.

 ** [checksum](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-checksum"></a>
Soma de verificação da versão `$LATEST` do tipo de slot.  
Tipo: String

 ** [createdDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createdDate"></a>
A data em que o tipo de slot foi criado.  
Tipo: Timestamp

 ** [createVersion](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createVersion"></a>
 `True` se uma nova versão do tipo de slot tiver sido criada. Se o campo `createVersion` não tiver sido especificado na solicitação, o campo `createVersion` será definido como falso na resposta.  
Tipo: booliano

 ** [description](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-description"></a>
Uma descrição do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

 ** [enumerationValues](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-enumerationValues"></a>
Uma lista de objetos `EnumerationValue` que define os valores que o tipo de slot pode ter.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10.000 itens.

 ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-lastUpdatedDate"></a>
A data em que o tipo de slot foi atualizado. Quando você cria um tipo de slot, a data de criação e a data da última atualização são as mesmas.  
Tipo: Timestamp

 ** [name](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-name"></a>
O nome do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-parentSlotTypeSignature"></a>
O tipo de slot integrado usado como pai do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-slotTypeConfigurations"></a>
Informações de configuração que estendem o tipo de slot integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

 ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-valueSelectionStrategy"></a>
A estratégia de resolução de slot que o Amazon Lex usa para determinar o valor de slot. Para obter mais informações, consulte [PutSlotType](#API_PutSlotType).  
Tipo: String  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-version"></a>
A versão do tipo de slot. Para um novo tipo de slot, a versão é sempre `$LATEST`.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

## Erros
<a name="API_PutSlotType_Errors"></a>

 ** 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
<a name="API_PutSlotType_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType) 

# StartImport
<a name="API_StartImport"></a>

Inicia um trabalho para importar um recurso para o Amazon Lex.

## Sintaxe da Solicitação
<a name="API_StartImport_RequestSyntax"></a>

```
POST /imports/ HTTP/1.1
Content-type: application/json

{
   "mergeStrategy": "string",
   "payload": blob,
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Parâmetros da solicitação de URI
<a name="API_StartImport_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_StartImport_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
Especifica a ação que a operação `StartImport` deve realizar quando há um recurso existente com o mesmo nome.  
+ FAIL\$1ON\$1CONFLICT - A operação de importação é interrompida no primeiro conflito entre um recurso no arquivo de importação e um recurso existente. O nome do recurso que está causando o conflito está no campo `failureReason` da resposta à operação `GetImport`.

  OVERWRITE\$1LATEST - A operação de importação prossegue mesmo se houver um conflito com um recurso existente. A versão \$1LASTEST do recurso existente é substituída pelos dados do arquivo de importação.
Tipo: String  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT`   
Obrigatório: Sim

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
Um arquivo zip em formato binário. O arquivo deve conter um arquivo, um arquivo JSON que contém o recurso a ser importado. O recurso deve corresponder ao tipo especificado no campo `resourceType`.  
Tipo: Objeto de dados binários codificado em Base64  
Obrigatório: Sim

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
Especifica o tipo de recurso a ser exportado. Cada recurso também exporta todos os recursos dos quais ele depende.   
+ Um bot exporta intenções dependentes.
+ Uma intenção exporta os tipos de slots dependentes.
Tipo: String  
Valores válidos: `BOT | INTENT | SLOT_TYPE`   
Obrigatório: Sim

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
Uma lista de tags a serem adicionadas ao bot importado. Apenas é possível adicionar tags ao importar um bot. Não é possível adicionar tags a uma intenção ou tipo de slot.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_StartImport_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "createdDate": number,
   "importId": "string",
   "importStatus": "string",
   "mergeStrategy": "string",
   "name": "string",
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Elementos de resposta
<a name="API_StartImport_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
Um carimbo de data e hora para a data e a hora em que a tarefa de importação foi solicitada.  
Tipo: Timestamp

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
O identificador para a tarefa de importação específica.  
Tipo: String

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
O status do trabalho de importação. Se o status for `FAILED`, você poderá obter o motivo da falha usando a operação `GetImport`.  
Tipo: String  
Valores válidos: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
A ação a ser executada quando houver um conflito de fusão.  
Tipo: String  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
O nome dado ao trabalho de importação.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
O tipo do recurso a ser importado.  
Tipo: string  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
Uma lista de tags a serem adicionadas ao bot importado.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.

## Erros
<a name="API_StartImport_Errors"></a>

 ** 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

## Consulte também
<a name="API_StartImport_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport) 

# StartMigration
<a name="API_StartMigration"></a>

Começa a migrar um bot do Amazon Lex V1 para o Amazon Lex V2. Migre seu bot quando quiser aproveitar os novos atributos do Amazon Lex V2.

Para obter mais informações, consulte [Migração de um bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) no *Guia do desenvolvedor do Amazon Lex*.

## Sintaxe da Solicitação
<a name="API_StartMigration_RequestSyntax"></a>

```
POST /migrations HTTP/1.1
Content-type: application/json

{
   "migrationStrategy": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotName": "string",
   "v2BotRole": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_StartMigration_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_StartMigration_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
A estratégia usada para conduzir a migração.  
+  `CREATE_NEW` - Cria um novo bot do Amazon Lex V2 e migra o bot do Amazon Lex V1 para o novo bot.
+  `UPDATE_EXISTING` - Substitui os metadados existentes do bot do Amazon Lex V2 e a localidade que está sendo migrada. Isso não altera nenhuma outra localidade no bot do Amazon Lex V2. Se a localidade não existir, uma nova localidade será criada no bot do Amazon Lex V2.
Tipo: String  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING`   
Obrigatório: Sim

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
O nome do bot do Amazon Lex V1 que você está migrando para o Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Sim

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
A versão do bot a ser migrado para o Amazon Lex V2. Você pode migrar a versão `$LATEST`, bem como qualquer versão numerada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Sim

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
O nome do bot do Amazon Lex V2 para o qual você está migrando o bot do Amazon Lex V1.   
+ Se o bot do Amazon Lex V2 não existir, você deverá usar a estratégia de migração `CREATE_NEW`.
+ Se o bot do Amazon Lex V2 existir, você deverá usar a estratégia de migração `UPDATE_EXISTING` para alterar o conteúdo do bot do Amazon Lex V2.
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([0-9a-zA-Z][_-]?)+$`   
Obrigatório: Sim

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
O perfil do IAM que o Amazon Lex usa para executar a versão do bot do Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_StartMigration_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "migrationId": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

## Elementos de resposta
<a name="API_StartMigration_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 202.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
O identificador exclusivo que o Amazon Lex atribuiu à migração.  
Tipo: String  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
A estratégia usada para conduzir a migração.  
Tipo: String  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
A data e hora em que a migração foi iniciada.  
Tipo: Timestamp

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
A localidade usada para o bot do Amazon Lex V1.   
Tipo: String  
Valores válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` 

 ** [v1BotName](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotName"></a>
O nome do bot do Amazon Lex V1 que você está migrando para o Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
A versão do bot a ser migrado para o Amazon Lex V2.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
O identificador exclusivo do bot do Amazon Lex V2.   
Tipo: String  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
O perfil do IAM que o Amazon Lex usa para executar a versão do bot do Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Erros
<a name="API_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Seu usuário ou função do IAM não tem permissão para chamar o Amazon Lex V2 APIs necessário para migrar seu bot.  
Código de status HTTP: 403

 ** 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 recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_StartMigration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration) 

# TagResource
<a name="API_TagResource"></a>

Adiciona as tags especificadas ao recurso especificado. Se uma chave de tag já existir, o valor existente será substituído pelo novo valor.

## Sintaxe da Solicitação
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Parâmetros da Solicitação de URI
<a name="API_TagResource_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-uri-resourceArn"></a>
O nome do recurso da Amazon (ARN) do bot, do alias do bot ou do canal do bot a ser marcado.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1011.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_TagResource_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-tags"></a>
A lista de chaves de tag a serem adicionadas a um recurso. Se uma chave de tag já existir, o valor existente será substituído pelo novo valor.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_TagResource_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_TagResource_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_TagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Remove as tags de um bot, alias de bot ou canal de bot.

## Sintaxe da Solicitação
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_UntagResource_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-resourceArn"></a>
O nome do recurso da Amazon (ARN) do recurso do qual remover as tags.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1011.  
Obrigatório: Sim

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-tagKeys"></a>
Uma lista de chaves de tag a serem removidas do recurso. Se uma chave de tag não existir no recurso, ela será ignorada.  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 128.  
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_UntagResource_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_UntagResource_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

## Erros
<a name="API_UntagResource_Errors"></a>

 ** 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

 ** NotFoundException **   
O recurso especificado na solicitação não foi encontrado. Verifique o recurso e tente novamente.  
Código de status HTTP: 404

## Consulte Também
<a name="API_UntagResource_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UntagResource) 

# Serviço de runtime do Amazon Lex
<a name="API_Operations_Amazon_Lex_Runtime_Service"></a>

As seguintes ações são compatíveis com o Serviço de runtime do Amazon Lex:
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# DeleteSession
<a name="API_runtime_DeleteSession"></a>

Remove informações de sessão para um bot, alias e ID de usuário especificado. 

## Sintaxe da Solicitação
<a name="API_runtime_DeleteSession_RequestSyntax"></a>

```
DELETE /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_runtime_DeleteSession_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botAlias](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botAlias"></a>
O alias em uso para o bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [botName](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botName"></a>
O nome do bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [userId](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-userId"></a>
O identificador do usuário associado aos dados da sessão.  
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_runtime_DeleteSession_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_runtime_DeleteSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botName": "string",
   "sessionId": "string",
   "userId": "string"
}
```

## Elementos de resposta
<a name="API_runtime_DeleteSession_ResponseElements"></a>

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.

 ** [botAlias](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botAlias"></a>
O alias em uso para o bot associado aos dados da sessão.  
Tipo: string

 ** [botName](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botName"></a>
O nome do bot associado aos dados de sessão.  
Tipo: string

 ** [sessionId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-sessionId"></a>
O identificador exclusivo da sessão.  
Tipo: string

 ** [userId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-userId"></a>
O ID do usuário do aplicativo cliente.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+` 

## Erros
<a name="API_runtime_DeleteSession_Errors"></a>

 ** BadRequestException **   
 A validação da solicitação falhou, não há mensagem utilizável no contexto ou a compilação do bot falhou, ainda está em andamento ou contém alterações não criadas.   
Código de status HTTP: 400

 ** ConflictException **   
 Dois clientes estão usando a mesma conta da AWS, o bot do Amazon Lex e o mesmo ID de usuário.   
Código de Status HTTP: 409

 ** InternalFailureException **   
Erro de serviço interno. Tente a chamada novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Excedeu um limite.  
Código de status HTTP: 429

 ** NotFoundException **   
O recurso (como o bot Amazon Lex ou um alias) mencionado não foi encontrado.  
Código de status HTTP: 404

## Consulte Também
<a name="API_runtime_DeleteSession_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DeleteSession) 

# GetSession
<a name="API_runtime_GetSession"></a>

Retorna informações de sessão para um bot, alias e ID de usuário especificado.

## Sintaxe da Solicitação
<a name="API_runtime_GetSession_RequestSyntax"></a>

```
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_runtime_GetSession_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
O alias em uso para o bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
O nome do bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
Uma string usada para filtrar as intenções retornadas na estrutura `recentIntentSummaryView`.   
Quando você especifica um filtro, somente as intenções com o campo `checkpointLabel` definido para essa string são retornadas.  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
O ID do usuário do aplicativo cliente. O Amazon Lex usa isso para identificar a conversa de um usuário com seu bot.   
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_runtime_GetSession_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_runtime_GetSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "dialogAction": { 
      "fulfillmentState": "string",
      "intentName": "string",
      "message": "string",
      "messageFormat": "string",
      "slots": { 
         "string" : "string" 
      },
      "slotToElicit": "string",
      "type": "string"
   },
   "recentIntentSummaryView": [ 
      { 
         "checkpointLabel": "string",
         "confirmationStatus": "string",
         "dialogActionType": "string",
         "fulfillmentState": "string",
         "intentName": "string",
         "slots": { 
            "string" : "string" 
         },
         "slotToElicit": "string"
      }
   ],
   "sessionAttributes": { 
      "string" : "string" 
   },
   "sessionId": "string"
}
```

## Elementos de resposta
<a name="API_runtime_GetSession_ResponseElements"></a>

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.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
Uma lista de contextos ativos para a sessão. Um contexto pode ser definido quando uma intenção é cumprida ou chamando a operação `PostContent`, `PostText` ou `PutSession`.  
Você pode usar um contexto para controlar as intenções que podem acompanhar uma intenção ou para modificar a operação do seu aplicativo.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 20 itens.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
Descreve o estado atual do bot.  
Tipo: objeto [DialogAction](API_runtime_DialogAction.md)

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
Uma matriz de informações sobre as intenções usadas na sessão. A matriz pode conter no máximo três resumos. Se mais de três intenções forem usadas na sessão, a operação `recentIntentSummaryView` conterá informações sobre as últimas três intenções usadas.  
Se você definir o parâmetro `checkpointLabelFilter` na solicitação, a matriz conterá somente as intenções com o rótulo especificado.  
Tipo: matriz de objetos [IntentSummary](API_runtime_IntentSummary.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 3 itens.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
Mapa de key/value pares representando as informações de contexto específicas da sessão. Ele contém informações do aplicativo passadas entre o Amazon Lex e um aplicativo cliente.  
Tipo: mapa de string para string

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
Um identificador exclusivo da sessão.  
Tipo: string

## Erros
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 A validação da solicitação falhou, não há mensagem utilizável no contexto ou a compilação do bot falhou, ainda está em andamento ou contém alterações não criadas.   
Código de status HTTP: 400

 ** InternalFailureException **   
Erro de serviço interno. Tente a chamada novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Excedeu um limite.  
Código de status HTTP: 429

 ** NotFoundException **   
O recurso (como o bot Amazon Lex ou um alias) mencionado não foi encontrado.  
Código de status HTTP: 404

## Consulte Também
<a name="API_runtime_GetSession_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GetSession) 

# PostContent
<a name="API_runtime_PostContent"></a>

 Envia a entrada do usuário (texto ou fala) ao Amazon Lex. Os clientes usam essa API para enviar solicitações de texto e áudio para o Amazon Lex em runtime. O Amazon Lex interpreta a entrada do usuário usando o modelo de machine learning criado para o bot. 

A operação `PostContent` oferece suporte a entrada de áudio em 8 kHz e 16 kHz. Você pode usar áudio de 8 kHz para obter maior precisão de reconhecimento de fala em aplicativos de áudio de telefone. 

 Em resposta, o Amazon Lex retorna a próxima mensagem para transmitir ao usuário. Considere as seguintes mensagens de exemplo: 
+  Para uma entrada do usuário “Eu gostaria de uma pizza”, o Amazon Lex pode retornar uma resposta com uma mensagem gerando dados do slot (por exemplo, `PizzaSize`): “Qual tamanho de pizza você gostaria?”. 
+  Depois que o usuário fornece todas as informações do pedido de pizza, o Amazon Lex pode retornar uma resposta com uma mensagem para obter a confirmação do usuário: “Pedir a pizza?”. 
+  Depois que o usuário responder “Sim” ao prompt de confirmação, o Amazon Lex poderá retornar uma declaração de conclusão: “Obrigado, sua pizza de queijo foi pedida.”. 

 Nem todas as mensagens do Amazon Lex exigem uma resposta do usuário. Por exemplo, declarações de conclusão não exigem uma resposta. Algumas mensagens exigem apenas uma resposta sim ou não. Além do `message`, o Amazon Lex fornece contexto adicional sobre a mensagem na resposta que você pode usar para aprimorar o comportamento do cliente, como exibir a interface de usuário apropriada do cliente. Considere os seguintes exemplos: 
+  Se a mensagem for para obter dados de slots, o Amazon Lex retornará as seguintes informações de contexto: 
  +  cabeçalho `x-amz-lex-dialog-state` definido como `ElicitSlot` 
  +  cabeçalho `x-amz-lex-intent-name` definido com o nome da intenção no contexto atual 
  +  cabeçalho `x-amz-lex-slot-to-elicit` definido com o nome do slot para o qual `message` está obtendo informações 
  +  cabeçalho `x-amz-lex-slots` definido como um mapa de slots configurados para a intenção com seus valores atuais 
+  Se a mensagem for um prompt de confirmação, o cabeçalho `x-amz-lex-dialog-state` será definido como `Confirmation` e o cabeçalho `x-amz-lex-slot-to-elicit` será omitido. 
+  Se a mensagem for um prompt de esclarecimento configurado para a intenção, indicando que a intenção do usuário não foi compreendida, o cabeçalho `x-amz-dialog-state` será definido como `ElicitIntent` e o cabeçalho `x-amz-slot-to-elicit` será omitido. 

 Além disso, o Amazon Lex também retorna seu aplicativo específico`sessionAttributes`. Para obter mais informações, consulte [Gerenciar o contexto de conversação](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Sintaxe da Solicitação
<a name="API_runtime_PostContent_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/content HTTP/1.1
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-request-attributes: requestAttributes
Content-Type: contentType
Accept: accept
x-amz-lex-active-contexts: activeContexts

inputStream
```

## Parâmetros da Solicitação de URI
<a name="API_runtime_PostContent_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 Você passa este valor como o cabeçalho HTTP `Accept`.   
 A mensagem que o Amazon Lex retorna na resposta pode ser texto ou fala com base no valor do cabeçalho HTTP `Accept` na solicitação.   
+  Se o valor for `text/plain; charset=utf-8`, o Amazon Lex retornará o texto na resposta. 
+  Se o valor começar com `audio/`, o Amazon Lex retornará a fala na resposta. O Amazon Lex usa o Amazon Polly para gerar a fala (usando a configuração especificada no cabeçalho `Accept`). Por exemplo, se você especificar `audio/mpeg` como valor, o Amazon Lex retornará a fala no formato MPEG.
+ Se o valor for `audio/pcm`, a fala retornada está `audio/pcm` no formato little-endian de 16 bits. 
+ Os valores aceitos são os seguintes:
  + audio/mpeg
  + audio/ogg
  + audio/pcm
  + text/plain; charset=utf-8
  + audio/\$1 (o padrão é mpeg)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
Uma lista de contextos ativos para a solicitação. Um contexto pode ser ativado quando uma intenção anterior é atendida ou incluindo o contexto na solicitação,  
Se você não especificar uma lista de contextos, o Amazon Lex usará a lista atual de contextos para a sessão. Se você especificar uma lista vazia, todos os contextos da sessão serão apagados.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
Alias do bot Amazon Lex.  
Obrigatório: Sim

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
Nome do bot do Amazon Lex.  
Obrigatório: Sim

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 Você passa este valor como o cabeçalho HTTP `Content-Type`.   
 Indica o formato de áudio ou texto. O valor do cabeçalho deve começar com um dos seguintes prefixos:   
+ No formato PCM, os dados de áudio devem estar na ordem de bytes little-endian.
  + audio/l16; rate=16000; channels=1
  + audio/x-l16; sample-rate=16000; channel-count=1
  + áudio/lpcm; taxa de amostragem = 8000; = 16; contagem de canais = 1; = falso sample-size-bits is-big-endian 
+ Formato Opus
  + áudio/ x-cbr-opus-with -preâmbulo; tamanho do preâmbulo = 0; taxa de bits = 256000; =4 frame-size-milliseconds
+ Formato de texto
  + text/plain; charset=utf-8
Obrigatório: Sim

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
Você passa este valor como o cabeçalho HTTP `x-amz-lex-request-attributes`.  
Informações específicas da solicitação passadas entre o Amazon Lex e um aplicativo cliente. O valor deve ser um mapa serializado JSON e codificado em base64 com chaves e valores de string. O tamanho total dos cabeçalhos `requestAttributes` e `sessionAttributes` está limitado a 12 KB.  
O namespace `x-amz-lex:` é reservado para atributos especiais. Não crie atributos de solicitação com o prefixo `x-amz-lex:`.  
Para obter mais informações, consulte [Definição de atributos de solicitação](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).

 ** [sessionAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-sessionAttributes"></a>
Você passa este valor como o cabeçalho HTTP `x-amz-lex-session-attributes`.  
Informações específicas do aplicativo passadas entre o Amazon Lex e um aplicativo cliente. O valor deve ser um mapa serializado JSON e codificado em base64 com chaves e valores de string. O tamanho total dos cabeçalhos `sessionAttributes` e `requestAttributes` está limitado a 12 KB.  
Para obter mais informações, consulte [Definição de atributos de sessão](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).

 ** [userId](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-userId"></a>
O ID do usuário do aplicativo cliente. O Amazon Lex usa isso para identificar a conversa de um usuário com seu bot. No runtime, cada solicitação deve conter o campo `userID`.  
Para decidir o ID de usuário a ser usado em seu aplicativo, considere os seguintes fatores.  
+ O campo `userID` não deve conter nenhuma informação de identificação pessoal do usuário, por exemplo, nome, números de identificação pessoal ou outras informações pessoais do usuário final.
+ Se você quiser que um usuário inicie uma conversa em um dispositivo e continue em outro, use um identificador específico do usuário.
+ Se você quiser que o mesmo usuário possa ter duas conversas independentes em dois dispositivos diferentes, escolha um identificador específico do dispositivo.
+ Um usuário não pode ter duas conversas independentes com duas versões diferentes do mesmo bot. Por exemplo, um usuário não pode conversar com as versões PROD e BETA do mesmo bot. Se você prevê que um usuário precisará conversar com duas versões diferentes, por exemplo, durante o teste, inclua o alias do bot no ID do usuário para separar as duas conversas.
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_runtime_PostContent_RequestBody"></a>

A solicitação aceita os dados binários a seguir.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 Entrada do usuário no formato de áudio PCM ou Opus ou formato de texto, conforme descrito no cabeçalho HTTP `Content-Type`.   
Você pode transmitir dados de áudio para o Amazon Lex ou criar um buffer local que capture todos os dados de áudio antes do envio. Em geral, você obtém melhor desempenho se transmitir dados de áudio em vez de armazenar os dados em buffer localmente.  
Obrigatório: sim

## Sintaxe da resposta
<a name="API_runtime_PostContent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: contentType
x-amz-lex-intent-name: intentName
x-amz-lex-nlu-intent-confidence: nluIntentConfidence
x-amz-lex-alternative-intents: alternativeIntents
x-amz-lex-slots: slots
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-sentiment: sentimentResponse
x-amz-lex-message: message
x-amz-lex-encoded-message: encodedMessage
x-amz-lex-message-format: messageFormat
x-amz-lex-dialog-state: dialogState
x-amz-lex-slot-to-elicit: slotToElicit
x-amz-lex-input-transcript: inputTranscript
x-amz-lex-encoded-input-transcript: encodedInputTranscript
x-amz-lex-bot-version: botVersion
x-amz-lex-session-id: sessionId
x-amz-lex-active-contexts: activeContexts

audioStream
```

## Elementos de resposta
<a name="API_runtime_PostContent_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

A resposta retorna os cabeçalhos HTTP a seguir.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
Uma lista de contextos ativos para a sessão. Um contexto pode ser definido quando uma intenção é cumprida ou chamando a operação `PostContent`, `PostText` ou `PutSession`.  
Você pode usar um contexto para controlar as intenções que podem acompanhar uma intenção ou para modificar a operação do seu aplicativo.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
Uma a quatro intenções alternativas que podem ser aplicáveis à intenção do usuário.  
Cada alternativa inclui uma pontuação que indica o grau de confiança do Amazon Lex de que a intenção corresponde à intenção do usuário. As intenções são classificadas pela pontuação de confiança.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
A versão do bot que respondeu à conversa. Você pode usar essas informações para ajudar a determinar se uma versão de um bot tem um desempenho melhor do que outra versão.  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
Tipo de conteúdo conforme especificado no cabeçalho HTTP `Accept` na solicitação.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
Identifica o estado atual da interação do usuário. O Amazon Lex retorna um dos seguintes valores como `dialogState`. Opcionalmente, o cliente pode usar essas informações para personalizar a interface do usuário.   
+  `ElicitIntent` - O Amazon Lex quer obter a intenção do usuário. Considere os seguintes exemplos: 

   Por exemplo, um usuário pode expressar uma intenção (“Quero pedir uma pizza”). Se o Amazon Lex não puder deduzir a intenção do usuário a partir dessa declaração, ele retornará esse estado de diálogo. 
+  `ConfirmIntent` - O Amazon Lex espera uma resposta “sim” ou “não”. 

  Por exemplo, o Amazon Lex quer a confirmação do usuário antes de atender uma intenção. Em vez de uma simples resposta de “sim” ou “não”, um usuário pode responder com informações adicionais. Por exemplo, “sim, mas peça uma pizza de massa grossa” ou “não, quero pedir uma bebida”. O Amazon Lex pode processar essas informações adicionais (nesses exemplos, atualizar o slot do tipo de crosta ou alterar a intenção de OrderPizza para OrderDrink). 
+  `ElicitSlot` - O Amazon Lex espera o valor de um slot para a intenção atual. 

   Por exemplo, suponha que, na resposta, o Amazon Lex envie esta mensagem: “Qual tamanho de pizza você gostaria?”. Um usuário pode responder com o valor de slot (por exemplo, “média”). O usuário também pode fornecer informações adicionais na resposta (por exemplo, “pizza média de massa grossa”). O Amazon Lex pode processar essas informações adicionais de forma adequada. 
+  `Fulfilled` - Transmite que a função do Lambda atendeu com sucesso a intenção. 
+  `ReadyForFulfillment` - Transmite que o cliente deve atender à solicitação. 
+  `Failed` - Transmite que a conversa com o usuário falhou. 

   Isso pode acontecer por vários motivos, incluindo o fato de o usuário não fornecer uma resposta adequada aos prompts do serviço (você pode configurar quantas vezes o Amazon Lex pode solicitar informações específicas a um usuário) ou se a função do Lambda não atender à intenção. 
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
O texto usado para processar a solicitação.  
Se a entrada tiver sido um fluxo de áudio, o campo `encodedInputTranscript` conterá o texto extraído do fluxo de áudio. Esse é o texto que é processado para reconhecer as intenções e os valores de slot. Você pode usar essas informações para determinar se o Amazon Lex está processando corretamente o áudio que você envia.  
O campo `encodedInputTranscript` é codificado em base 64. Você deve decodificar o campo antes de poder usar o valor.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
A mensagem a ser transmitida ao usuário. A mensagem pode vir da configuração do bot ou de uma função do Lambda.  
Se a intenção não estiver configurada com uma função do Lambda, ou se a função do Lambda tiver retornado `Delegate` como `dialogAction.type` em sua resposta, o Amazon Lex decide o próximo curso de ação e seleciona uma mensagem apropriada da configuração do bot com base no contexto de interação atual. Por exemplo, se o Amazon Lex não conseguir entender a entrada do usuário, ele usa uma mensagem de prompt de esclarecimento.  
Ao criar uma intenção, você pode atribuir mensagens a grupos. Quando as mensagens são atribuídas a grupos, o Amazon Lex retorna uma mensagem de cada grupo na resposta. O campo de mensagem é uma string JSON de escape que contém as mensagens. Para obter mais informações sobre a estrutura da string JSON retornada, consulte [Formatos de mensagem suportados](howitworks-manage-prompts.md#msg-prompts-formats).  
Se a função do Lambda retornar uma mensagem, o Amazon Lex a enviará para o cliente em sua resposta.  
O campo `encodedMessage` é codificado em base 64. Você deve decodificar o campo antes de poder usar o valor.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.366.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *Esse cabeçalho foi descontinuado.*   
O texto usado para processar a solicitação.  
Você pode usar esse campo somente nas localidades de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. Em todas as outras localidades, o campo `inputTranscript` é nulo. Em vez disso, use o campo `encodedInputTranscript`.  
Se a entrada tiver sido um fluxo de áudio, o campo `inputTranscript` conterá o texto extraído do fluxo de áudio. Esse é o texto que é processado para reconhecer as intenções e os valores de slot. Você pode usar essas informações para determinar se o Amazon Lex está processando corretamente o áudio que você envia.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
Intenção atual do usuário que o Amazon Lex conhece.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *Esse cabeçalho foi descontinuado.*   
Você só pode usar esse campo nas localidades de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. Em todas as outras localidades, o campo `message` é nulo. Em vez disso, use o campo `encodedMessage`.  
A mensagem a ser transmitida ao usuário. A mensagem pode vir da configuração do bot ou de uma função do Lambda.  
Se a intenção não estiver configurada com uma função do Lambda, ou se a função do Lambda tiver retornado `Delegate` como `dialogAction.type` em sua resposta, o Amazon Lex decide o próximo curso de ação e seleciona uma mensagem apropriada da configuração do bot com base no contexto de interação atual. Por exemplo, se o Amazon Lex não conseguir entender a entrada do usuário, ele usa uma mensagem de prompt de esclarecimento.  
Ao criar uma intenção, você pode atribuir mensagens a grupos. Quando as mensagens são atribuídas a grupos, o Amazon Lex retorna uma mensagem de cada grupo na resposta. O campo de mensagem é uma string JSON de escape que contém as mensagens. Para obter mais informações sobre a estrutura da string JSON retornada, consulte [Formatos de mensagem suportados](howitworks-manage-prompts.md#msg-prompts-formats).  
Se a função do Lambda retornar uma mensagem, o Amazon Lex a enviará para o cliente em sua resposta.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
O formato da mensagem de resposta. Um dos seguintes valores:  
+  `PlainText` - A mensagem contém texto sem formatação UTF-8.
+  `CustomPayload` - A mensagem é um formato personalizado para o cliente.
+  `SSML` - A mensagem contém texto formatado para saída de voz.
+  `Composite` - A mensagem contém um objeto JSON de escape que contém uma ou mais mensagens dos grupos aos quais as mensagens foram atribuídas quando a intenção foi criada.
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Fornece uma pontuação que indica o quanto o Amazon Lex tem certeza de que a intenção retornada é aquela que corresponde à intenção do usuário. A pontuação está entre 0,0 e 1,0.  
A pontuação é relativa, não absoluta. A pontuação pode mudar com base nas melhorias no Amazon Lex. 

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
O sentimento expresso em uma declaração.  
Quando o bot está configurado para enviar declarações ao Amazon Comprehend para análise de sentimentos, esse campo contém o resultado da análise.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 Mapa de key/value pares representando as informações de contexto específicas da sessão. 

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
O identificador exclusivo da sessão.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Mapa de zero ou mais slots de intenção (pares de chaves/valores) do Amazon Lex detectados na entrada do usuário durante a conversação. O campo é codificado em base 64.  
O Amazon Lex cria uma lista de resolução que contém valores prováveis para um slot. O valor que ele retorna é determinado pelo `valueSelectionStrategy` selecionado quando o tipo de slot foi criado ou atualizado. Se `valueSelectionStrategy` for definido como `ORIGINAL_VALUE`, o valor fornecido pelo usuário será retornado, se o valor do usuário for semelhante ao valor de slot. Se `valueSelectionStrategy` estiver definido como `TOP_RESOLUTION`, o Amazon Lex retornará o primeiro valor na lista de resolução ou, se não houver lista de resolução, nulo. Se `valueSelectionStrategy` não for especificado, o padrão será `ORIGINAL_VALUE`.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 Se o valor `dialogState` for `ElicitSlot`, retornará o nome do slot para o qual o Amazon Lex está obtendo um valor. 

A resposta retorna as informações a seguir como corpo HTTP.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
O prompt (ou declaração) a ser transmitido ao usuário. Isso se baseia na configuração e no contexto do bot. Por exemplo, se o Amazon Lex não entender a intenção do usuário, ele envia o `clarificationPrompt` configurado para o bot. Se a intenção exigir confirmação antes de realizar a ação de atendimento, ela envia o `confirmationPrompt`. Outro exemplo: suponha que a função do Lambda tenha atendido com sucesso a intenção e enviado uma mensagem para transmitir ao usuário. Em seguida, o Amazon Lex envia essa mensagem na resposta. 

## Erros
<a name="API_runtime_PostContent_Errors"></a>

 ** BadGatewayException **   
Ou o bot do Amazon Lex ainda está sendo construído ou um dos serviços dependentes (Amazon Polly, AWS Lambda) falhou com um erro interno de serviço.  
Código de status HTTP: 502

 ** BadRequestException **   
 A validação da solicitação falhou, não há mensagem utilizável no contexto ou a compilação do bot falhou, ainda está em andamento ou contém alterações não criadas.   
Código de status HTTP: 400

 ** ConflictException **   
 Dois clientes estão usando a mesma conta da AWS, o bot do Amazon Lex e o mesmo ID de usuário.   
Código de Status HTTP: 409

 ** DependencyFailedException **   
 Uma das dependências, como AWS Lambda ou Amazon Polly, gerou uma exceção. Por exemplo,   
+ Se o Amazon Lex não tiver permissões suficientes para chamar uma função do Lambda.
+ Se uma função do Lambda levar mais de 30 segundos para ser executada.
+ Se uma função do Lambda de atendimento retornar uma ação `Delegate` de diálogo sem remover nenhum valor de slot.
Código de status HTTP: 424

 ** InternalFailureException **   
Erro de serviço interno. Tente a chamada novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Excedeu um limite.  
Código de status HTTP: 429

 ** LoopDetectedException **   
Essa exceção não é usada.  
Código de status HTTP: 508

 ** NotAcceptableException **   
O cabeçalho de aceitação na solicitação não tem um valor válido.  
Código de status HTTP: 406

 ** NotFoundException **   
O recurso (como o bot Amazon Lex ou um alias) mencionado não foi encontrado.  
Código de status HTTP: 404

 ** RequestTimeoutException **   
A fala de entrada é muito longa.  
Código de status HTTP: 408

 ** UnsupportedMediaTypeException **   
O cabeçalho Content-Type (API `PostContent`) tem um valor inválido.   
Código de status HTTP: 415

## Exemplos
<a name="API_runtime_PostContent_Examples"></a>

### Exemplo 1
<a name="API_runtime_PostContent_Example_1"></a>

 Nessa solicitação, o URI identifica um bot (Tráfego), uma versão do bot (\$1LATEST) e um nome de usuário final (someuser). O cabeçalho `Content-Type` identifica o formato do áudio no corpo. O Amazon Lex também oferece suporte a outros formatos. Para converter áudio de um formato para outro, se necessário, você pode usar o software de código aberto SoX. Você especifica o formato no qual deseja obter a resposta adicionando o cabeçalho HTTP `Accept`. 

 Na resposta, o cabeçalho `x-amz-lex-message` mostra a resposta que o Amazon Lex retornou. O cliente pode então enviar essa resposta ao usuário. A mesma mensagem é enviada em audio/MPEG formato por meio de codificação em partes (conforme solicitado). 

#### Exemplo de solicitação
<a name="API_runtime_PostContent_Example_1_Request"></a>

```
"POST /bot/Traffic/alias/$LATEST/user/someuser/content HTTP/1.1[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/x-l16; channel-count=1; sample-rate=16000f[\r][\n]"
"Accept: audio/mpeg[\r][\n]"
"Host: runtime.lex.us-east-1.amazonaws.com[\r][\n]"
"Authorization: AWS4-HMAC-SHA256 Credential=BLANKED_OUT/20161230/us-east-1/lex/aws4_request, 
SignedHeaders=accept;content-type;host;x-amz-content-sha256;x-amz-date;x-amz-lex-session-attributes, Signature=78ca5b54ea3f64a17ff7522de02cd90a9acd2365b45a9ce9b96ea105bb1c7ec2[\r][\n]"
"X-Amz-Date: 20161230T181426Z[\r][\n]"
"X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Connection: Keep-Alive[\r][\n]"
"User-Agent: Apache-HttpClient/4.5.x (Java/1.8.0_112)[\r][\n]"
"Accept-Encoding: gzip,deflate[\r][\n]"
"[\r][\n]"
"1000[\r][\n]"
"[0x7][0x0][0x7][0x0][\n]"
"[0x0][0x7][0x0][0xfc][0xff][\n]"
"[0x0][\n]"
…
```

#### Resposta da amostra
<a name="API_runtime_PostContent_Example_1_Response"></a>

```
"HTTP/1.1 200 OK[\r][\n]"
"x-amzn-RequestId: cc8b34af-cebb-11e6-a35c-55f3a992f28d[\r][\n]"
"x-amz-lex-message: Sorry, can you repeat that?[\r][\n]"
"x-amz-lex-dialog-state: ElicitIntent[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/mpeg[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Date: Fri, 30 Dec 2016 18:14:28 GMT[\r][\n]"
"[\r][\n]"               
"2000[\r][\n]"
"ID3[0x4][0x0][0x0][0x0][0x0][0x0]#TSSE[0x0][0x0][0x0][0xf][0x0][0x0][0x3]Lavf57.41.100[0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0xff][0xf3]`[0xc4][0x0][0x1b]{[0x8d][0xe8][0x1]C[0x18][0x1][0x0]J[0xe0]`b[0xdd][0xd1][0xb][0xfd][0x11][0xdf][0xfe]";[0xbb][0xbb][0x9f][0xee][0xee][0xee][0xee]|DDD/[0xff][0xff][0xff][0xff]www?D[0xf7]w^?[0xff][0xfa]h[0x88][0x85][0xfe][0x88][0x88][0x88][[0xa2]'[0xff][0xfa]"{[0x9f][0xe8][0x88]]D[0xeb][0xbb][0xbb][0xa2]!u[0xfd][0xdd][0xdf][0x88][0x94][0x0]F[0xef][0xa1]8[0x0][0x82]w[0x88]N[0x0][0x0][0x9b][0xbb][0xe8][0xe
…
```

## Consulte também
<a name="API_runtime_PostContent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 

# PostText
<a name="API_runtime_PostText"></a>

Envia a entrada do usuário ao Amazon Lex. Os aplicativos clientes podem usar essa API para enviar solicitações ao Amazon Lex em runtime. Em seguida, o Amazon Lex interpreta a entrada do usuário usando o modelo de machine learning criado para o bot. 

 Em resposta, o Amazon Lex retorna a próxima `message` para transmitir um `responseCard` opcional ao usuário para exibir. Considere as seguintes mensagens de exemplo: 
+  Para uma entrada do usuário “Eu gostaria de uma pizza”, o Amazon Lex pode retornar uma resposta com uma mensagem gerando dados do slot (por exemplo, PizzaSize): “Qual tamanho de pizza você gostaria?” 
+  Depois que o usuário fornece todas as informações do pedido de pizza, o Amazon Lex pode retornar uma resposta com uma mensagem para obter a confirmação do usuário: “Continuar com o pedido de pizza?”. 
+  Depois que o usuário responder o prompt de confirmação com “Sim”, o Amazon Lex poderá retornar uma declaração de conclusão: “Obrigado, sua pizza de queijo foi pedida.”. 

 Nem todas as mensagens do Amazon Lex exigem uma resposta do usuário. Por exemplo, uma declaração de conclusão não exige uma resposta. Algumas mensagens exigem apenas uma resposta “sim” ou “não” do usuário. Além do `message`, o Amazon Lex fornece contexto adicional sobre a mensagem na resposta que você pode usar para aprimorar o comportamento do cliente, por exemplo, para exibir a interface de usuário apropriada do cliente. Esses são os campos `slotToElicit`, `dialogState`, `intentName` e `slots` na resposta. Considere os seguintes exemplos: 
+ Se a mensagem for para obter dados de slots, o Amazon Lex retornará as seguintes informações de contexto:
  +  `dialogState`definido como ElicitSlot 
  +  `intentName` definido como o nome da intenção no contexto atual 
  +  `slotToElicit` definido como o nome do slot para o qual `message` está obtendo informações 
  +  `slots` definido como um mapa de slots configurados para a intenção com valores atuais conhecidos 
+  Se a mensagem for um prompt de confirmação, o `dialogState` será definido como ConfirmIntent e `SlotToElicit` definido como nulo. 
+ Se a mensagem for um prompt de esclarecimento (configurado para a intenção) que indica que a intenção do usuário não foi compreendida, a `dialogState` é definida como ElicitIntent e definida como `slotToElicit` nula. 

 Além disso, o Amazon Lex também retorna seu aplicativo específico`sessionAttributes`. Para obter mais informações, consulte [Gerenciar o contexto de conversação](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Sintaxe da Solicitação
<a name="API_runtime_PostText_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/text HTTP/1.1
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "inputText": "string",
   "requestAttributes": { 
      "string" : "string" 
   },
   "sessionAttributes": { 
      "string" : "string" 
   }
}
```

## Parâmetros da Solicitação de URI
<a name="API_runtime_PostText_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [botAlias](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botAlias"></a>
O alias do bot do Amazon Lex.  
Obrigatório: Sim

 ** [botName](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botName"></a>
O nome do bot do Amazon Lex.  
Obrigatório: Sim

 ** [userId](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-userId"></a>
O ID do usuário do aplicativo cliente. O Amazon Lex usa isso para identificar a conversa de um usuário com seu bot. No runtime, cada solicitação deve conter o campo `userID`.  
Para decidir o ID de usuário a ser usado em seu aplicativo, considere os seguintes fatores.  
+ O campo `userID` não deve conter nenhuma informação de identificação pessoal do usuário, por exemplo, nome, números de identificação pessoal ou outras informações pessoais do usuário final.
+ Se você quiser que um usuário inicie uma conversa em um dispositivo e continue em outro, use um identificador específico do usuário.
+ Se você quiser que o mesmo usuário possa ter duas conversas independentes em dois dispositivos diferentes, escolha um identificador específico do dispositivo.
+ Um usuário não pode ter duas conversas independentes com duas versões diferentes do mesmo bot. Por exemplo, um usuário não pode conversar com as versões PROD e BETA do mesmo bot. Se você prevê que um usuário precisará conversar com duas versões diferentes, por exemplo, durante o teste, inclua o alias do bot no ID do usuário para separar as duas conversas.
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_runtime_PostText_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [activeContexts](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-activeContexts"></a>
Uma lista de contextos ativos para a solicitação. Um contexto pode ser ativado quando uma intenção anterior é atendida ou incluindo o contexto na solicitação,  
Se você não especificar uma lista de contextos, o Amazon Lex usará a lista atual de contextos para a sessão. Se você especificar uma lista vazia, todos os contextos da sessão serão apagados.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 20 itens.  
Obrigatório: não

 ** [inputText](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-inputText"></a>
O texto que o usuário inseriu (o Amazon Lex interpreta esse texto).  
Ao usar a AWS CLI, você não pode passar uma URL no parâmetro `--input-text`. Em vez disso, passe o URL usando o parâmetro `--cli-input-json`.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.  
Obrigatório: Sim

 ** [requestAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-requestAttributes"></a>
Informações específicas da solicitação passadas entre o Amazon Lex e um aplicativo cliente.  
O namespace `x-amz-lex:` é reservado para atributos especiais. Não crie atributos de solicitação com o prefixo `x-amz-lex:`.  
Para obter mais informações, consulte [Definição de atributos de solicitação](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).  
Tipo: mapa de string para string  
Obrigatório: não

 ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-sessionAttributes"></a>
Informações específicas do aplicativo passadas entre o Amazon Lex e um aplicativo cliente.  
Para obter mais informações, consulte [Definição de atributos de sessão](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).  
Tipo: mapa de string para string  
Obrigatório: Não

## Sintaxe da resposta
<a name="API_runtime_PostText_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "alternativeIntents": [ 
      { 
         "intentName": "string",
         "nluIntentConfidence": { 
            "score": number
         },
         "slots": { 
            "string" : "string" 
         }
      }
   ],
   "botVersion": "string",
   "dialogState": "string",
   "intentName": "string",
   "message": "string",
   "messageFormat": "string",
   "nluIntentConfidence": { 
      "score": number
   },
   "responseCard": { 
      "contentType": "string",
      "genericAttachments": [ 
         { 
            "attachmentLinkUrl": "string",
            "buttons": [ 
               { 
                  "text": "string",
                  "value": "string"
               }
            ],
            "imageUrl": "string",
            "subTitle": "string",
            "title": "string"
         }
      ],
      "version": "string"
   },
   "sentimentResponse": { 
      "sentimentLabel": "string",
      "sentimentScore": "string"
   },
   "sessionAttributes": { 
      "string" : "string" 
   },
   "sessionId": "string",
   "slots": { 
      "string" : "string" 
   },
   "slotToElicit": "string"
}
```

## Elementos de resposta
<a name="API_runtime_PostText_ResponseElements"></a>

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.

 ** [activeContexts](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-activeContexts"></a>
Uma lista de contextos ativos para a sessão. Um contexto pode ser definido quando uma intenção é cumprida ou chamando a operação `PostContent`, `PostText` ou `PutSession`.  
Você pode usar um contexto para controlar as intenções que podem acompanhar uma intenção ou para modificar a operação do seu aplicativo.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 20 itens.

 ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-alternativeIntents"></a>
Uma a quatro intenções alternativas que podem ser aplicáveis à intenção do usuário.  
Cada alternativa inclui uma pontuação que indica o grau de confiança do Amazon Lex de que a intenção corresponde à intenção do usuário. As intenções são classificadas pela pontuação de confiança.  
Tipo: matriz de objetos [PredictedIntent](API_runtime_PredictedIntent.md)  
Membros da matriz: número máximo de 4 itens.

 ** [botVersion](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-botVersion"></a>
A versão do bot que respondeu à conversa. Você pode usar essas informações para ajudar a determinar se uma versão de um bot tem um desempenho melhor do que outra versão.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Padrão: `[0-9]+|\$LATEST` 

 ** [dialogState](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-dialogState"></a>
 Identifica o estado atual da interação do usuário. O Amazon Lex retorna um dos seguintes valores como `dialogState`. Opcionalmente, o cliente pode usar essas informações para personalizar a interface do usuário.   
+  `ElicitIntent` - O Amazon Lex quer obter a intenção do usuário. 

  Por exemplo, um usuário pode expressar uma intenção (“Quero pedir uma pizza”). Se o Amazon Lex não puder deduzir a intenção do usuário a partir dessa declaração, ele retornará esse dialogState.
+  `ConfirmIntent` - O Amazon Lex espera uma resposta “sim” ou “não”. 

   Por exemplo, o Amazon Lex quer a confirmação do usuário antes de atender uma intenção. 

  Em vez de um “sim” ou “não”, um usuário pode responder com informações adicionais. Por exemplo, “sim, mas peça uma pizza de massa grossa” ou “não, quero pedir uma bebida”. O Amazon Lex pode processar essas informações adicionais (nesses exemplos, atualizar o valor do slot do tipo de crosta ou alterar a intenção de OrderPizza para OrderDrink).
+  `ElicitSlot` - O Amazon Lex espera um valor de slot para a intenção atual. 

  Por exemplo, suponha que, na resposta, o Amazon Lex envie esta mensagem: “Qual tamanho de pizza você gostaria?”. Um usuário pode responder com o valor de slot (por exemplo, “média”). O usuário também pode fornecer informações adicionais na resposta (por exemplo, “pizza média de massa grossa”). O Amazon Lex pode processar essas informações adicionais de forma adequada. 
+  `Fulfilled` - Transmite que a função do Lambda configurada para a intenção atendeu com sucesso a intenção. 
+  `ReadyForFulfillment` - Transmite que o cliente deve atender à solicitação. 
+  `Failed` - Transmite que a conversa com o usuário falhou. 

   Isso pode acontecer por vários motivos, incluindo o fato de o usuário não ter fornecido uma resposta adequada aos prompts do serviço (você pode configurar quantas vezes o Amazon Lex pode solicitar informações específicas a um usuário) ou se a função do Lambda não atendeu à intenção. 
Tipo: String  
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [intentName](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-intentName"></a>
A intenção atual do usuário que o Amazon Lex conhece.  
Tipo: String

 ** [message](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-message"></a>
A mensagem a ser transmitida ao usuário. A mensagem pode vir da configuração do bot ou de uma função do Lambda.  
Se a intenção não estiver configurada com uma função do Lambda, ou se a função do Lambda tiver retornado `Delegate` como `dialogAction.type` em sua resposta, o Amazon Lex decide o próximo curso de ação e seleciona uma mensagem apropriada da configuração do bot com base no contexto de interação atual. Por exemplo, se o Amazon Lex não conseguir entender a entrada do usuário, ele usa uma mensagem de prompt de esclarecimento.  
Ao criar uma intenção, você pode atribuir mensagens a grupos. Quando as mensagens são atribuídas a grupos, o Amazon Lex retorna uma mensagem de cada grupo na resposta. O campo de mensagem é uma string JSON de escape que contém as mensagens. Para obter mais informações sobre a estrutura da string JSON retornada, consulte [Formatos de mensagem suportados](howitworks-manage-prompts.md#msg-prompts-formats).  
Se a função do Lambda retornar uma mensagem, o Amazon Lex a enviará para o cliente em sua resposta.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

 ** [messageFormat](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-messageFormat"></a>
O formato da mensagem de resposta. Um dos seguintes valores:  
+  `PlainText` - A mensagem contém texto sem formatação UTF-8.
+  `CustomPayload` - A mensagem é um formato personalizado definido pela função do Lambda.
+  `SSML` - A mensagem contém texto formatado para saída de voz.
+  `Composite` - A mensagem contém um objeto JSON de escape que contém uma ou mais mensagens dos grupos aos quais as mensagens foram atribuídas quando a intenção foi criada.
Tipo: String  
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-nluIntentConfidence"></a>
Fornece uma pontuação que indica o quanto o Amazon Lex tem certeza de que a intenção retornada é aquela que corresponde à intenção do usuário. A pontuação está entre 0,0 e 1,0. Para obter mais informações, consulte [Pontuações de confiança](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
A pontuação é relativa, não absoluta. A pontuação pode mudar com base nas melhorias no Amazon Lex.  
Tipo: objeto [IntentConfidence](API_runtime_IntentConfidence.md)

 ** [responseCard](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-responseCard"></a>
Representa as opções que o usuário tem para responder ao prompt atual. O cartão de resposta pode vir da configuração do bot (no console Amazon Lex, escolha o botão de configurações ao lado de um slot) ou de um hook de código (função do Lambda).   
Tipo: objeto [ResponseCard](API_runtime_ResponseCard.md)

 ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sentimentResponse"></a>
O sentimento expresso em uma declaração.  
Quando o bot está configurado para enviar declarações ao Amazon Comprehend para análise de sentimentos, esse campo contém o resultado da análise.  
Tipo: objeto [SentimentResponse](API_runtime_SentimentResponse.md)

 ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionAttributes"></a>
Um mapa de pares de chaves/valores que representam as informações de contexto específicas da sessão.  
Tipo: mapa de string para string

 ** [sessionId](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionId"></a>
Um identificador exclusivo da sessão.  
Tipo: String

 ** [slots](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slots"></a>
 Os slots de intenção que o Amazon Lex detectou a partir da entrada do usuário na conversa.   
O Amazon Lex cria uma lista de resolução que contém valores prováveis para um slot. O valor que ele retorna é determinado pelo `valueSelectionStrategy` selecionado quando o tipo de slot foi criado ou atualizado. Se `valueSelectionStrategy` for definido como `ORIGINAL_VALUE`, o valor fornecido pelo usuário será retornado, se o valor do usuário for semelhante ao valor de slot. Se `valueSelectionStrategy` estiver definido como `TOP_RESOLUTION`, o Amazon Lex retornará o primeiro valor na lista de resolução ou, se não houver lista de resolução, nulo. Se `valueSelectionStrategy` não for especificado, o padrão será `ORIGINAL_VALUE`.  
Tipo: mapa de string para string

 ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slotToElicit"></a>
Se o valor `dialogState` for `ElicitSlot`, retornará o nome do slot para o qual o Amazon Lex está obtendo um valor.   
Tipo: string

## Erros
<a name="API_runtime_PostText_Errors"></a>

 ** BadGatewayException **   
Ou o bot do Amazon Lex ainda está sendo construído ou um dos serviços dependentes (Amazon Polly, AWS Lambda) falhou com um erro interno de serviço.  
Código de status HTTP: 502

 ** BadRequestException **   
 A validação da solicitação falhou, não há mensagem utilizável no contexto ou a compilação do bot falhou, ainda está em andamento ou contém alterações não criadas.   
Código de status HTTP: 400

 ** ConflictException **   
 Dois clientes estão usando a mesma conta da AWS, o bot do Amazon Lex e o mesmo ID de usuário.   
Código de Status HTTP: 409

 ** DependencyFailedException **   
 Uma das dependências, como AWS Lambda ou Amazon Polly, gerou uma exceção. Por exemplo,   
+ Se o Amazon Lex não tiver permissões suficientes para chamar uma função do Lambda.
+ Se uma função do Lambda levar mais de 30 segundos para ser executada.
+ Se uma função do Lambda de atendimento retornar uma ação `Delegate` de diálogo sem remover nenhum valor de slot.
Código de status HTTP: 424

 ** InternalFailureException **   
Erro de serviço interno. Tente a chamada novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Excedeu um limite.  
Código de status HTTP: 429

 ** LoopDetectedException **   
Essa exceção não é usada.  
Código de status HTTP: 508

 ** NotFoundException **   
O recurso (como o bot Amazon Lex ou um alias) mencionado não foi encontrado.  
Código de status HTTP: 404

## Consulte Também
<a name="API_runtime_PostText_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText) 

# PutSession
<a name="API_runtime_PutSession"></a>

Cria uma nova sessão ou modifica uma sessão existente com um bot do Amazon Lex. Use essa operação para permitir que seu aplicativo defina o estado do bot.

Para obter mais informações, consulte [Gerenciamento de sessões](https://docs.aws.amazon.com/lex/latest/dg/how-session-api.html).

## Sintaxe da Solicitação
<a name="API_runtime_PutSession_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
Accept: accept
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "dialogAction": { 
      "fulfillmentState": "string",
      "intentName": "string",
      "message": "string",
      "messageFormat": "string",
      "slots": { 
         "string" : "string" 
      },
      "slotToElicit": "string",
      "type": "string"
   },
   "recentIntentSummaryView": [ 
      { 
         "checkpointLabel": "string",
         "confirmationStatus": "string",
         "dialogActionType": "string",
         "fulfillmentState": "string",
         "intentName": "string",
         "slots": { 
            "string" : "string" 
         },
         "slotToElicit": "string"
      }
   ],
   "sessionAttributes": { 
      "string" : "string" 
   }
}
```

## Parâmetros da Solicitação de URI
<a name="API_runtime_PutSession_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [accept](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-accept"></a>
A mensagem que o Amazon Lex retorna na resposta pode ser texto ou fala dependendo do valor deste campo.  
+ Se o valor for `text/plain; charset=utf-8`, o Amazon Lex retornará o texto na resposta.
+ Se o valor começar com `audio/`, o Amazon Lex retornará a fala na resposta. O Amazon Lex usa o Amazon Polly para gerar a fala na configuração que você especificar. Por exemplo, se você especificar `audio/mpeg` como valor, o Amazon Lex retornará a fala no formato MPEG.
+ Se o valor for `audio/pcm`, a fala será retornada como `audio/pcm` no formato little-endian de 16 bits.
+ Os valores aceitos são os seguintes:
  +  `audio/mpeg` 
  +  `audio/ogg` 
  +  `audio/pcm` 
  +  `audio/*` (o padrão é mpeg)
  +  `text/plain; charset=utf-8` 

 ** [botAlias](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botAlias"></a>
O alias em uso para o bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [botName](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botName"></a>
O nome do bot que contém os dados da sessão.  
Obrigatório: Sim

 ** [userId](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-userId"></a>
O ID do usuário do aplicativo cliente. O Amazon Lex usa isso para identificar a conversa de um usuário com seu bot.   
Restrições de tamanho: tamanho mínimo 2. Comprimento máximo de 100.  
Padrão: `[0-9a-zA-Z._:-]+`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_runtime_PutSession_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [activeContexts](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-activeContexts"></a>
Uma lista de contextos ativos para a solicitação. Um contexto pode ser ativado quando uma intenção anterior é atendida ou incluindo o contexto na solicitação,  
Se você não especificar uma lista de contextos, o Amazon Lex usará a lista atual de contextos para a sessão. Se você especificar uma lista vazia, todos os contextos da sessão serão apagados.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 20 itens.  
Obrigatório: não

 ** [dialogAction](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-dialogAction"></a>
Define a próxima ação que o bot deve realizar para atender a conversa.  
Tipo: objeto [DialogAction](API_runtime_DialogAction.md)  
Obrigatório: Não

 ** [recentIntentSummaryView](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-recentIntentSummaryView"></a>
Um resumo das intenções recentes do bot. Você pode usar a visualização de resumo de intenções para definir um rótulo de ponto de verificação em uma intenção e modificar os atributos das intenções. Você também pode usá-la para remover ou adicionar objetos de resumo de intenção à lista.  
A intenção que você modifica ou adiciona à lista deve fazer sentido para o bot. Por exemplo, o nome da intenção deve ser válida para o bot. Você deve fornecer valores válidos para:  
+  `intentName` 
+ nomes de slot
+  `slotToElict` 
Se você enviar o parâmetro `recentIntentSummaryView` em uma solicitação `PutSession`, o conteúdo da nova visualização de resumo substituirá a antiga visualização de resumo. Por exemplo, se uma solicitação `GetSession` retornar três intenções na exibição de resumo e você chamar `PutSession` com uma intenção na visualização de resumo, a próxima chamada `GetSession` retornará apenas uma intenção.  
Tipo: matriz de objetos [IntentSummary](API_runtime_IntentSummary.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 3 itens.  
Obrigatório: não

 ** [sessionAttributes](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-sessionAttributes"></a>
Mapa de key/value pares representando as informações de contexto específicas da sessão. Ele contém informações do aplicativo passadas entre o Amazon Lex e um aplicativo cliente.  
Tipo: mapa de string para string  
Obrigatório: Não

## Sintaxe da resposta
<a name="API_runtime_PutSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: contentType
x-amz-lex-intent-name: intentName
x-amz-lex-slots: slots
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-message: message
x-amz-lex-encoded-message: encodedMessage
x-amz-lex-message-format: messageFormat
x-amz-lex-dialog-state: dialogState
x-amz-lex-slot-to-elicit: slotToElicit
x-amz-lex-session-id: sessionId
x-amz-lex-active-contexts: activeContexts

audioStream
```

## Elementos de resposta
<a name="API_runtime_PutSession_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

A resposta retorna os cabeçalhos HTTP a seguir.

 ** [activeContexts](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-activeContexts"></a>
Uma lista de contextos ativos para a sessão.

 ** [contentType](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-contentType"></a>
Tipo de conteúdo conforme especificado no cabeçalho HTTP `Accept` na solicitação.

 ** [dialogState](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-dialogState"></a>
  
+  `ConfirmIntent` - O Amazon Lex espera uma resposta “sim” ou “não” para confirmar a intenção antes de atendê-la.
+  `ElicitIntent` - O Amazon Lex quer obter a intenção do usuário.
+  `ElicitSlot` - O Amazon Lex espera o valor de um slot para a intenção atual.
+  `Failed` - Transmite que a conversa com o usuário falhou. Isso pode acontecer por vários motivos, incluindo o usuário não fornecer uma resposta adequada aos prompts do serviço ou a função do Lambda não atender a intenção.
+  `Fulfilled` - Transmite que a função do Lambda atendeu com sucesso a intenção.
+  `ReadyForFulfillment` - Transmite que o cliente deve atender à solicitação.
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedMessage](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-encodedMessage"></a>
A próxima mensagem que deve ser apresentada ao usuário.  
O campo `encodedMessage` é codificado em base 64. Você deve decodificar o campo antes de poder usar o valor.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.366.

 ** [intentName](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-intentName"></a>
O nome da intenção atual.

 ** [message](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-message"></a>
 *Esse cabeçalho foi descontinuado.*   
A próxima mensagem que deve ser apresentada ao usuário.  
Você só pode usar esse campo nas localidades de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. Em todas as outras localidades, o campo `message` é nulo. Em vez disso, use o campo `encodedMessage`.  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.024.

 ** [messageFormat](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-messageFormat"></a>
O formato da mensagem de resposta. Um dos seguintes valores:  
+  `PlainText` - A mensagem contém texto sem formatação UTF-8.
+  `CustomPayload` - A mensagem é um formato personalizado para o cliente.
+  `SSML` - A mensagem contém texto formatado para saída de voz.
+  `Composite` - A mensagem contém um objeto JSON de escape que contém uma ou mais mensagens dos grupos aos quais as mensagens foram atribuídas quando a intenção foi criada.
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [sessionAttributes](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionAttributes"></a>
Mapa de key/value pares representando informações de contexto específicas da sessão.

 ** [sessionId](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionId"></a>
Um identificador exclusivo da sessão.

 ** [slots](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slots"></a>
Mapa de zero ou mais slots de intenção do Amazon Lex detectados na entrada do usuário durante a conversação.  
O Amazon Lex cria uma lista de resolução que contém valores prováveis para um slot. O valor que ele retorna é determinado pelo `valueSelectionStrategy` selecionado quando o tipo de slot foi criado ou atualizado. Se `valueSelectionStrategy` for definido como `ORIGINAL_VALUE`, o valor fornecido pelo usuário será retornado, se o valor do usuário for semelhante ao valor de slot. Se `valueSelectionStrategy` estiver definido como `TOP_RESOLUTION`, o Amazon Lex retornará o primeiro valor na lista de resolução ou, se não houver lista de resolução, nulo. Se `valueSelectionStrategy` não for especificado, o padrão será `ORIGINAL_VALUE`. 

 ** [slotToElicit](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slotToElicit"></a>
Se o `dialogState` for `ElicitSlot`, retornará o nome do slot para o qual o Amazon Lex está obtendo um valor.

A resposta retorna as informações a seguir como corpo HTTP.

 ** [audioStream](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-audioStream"></a>
A versão em áudio da mensagem a ser transmitida ao usuário.

## Erros
<a name="API_runtime_PutSession_Errors"></a>

 ** BadGatewayException **   
Ou o bot do Amazon Lex ainda está sendo construído ou um dos serviços dependentes (Amazon Polly, AWS Lambda) falhou com um erro interno de serviço.  
Código de status HTTP: 502

 ** BadRequestException **   
 A validação da solicitação falhou, não há mensagem utilizável no contexto ou a compilação do bot falhou, ainda está em andamento ou contém alterações não criadas.   
Código de status HTTP: 400

 ** ConflictException **   
 Dois clientes estão usando a mesma conta da AWS, o bot do Amazon Lex e o mesmo ID de usuário.   
Código de Status HTTP: 409

 ** DependencyFailedException **   
 Uma das dependências, como AWS Lambda ou Amazon Polly, gerou uma exceção. Por exemplo,   
+ Se o Amazon Lex não tiver permissões suficientes para chamar uma função do Lambda.
+ Se uma função do Lambda levar mais de 30 segundos para ser executada.
+ Se uma função do Lambda de atendimento retornar uma ação `Delegate` de diálogo sem remover nenhum valor de slot.
Código de status HTTP: 424

 ** InternalFailureException **   
Erro de serviço interno. Tente a chamada novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Excedeu um limite.  
Código de status HTTP: 429

 ** NotAcceptableException **   
O cabeçalho de aceitação na solicitação não tem um valor válido.  
Código de status HTTP: 406

 ** NotFoundException **   
O recurso (como o bot Amazon Lex ou um alias) mencionado não foi encontrado.  
Código de status HTTP: 404

## Consulte Também
<a name="API_runtime_PutSession_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PutSession) 

# Tipos de dados
<a name="API_Types"></a>

Os seguintes tipos de dados são compatíveis com o Serviço de criação de modelos do Amazon Lex:
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

Os seguintes tipos de dados são compatíveis com o Serviço de runtime do Amazon Lex:
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# Serviço de criação de modelos do Amazon Lex
<a name="API_Types_Amazon_Lex_Model_Building_Service"></a>

Os seguintes tipos de dados são compatíveis com o Serviço de criação de modelos do Amazon Lex:
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

# BotAliasMetadata
<a name="API_BotAliasMetadata"></a>

Fornece informações sobre um alias de bot.

## Conteúdo
<a name="API_BotAliasMetadata_Contents"></a>

 ** botName **   <a name="lex-Type-BotAliasMetadata-botName"></a>
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]_?)+$`   
Obrigatório: não

 ** botVersion **   <a name="lex-Type-BotAliasMetadata-botVersion"></a>
A versão do bot do Amazon Lex 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]+`   
Obrigatório: não

 ** checksum **   <a name="lex-Type-BotAliasMetadata-checksum"></a>
Soma de verificação do alias do bot.  
Tipo: String  
Obrigatório: Não

 ** conversationLogs **   <a name="lex-Type-BotAliasMetadata-conversationLogs"></a>
Configurações que determinam como o Amazon Lex usa logs de conversa para o alias.  
Tipo: objeto [ConversationLogsResponse](API_ConversationLogsResponse.md)  
Obrigatório: não

 ** createdDate **   <a name="lex-Type-BotAliasMetadata-createdDate"></a>
A data em que o alias do bot foi criado.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** description **   <a name="lex-Type-BotAliasMetadata-description"></a>
Uma descrição do alias do bot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** lastUpdatedDate **   <a name="lex-Type-BotAliasMetadata-lastUpdatedDate"></a>
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  
Obrigatório: não

 ** name **   <a name="lex-Type-BotAliasMetadata-name"></a>
O nome do alias do bot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: Não

## Consulte também
<a name="API_BotAliasMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotAliasMetadata) 

# BotChannelAssociation
<a name="API_BotChannelAssociation"></a>

Representa uma associação entre um bot do Amazon Lex e uma plataforma externa de mensagens.

## Conteúdo
<a name="API_BotChannelAssociation_Contents"></a>

 ** botAlias **   <a name="lex-Type-BotChannelAssociation-botAlias"></a>
Um alias que aponta para a versão específica do bot do Amazon Lex à qual essa associação está sendo feita.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** botConfiguration **   <a name="lex-Type-BotChannelAssociation-botConfiguration"></a>
Fornece as informações necessárias para se comunicar com a plataforma de mensagens.   
Tipo: mapa de string para string  
Entradas do mapa: número máximo de 10 itens.  
Obrigatório: não

 ** botName **   <a name="lex-Type-BotChannelAssociation-botName"></a>
O nome do bot Amazon Lex ao qual essa associação está sendo feita.   
Atualmente, o Amazon Lex oferece suporte a associações com o Facebook, o Slack e o Twilio.
Tipo: string  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** createdDate **   <a name="lex-Type-BotChannelAssociation-createdDate"></a>
A data em que a associação entre o bot do Amazon Lex e o canal foi criada.   
Tipo: carimbo de data/hora  
Obrigatório: não

 ** description **   <a name="lex-Type-BotChannelAssociation-description"></a>
Uma descrição de texto da associação que você está criando.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** failureReason **   <a name="lex-Type-BotChannelAssociation-failureReason"></a>
Se `status` for `FAILED`, o Amazon Lex fornece o motivo da falha na criação da associação.  
Tipo: String  
Obrigatório: Não

 ** name **   <a name="lex-Type-BotChannelAssociation-name"></a>
O nome da associação entre o bot e o canal.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** status **   <a name="lex-Type-BotChannelAssociation-status"></a>
O status do canal do bot.   
+  `CREATED` - O canal foi criado e está pronto para uso.
+  `IN_PROGRESS` - A criação do canal está em andamento.
+  `FAILED` - Houve um erro ao criar o canal. Para obter informações sobre o motivo da falha, consulte o campo `failureReason`.
Tipo: string  
Valores Válidos: `IN_PROGRESS | CREATED | FAILED`   
Obrigatório: não

 ** type **   <a name="lex-Type-BotChannelAssociation-type"></a>
Especifica o tipo de associação indicando o tipo de canal que está sendo estabelecido entre o bot do Amazon Lex e a plataforma externa de mensagens.  
Tipo: string  
Valores Válidos: `Facebook | Slack | Twilio-Sms | Kik`   
Obrigatório: Não

## Consulte também
<a name="API_BotChannelAssociation_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotChannelAssociation) 

# BotMetadata
<a name="API_BotMetadata"></a>

Fornece informações sobre um bot.

## Conteúdo
<a name="API_BotMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-BotMetadata-createdDate"></a>
A data e a hora em que o bot foi criado.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** description **   <a name="lex-Type-BotMetadata-description"></a>
Uma descrição do bot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** lastUpdatedDate **   <a name="lex-Type-BotMetadata-lastUpdatedDate"></a>
A data em que o bot foi atualizado. Quando você cria um bot, a data de criação e a data da última atualização são as mesmas.   
Tipo: carimbo de data/hora  
Obrigatório: não

 ** name **   <a name="lex-Type-BotMetadata-name"></a>
O nome do bot.   
Tipo: String  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** status **   <a name="lex-Type-BotMetadata-status"></a>
O status do bot.  
Tipo: string  
Valores Válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT`   
Obrigatório: não

 ** version **   <a name="lex-Type-BotMetadata-version"></a>
A versão do bot. Para um novo bot, a versão é sempre `$LATEST`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Não

## Consulte também
<a name="API_BotMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotMetadata) 

# BuiltinIntentMetadata
<a name="API_BuiltinIntentMetadata"></a>

Fornece metadados para uma intenção integrada.

## Conteúdo
<a name="API_BuiltinIntentMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinIntentMetadata-signature"></a>
Um identificador exclusivo de uma intenção integrada. Para encontrar a assinatura de uma intenção, consulte [Intenções integradas padrão](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) no *Alexa Skills Kit*.  
Tipo: String  
Obrigatório: Não

 ** supportedLocales **   <a name="lex-Type-BuiltinIntentMetadata-supportedLocales"></a>
Uma lista de identificadores das localidades compatíveis pela intenção.  
Tipo: matriz de strings  
Valores Válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR`   
Obrigatório: Não

## Consulte também
<a name="API_BuiltinIntentMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentMetadata) 

# BuiltinIntentSlot
<a name="API_BuiltinIntentSlot"></a>

Fornece informações sobre um slot usado em uma intenção integrada.

## Conteúdo
<a name="API_BuiltinIntentSlot_Contents"></a>

 ** name **   <a name="lex-Type-BuiltinIntentSlot-name"></a>
Uma lista de slots definidos para a intenção.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_BuiltinIntentSlot_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentSlot) 

# BuiltinSlotTypeMetadata
<a name="API_BuiltinSlotTypeMetadata"></a>

Fornece informações sobre um tipo de slot integrado.

## Conteúdo
<a name="API_BuiltinSlotTypeMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinSlotTypeMetadata-signature"></a>
Um identificador exclusivo de um tipo de slot integrado. Para encontrar a assinatura de um tipo de slot, consulte [Referência do tipo de slot](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) no *Alexa Skills Kit*.  
Tipo: String  
Obrigatório: Não

 ** supportedLocales **   <a name="lex-Type-BuiltinSlotTypeMetadata-supportedLocales"></a>
Uma lista de localidades de destino para o slot.   
Tipo: matriz de strings  
Valores Válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR`   
Obrigatório: Não

## Consulte também
<a name="API_BuiltinSlotTypeMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 

# CodeHook
<a name="API_CodeHook"></a>

Especifica uma função do Lambda que verifica as solicitações feitas a um bot ou atende à solicitação do usuário a um bot.

## Conteúdo
<a name="API_CodeHook_Contents"></a>

 ** messageVersion **   <a name="lex-Type-CodeHook-messageVersion"></a>
A versão da solicitação-resposta que você deseja que o Amazon Lex use para invocar a função do Lambda. Para obter mais informações, consulte [Uso de funções do Lambda](using-lambda.md).  
Tipo: String  
Restrições de tamanho: o tamanho mínimo é 1. Tamanho máximo de 5.  
Obrigatório: sim

 ** uri **   <a name="lex-Type-CodeHook-uri"></a>
O nome do recurso da Amazon (ARN) da função do Lambda.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `arn:aws[a-zA-Z-]*:lambda:[a-z]+-[a-z]+(-[a-z]+)*-[0-9]:[0-9]{12}:function:[a-zA-Z0-9-_]+(\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})?(:[a-zA-Z0-9-_]+)?`   
Exigido: Sim

## Consulte também
<a name="API_CodeHook_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CodeHook) 

# ConversationLogsRequest
<a name="API_ConversationLogsRequest"></a>

Fornece as configurações necessárias para os logs de conversas.

## Conteúdo
<a name="API_ConversationLogsRequest_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsRequest-iamRoleArn"></a>
O Amazon Resource Name (ARN) de uma função do IAM com permissão para gravar em seus CloudWatch registros para registros de texto e em seu bucket do S3 para registros de áudio. Se a criptografia de áudio estiver habilitada, essa função também fornecerá permissão de acesso à chave do AWS KMS usada para criptografar logs de áudio. Para obter mais informações, consulte [Criação de um perfil e política do IAM para logs de conversas](https://docs.aws.amazon.com/lex/latest/dg/conversation-logs-role-and-policy.html).  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Exigido: Sim

 ** logSettings **   <a name="lex-Type-ConversationLogsRequest-logSettings"></a>
Configurações para seus logs de conversas. Você pode registrar em log o texto da conversa, o áudio da conversa ou ambos.  
Tipo: matriz de objetos [LogSettingsRequest](API_LogSettingsRequest.md)  
Obrigatório: sim

## Consulte também
<a name="API_ConversationLogsRequest_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsRequest) 

# ConversationLogsResponse
<a name="API_ConversationLogsResponse"></a>

Contém informações sobre as configurações do log de conversas.

## Conteúdo
<a name="API_ConversationLogsResponse_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsResponse-iamRoleArn"></a>
O Amazon Resource Name (ARN) da função do IAM usado para gravar seus registros no Logs ou em um CloudWatch bucket do S3.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obrigatório: não

 ** logSettings **   <a name="lex-Type-ConversationLogsResponse-logSettings"></a>
Configurações para seus logs de conversas. Você pode registrar em log texto, áudio ou ambos.  
Tipo: matriz de objetos [LogSettingsResponse](API_LogSettingsResponse.md)  
Obrigatório: Não

## Consulte também
<a name="API_ConversationLogsResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsResponse) 

# EnumerationValue
<a name="API_EnumerationValue"></a>

Cada tipo de slot pode ter um conjunto de valores. Cada valor de enumeração representa um valor que o tipo de slot pode ter. 

Por exemplo, um bot de pedido de pizza pode ter um tipo de slot que especifica o tipo de massa que a pizza deve ter. O tipo de slot pode incluir os valores 
+ grossa
+ fina
+ recheada

## Conteúdo
<a name="API_EnumerationValue_Contents"></a>

 ** value **   <a name="lex-Type-EnumerationValue-value"></a>
O valor do tipo de slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Obrigatório: sim

 ** synonyms **   <a name="lex-Type-EnumerationValue-synonyms"></a>
Valores adicionais relacionados ao valor do tipo de slot.  
Tipo: matriz de strings  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Obrigatório: Não

## Consulte também
<a name="API_EnumerationValue_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/EnumerationValue) 

# FollowUpPrompt
<a name="API_FollowUpPrompt"></a>

Um prompt de atividade adicional após a realização de uma intenção. Por exemplo, depois que a intenção `OrderPizza` for atendida, você pode perguntar ao usuário para saber se ele quer pedir uma bebida.

## Conteúdo
<a name="API_FollowUpPrompt_Contents"></a>

 ** prompt **   <a name="lex-Type-FollowUpPrompt-prompt"></a>
Solicita informações do usuário.   
Tipo: objeto [Prompt](API_Prompt.md)  
Obrigatório: sim

 ** rejectionStatement **   <a name="lex-Type-FollowUpPrompt-rejectionStatement"></a>
Quando o usuário responde “não” à pergunta definida no campo `prompt`, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.   
Tipo: objeto [Statement](API_Statement.md)  
Obrigatório: sim

## Consulte também
<a name="API_FollowUpPrompt_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FollowUpPrompt) 

# FulfillmentActivity
<a name="API_FulfillmentActivity"></a>

 Descreve como a intenção é atendida depois que o usuário fornece todas as informações necessárias para a intenção. Você pode fornecer uma função do Lambda ou configurar a intenção para retornar as informações da intenção ao aplicativo cliente. Recomendamos que você use uma função do Lambda para que a lógica relevante resida na nuvem e limite o código do lado do cliente principalmente à apresentação. Se precisar atualizar a lógica, atualize apenas a função do Lambda; você não precisa atualizar seu aplicativo cliente. 

Considere os seguintes exemplos:
+ Em um aplicativo de pedidos de pizza, depois que o usuário fornece todas as informações para fazer um pedido, você usa a função do Lambda para fazer um pedido em uma pizzaria. 
+ Em um aplicativo de jogos, quando um usuário diz “pegue uma pedra”, essas informações devem voltar para o aplicativo cliente para que ele possa realizar a operação e atualizar os gráficos. Nesse caso, você deseja que o Amazon Lex retorne os dados da intenção ao cliente. 

## Conteúdo
<a name="API_FulfillmentActivity_Contents"></a>

 ** type **   <a name="lex-Type-FulfillmentActivity-type"></a>
 Como a intenção deve ser cumprida, seja executando uma função do Lambda ou retornando os dados do slot para o aplicativo cliente.   
Tipo: string  
Valores Válidos: `ReturnIntent | CodeHook`   
Obrigatório: sim

 ** codeHook **   <a name="lex-Type-FulfillmentActivity-codeHook"></a>
 Uma descrição da função do Lambda que é executada para atender a intenção.   
Tipo: objeto [CodeHook](API_CodeHook.md)  
Obrigatório: Não

## Consulte também
<a name="API_FulfillmentActivity_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FulfillmentActivity) 

# InputContext
<a name="API_InputContext"></a>

O nome de um contexto que deve estar ativo para que uma intenção seja selecionada pelo Amazon Lex.

## Conteúdo
<a name="API_InputContext_Contents"></a>

 ** name **   <a name="lex-Type-InputContext-name"></a>
O nome do contexto.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Exigido: Sim

## Consulte também
<a name="API_InputContext_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/InputContext) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/InputContext) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/InputContext) 

# Intent
<a name="API_Intent"></a>

Identifica uma versão específica de uma intenção.

## Conteúdo
<a name="API_Intent_Contents"></a>

 ** intentName **   <a name="lex-Type-Intent-intentName"></a>
O nome da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Exigido: Sim

 ** intentVersion **   <a name="lex-Type-Intent-intentVersion"></a>
A versão da intenção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Exigido: Sim

## Consulte também
<a name="API_Intent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Intent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Intent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Intent) 

# IntentMetadata
<a name="API_IntentMetadata"></a>

Fornece informações sobre uma intenção.

## Conteúdo
<a name="API_IntentMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-IntentMetadata-createdDate"></a>
A data em que a intenção foi criada.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** description **   <a name="lex-Type-IntentMetadata-description"></a>
Uma descrição da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** lastUpdatedDate **   <a name="lex-Type-IntentMetadata-lastUpdatedDate"></a>
A data em que a intenção foi atualizada. Quando você cria uma intenção, a data de criação e a data da última atualização são as mesmas.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** name **   <a name="lex-Type-IntentMetadata-name"></a>
O nome da intenção.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** version **   <a name="lex-Type-IntentMetadata-version"></a>
A versão da intenção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Não

## Consulte também
<a name="API_IntentMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/IntentMetadata) 

# KendraConfiguration
<a name="API_KendraConfiguration"></a>

Fornece informações de configuração para o AMAZON. KendraSearchIntentintenção. Quando você usa essa intenção, o Amazon Lex pesquisa o índice do Amazon Kendra especificado e retorna documentos do índice que correspondem à declaração do usuário. Para obter mais informações, consulte [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).

## Conteúdo
<a name="API_KendraConfiguration_Contents"></a>

 ** kendraIndex **   <a name="lex-Type-KendraConfiguration-kendraIndex"></a>
O Amazon Resource Name (ARN) do índice Amazon Kendra que você deseja que seja o AMAZON. KendraSearchIntent intenção de pesquisar. O índice precisa estar na mesma conta e região que o bot do Amazon Lex. Se o índice do Amazon Kendra não existir, você receberá uma exceção ao chamar a operação `PutIntent`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `arn:aws:kendra:[a-z]+-[a-z]+-[0-9]:[0-9]{12}:index\/[a-zA-Z0-9][a-zA-Z0-9_-]*`   
Exigido: Sim

 ** role **   <a name="lex-Type-KendraConfiguration-role"></a>
O nome do recurso da Amazon (ARN) de um perfil do IAM que tem permissão para pesquisar o índice do Amazon Kendra. O perfil precisa estar na mesma conta e região que o bot do Amazon Lex. Se o perfil não existir, você receberá uma exceção ao chamar a operação `PutIntent`.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `arn:aws:iam::[0-9]{12}:role/.*`   
Exigido: Sim

 ** queryFilterString **   <a name="lex-Type-KendraConfiguration-queryFilterString"></a>
Um filtro de consulta que o Amazon Lex envia ao Amazon Kendra para filtrar a resposta de uma consulta. O filtro está no formato definido pelo Amazon Kendra. Para obter mais informações, consulte [Filtragem de consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).  
Você pode substituir essa string de filtro por uma nova string de filtro em runtime.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0.  
Obrigatório: Não

## Consulte também
<a name="API_KendraConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/KendraConfiguration) 

# LogSettingsRequest
<a name="API_LogSettingsRequest"></a>

Configurações usadas para configurar o modo de entrega e o destino dos logs de conversas.

## Conteúdo
<a name="API_LogSettingsRequest_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsRequest-destination"></a>
Onde os logs serão entregues. Os registros de texto são enviados para um grupo de CloudWatch registros de registros. Os logs de áudio são entregues em um bucket do S3.  
Tipo: string  
Valores Válidos: `CLOUDWATCH_LOGS | S3`   
Obrigatório: sim

 ** logType **   <a name="lex-Type-LogSettingsRequest-logType"></a>
O tipo de logs a ser habilitado. Os registros de texto são enviados para um grupo de CloudWatch registros de registros. Os logs de áudio são entregues em um bucket do S3.  
Tipo: string  
Valores Válidos: `AUDIO | TEXT`   
Obrigatório: sim

 ** resourceArn **   <a name="lex-Type-LogSettingsRequest-resourceArn"></a>
O Amazon Resource Name (ARN) do grupo de registros de CloudWatch registros ou do bucket do S3 em que os registros devem ser entregues.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:(?:logs:[\w\-]+:[\d]{12}:log-group:[\.\-_/#A-Za-z0-9]{1,512}(?::\*)?|s3:::[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9])$`   
Exigido: Sim

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsRequest-kmsKeyArn"></a>
O nome do recurso da Amazon (ARN) da chave gerenciada pelo cliente do AWS KMS do para criptografar logs de áudio entregues a um bucket do S3. A chave não se aplica aos CloudWatch registros e é opcional para buckets do S3.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Obrigatório: Não

## Consulte também
<a name="API_LogSettingsRequest_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsRequest) 

# LogSettingsResponse
<a name="API_LogSettingsResponse"></a>

As configurações para seus logs de conversas.

## Conteúdo
<a name="API_LogSettingsResponse_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsResponse-destination"></a>
O destino em que os logs são entregues.  
Tipo: string  
Valores Válidos: `CLOUDWATCH_LOGS | S3`   
Obrigatório: não

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsResponse-kmsKeyArn"></a>
O nome do recurso da Amazon (ARN) da chave usada para criptografar logs de áudio em um bucket do S3.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Obrigatório: não

 ** logType **   <a name="lex-Type-LogSettingsResponse-logType"></a>
O tipo de log que está ativado.  
Tipo: string  
Valores Válidos: `AUDIO | TEXT`   
Obrigatório: não

 ** resourceArn **   <a name="lex-Type-LogSettingsResponse-resourceArn"></a>
O Amazon Resource Name (ARN) do grupo de registros de CloudWatch registros ou bucket do S3 em que os registros são entregues.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:(?:logs:[\w\-]+:[\d]{12}:log-group:[\.\-_/#A-Za-z0-9]{1,512}(?::\*)?|s3:::[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9])$`   
Obrigatório: não

 ** resourcePrefix **   <a name="lex-Type-LogSettingsResponse-resourcePrefix"></a>
O prefixo do recurso é a primeira parte da chave de objeto do S3 dentro do bucket do S3 que você especificou para conter logs de áudio. Para CloudWatch registros, é o prefixo do nome do fluxo de registros dentro do grupo de registros que você especificou.   
Tipo: string  
Restrições de comprimento: comprimento máximo de 1024.  
Obrigatório: Não

## Consulte também
<a name="API_LogSettingsResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsResponse) 

# Message
<a name="API_Message"></a>

O objeto de mensagem que fornece o texto e o tipo da mensagem.

## Conteúdo
<a name="API_Message_Contents"></a>

 ** content **   <a name="lex-Type-Message-content"></a>
O texto da mensagem.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.000.  
Obrigatório: sim

 ** contentType **   <a name="lex-Type-Message-contentType"></a>
O tipo do conteúdo do string de mensagem.  
Tipo: string  
Valores Válidos: `PlainText | SSML | CustomPayload`   
Obrigatório: sim

 ** groupNumber **   <a name="lex-Type-Message-groupNumber"></a>
Identifica o grupo de mensagens ao qual a mensagem pertence. Quando um grupo é atribuído a uma mensagem, o Amazon Lex retorna uma mensagem de cada grupo na resposta.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 5.  
Obrigatório: Não

## Consulte também
<a name="API_Message_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Message) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Message) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Message) 

# MigrationAlert
<a name="API_MigrationAlert"></a>

Fornece informações sobre alertas e avisos que o Amazon Lex envia durante uma migração. Os alertas incluem informações sobre como resolver o problema.

## Conteúdo
<a name="API_MigrationAlert_Contents"></a>

 ** details **   <a name="lex-Type-MigrationAlert-details"></a>
Detalhes adicionais sobre o alerta.  
Tipo: matriz de strings  
Obrigatório: não

 ** message **   <a name="lex-Type-MigrationAlert-message"></a>
Uma mensagem que descreve por que o alerta foi emitido.  
Tipo: String  
Obrigatório: Não

 ** referenceURLs **   <a name="lex-Type-MigrationAlert-referenceURLs"></a>
Um link para a documentação do Amazon Lex que descreve como resolver o alerta.  
Tipo: matriz de strings  
Obrigatório: não

 ** type **   <a name="lex-Type-MigrationAlert-type"></a>
O tipo de alerta. Há dois tipos de alertas:  
+  `ERROR` - Houve um problema com a migração que não pode ser resolvido. A migração é interrompida.
+  `WARN` - Houve um problema com a migração que exige alterações manuais no novo bot do Amazon Lex V2. A migração continua.
Tipo: string  
Valores Válidos: `ERROR | WARN`   
Obrigatório: Não

## Consulte também
<a name="API_MigrationAlert_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationAlert) 

# MigrationSummary
<a name="API_MigrationSummary"></a>

Fornece informações sobre como migrar um bot do Amazon Lex V1 para o Amazon Lex V2.

## Conteúdo
<a name="API_MigrationSummary_Contents"></a>

 ** migrationId **   <a name="lex-Type-MigrationSummary-migrationId"></a>
O identificador exclusivo que o Amazon Lex atribuiu à migração.  
Tipo: String  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$`   
Obrigatório: não

 ** migrationStatus **   <a name="lex-Type-MigrationSummary-migrationStatus"></a>
O status da operação. Quando o status é `COMPLETE`, o bot fica disponível no Amazon Lex V2. Pode haver alertas e avisos que precisem ser resolvidos para concluir a migração.  
Tipo: String  
Valores Válidos: `IN_PROGRESS | COMPLETED | FAILED`   
Obrigatório: não

 ** migrationStrategy **   <a name="lex-Type-MigrationSummary-migrationStrategy"></a>
A estratégia usada para conduzir a migração.  
Tipo: String  
Valores Válidos: `CREATE_NEW | UPDATE_EXISTING`   
Obrigatório: não

 ** migrationTimestamp **   <a name="lex-Type-MigrationSummary-migrationTimestamp"></a>
A data e hora em que a migração foi iniciada.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** v1BotLocale **   <a name="lex-Type-MigrationSummary-v1BotLocale"></a>
A localidade do bot do Amazon Lex V1 que é a origem da migração.  
Tipo: string  
Valores Válidos: `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR`   
Obrigatório: não

 ** v1BotName **   <a name="lex-Type-MigrationSummary-v1BotName"></a>
O nome do bot do Amazon Lex V1 que é a origem da migração.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** v1BotVersion **   <a name="lex-Type-MigrationSummary-v1BotVersion"></a>
A versão do bot do Amazon Lex V1 que é a origem da migração.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: não

 ** v2BotId **   <a name="lex-Type-MigrationSummary-v2BotId"></a>
O identificador exclusivo do Amazon Lex V2 que é o destino da migração.  
Tipo: string  
Restrições de tamanho: tamanho fixo de 10.  
Padrão: `^[0-9a-zA-Z]+$`   
Obrigatório: não

 ** v2BotRole **   <a name="lex-Type-MigrationSummary-v2BotRole"></a>
O perfil do IAM que o Amazon Lex usa para executar a versão do bot do Amazon Lex V2.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obrigatório: Não

## Consulte também
<a name="API_MigrationSummary_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationSummary) 

# OutputContext
<a name="API_OutputContext"></a>

A especificação de um contexto de saída que é definido quando uma intenção é atendida.

## Conteúdo
<a name="API_OutputContext_Contents"></a>

 ** name **   <a name="lex-Type-OutputContext-name"></a>
O nome do contexto.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Exigido: Sim

 ** timeToLiveInSeconds **   <a name="lex-Type-OutputContext-timeToLiveInSeconds"></a>
O número de segundos em que o contexto deve estar ativo após ser enviado pela primeira vez em uma resposta `PostText` ou `PostContent`. Você pode definir o valor entre 5 e 86.400 segundos (24 horas).  
Tipo: inteiro  
Faixa válida: valor mínimo de 5. Valor máximo de 86.400.  
Obrigatório: sim

 ** turnsToLive **   <a name="lex-Type-OutputContext-turnsToLive"></a>
O número de turnos de conversação em que o contexto deve ficar ativo. Um turno de conversa é uma solicitação `PostContent` ou `PostText` e a resposta correspondente do Amazon Lex.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 20.  
Obrigatório: sim

## Consulte também
<a name="API_OutputContext_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/OutputContext) 

# Prompt
<a name="API_Prompt"></a>

Obtém informações do usuário. Para definir um prompt, forneça uma ou mais mensagens e especifique o número de tentativas de obter informações do usuário. Se você fornecer mais de uma mensagem, o Amazon Lex escolherá uma das mensagens para usar para avisar o usuário. Para obter mais informações, consulte [Amazon Lex: como funciona](how-it-works.md).

## Conteúdo
<a name="API_Prompt_Contents"></a>

 ** maxAttempts **   <a name="lex-Type-Prompt-maxAttempts"></a>
O número de vezes para solicitar informações ao usuário.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 5.  
Obrigatório: sim

 ** messages **   <a name="lex-Type-Prompt-messages"></a>
Uma matriz de objetos, em que cada uma fornece uma string de mensagem e seu tipo. Você pode especificar a string da mensagem em texto sem formatação ou em Linguagem de marcação de síntese de fala (SSML).  
Tipo: Matriz de objetos [Message](API_Message.md)  
Membros da matriz: número mínimo de 1 item. Número máximo de 15 itens.  
Obrigatório: sim

 ** responseCard **   <a name="lex-Type-Prompt-responseCard"></a>
Um cartão de resposta. O Amazon Lex usa esse prompt em runtime, na resposta `PostText` da API. Ele substitui os atributos da sessão e os valores de slot pelos espaços reservados no cartão de resposta. Para obter mais informações, consulte [Exemplo: uso de um cartão de resposta](ex-resp-card.md).   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 50.000.  
Obrigatório: Não

## Consulte também
<a name="API_Prompt_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Prompt) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Prompt) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Prompt) 

# ResourceReference
<a name="API_ResourceReference"></a>

Descreve o recurso que se refere ao recurso que você está tentando excluir. Esse objeto é retornado como parte da exceção `ResourceInUseException`. 

## Conteúdo
<a name="API_ResourceReference_Contents"></a>

 ** name **   <a name="lex-Type-ResourceReference-name"></a>
O nome do recurso que está usando o recurso que você está tentando excluir.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `[a-zA-Z_]+`   
Obrigatório: não

 ** version **   <a name="lex-Type-ResourceReference-version"></a>
A versão do recurso que está usando o recurso que você está tentando excluir.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Não

## Consulte também
<a name="API_ResourceReference_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ResourceReference) 

# Slot
<a name="API_Slot"></a>

Identifica uma versão de um slot específico.

## Conteúdo
<a name="API_Slot_Contents"></a>

 ** name **   <a name="lex-Type-Slot-name"></a>
O nome do slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z](-|_|.)?)+$`   
Exigido: Sim

 ** slotConstraint **   <a name="lex-Type-Slot-slotConstraint"></a>
Especifica se o slot é obrigatório ou opcional.   
Tipo: string  
Valores Válidos: `Required | Optional`   
Obrigatório: sim

 ** defaultValueSpec **   <a name="lex-Type-Slot-defaultValueSpec"></a>
Uma lista de valores padrão para o slot. Os valores padrão serão usados quando o Amazon Lex não determinar um valor para o slot. Você pode especificar valores padrão a partir de variáveis de contexto, atributos de sessão e valores definidos.  
Tipo: objeto [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md)  
Obrigatório: não

 ** description **   <a name="lex-Type-Slot-description"></a>
Uma descrição do slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** obfuscationSetting **   <a name="lex-Type-Slot-obfuscationSetting"></a>
Determina se um slot está ofuscado nos logs de conversas e nas declarações armazenadas. Quando você ofusca um slot, o valor é substituído pelo nome do slot entre colchetes (\$1\$1). Por exemplo, se o nome do slot for “full\$1name”, os valores ofuscados serão substituídos por “\$1full\$1name\$1”. Para obter mais informações, consulte [Ofuscação de slots](https://docs.aws.amazon.com/lex/latest/dg/how-obfuscate.html).   
Tipo: string  
Valores Válidos: `NONE | DEFAULT_OBFUSCATION`   
Obrigatório: não

 ** priority **   <a name="lex-Type-Slot-priority"></a>
 Informa ao Amazon Lex a ordem na qual o valor de slot do usuário deve ser obtido. Por exemplo, se a intenção tiver dois slots com prioridades 1 e 2, o AWS Amazon Lex primeiro obtém um valor para o slot com prioridade 1.  
Se vários slots compartilharem a mesma prioridade, a ordem na qual o Amazon Lex extrai valores é arbitrária.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 0. Valor máximo de 100.  
Obrigatório: não

 ** responseCard **   <a name="lex-Type-Slot-responseCard"></a>
 Um conjunto de respostas possíveis para o tipo de slot usado por clientes baseados em texto. Um usuário escolhe uma opção no cartão de resposta, em vez de usar texto para responder.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 50.000.  
Obrigatório: não

 ** sampleUtterances **   <a name="lex-Type-Slot-sampleUtterances"></a>
 Se você conhecer um padrão específico com que os usuários poderão responder a uma solicitação do Amazon Lex para um valor de slot, poderá fornecer essas declarações para melhorar a precisão. Isso é opcional. Na maioria dos casos, o Amazon Lex conseguirá entender as declarações do usuário.   
Tipo: matriz de strings  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Obrigatório: não

 ** slotType **   <a name="lex-Type-Slot-slotType"></a>
O tipo do slot, seja um tipo de slot personalizado que você definiu ou um dos tipos de slot incorporado.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obrigatório: não

 ** slotTypeVersion **   <a name="lex-Type-Slot-slotTypeVersion"></a>
A versão do tipo de slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: não

 ** valueElicitationPrompt **   <a name="lex-Type-Slot-valueElicitationPrompt"></a>
O prompt que o Amazon Lex usa para instigar o valor de slot do usuário.  
Tipo: objeto [Prompt](API_Prompt.md)  
Obrigatório: Não

## Consulte também
<a name="API_Slot_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Slot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Slot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Slot) 

# SlotDefaultValue
<a name="API_SlotDefaultValue"></a>

Um valor padrão para um slot.

## Conteúdo
<a name="API_SlotDefaultValue_Contents"></a>

 ** defaultValue **   <a name="lex-Type-SlotDefaultValue-defaultValue"></a>
O valor padrão para o slot. É possível especificar um dos seguintes:  
+  `#context-name.slot-name` - O valor de slot “slot-name” no contexto “context-name”.
+  `{attribute}` - O valor de slot do atributo “attribute” da sessão.
+  `'value'` - O valor discreto “value”.
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 202.  
Obrigatório: sim

## Consulte também
<a name="API_SlotDefaultValue_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValue) 

# SlotDefaultValueSpec
<a name="API_SlotDefaultValueSpec"></a>

Contém os valores padrão para o slot. Os valores padrão serão usados quando o Amazon Lex não determinar um valor para o slot.

## Conteúdo
<a name="API_SlotDefaultValueSpec_Contents"></a>

 ** defaultValueList **   <a name="lex-Type-SlotDefaultValueSpec-defaultValueList"></a>
Os valores padrão para o slot. Você pode especificar mais de um padrão. Por exemplo, você pode especificar um valor padrão a ser usado a partir de uma variável de contexto correspondente, um atributo de sessão ou um valor fixo.  
O valor padrão escolhido é selecionado com base na ordem em que você os especifica na lista. Por exemplo, se você especificar uma variável de contexto e um valor fixo nessa ordem, o Amazon Lex usará a variável de contexto se ela estiver disponível, caso contrário, usará o valor fixo.  
Tipo: matriz de objetos [SlotDefaultValue](API_SlotDefaultValue.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.  
Obrigatório: sim

## Consulte também
<a name="API_SlotDefaultValueSpec_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValueSpec) 

# SlotTypeConfiguration
<a name="API_SlotTypeConfiguration"></a>

Fornece as informações de configuração para um tipo de slot.

## Conteúdo
<a name="API_SlotTypeConfiguration_Contents"></a>

 ** regexConfiguration **   <a name="lex-Type-SlotTypeConfiguration-regexConfiguration"></a>
Uma expressão regular usada para validar o valor de slot.  
Tipo: objeto [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md)  
Obrigatório: Não

## Consulte também
<a name="API_SlotTypeConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeConfiguration) 

# SlotTypeMetadata
<a name="API_SlotTypeMetadata"></a>

Fornece informações sobre um tipo de slot.

## Conteúdo
<a name="API_SlotTypeMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-SlotTypeMetadata-createdDate"></a>
A data em que o tipo de slot foi criado.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** description **   <a name="lex-Type-SlotTypeMetadata-description"></a>
Uma descrição do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Obrigatório: não

 ** lastUpdatedDate **   <a name="lex-Type-SlotTypeMetadata-lastUpdatedDate"></a>
A data em que o tipo de slot 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  
Obrigatório: não

 ** name **   <a name="lex-Type-SlotTypeMetadata-name"></a>
O nome do tipo de slot.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Obrigatório: não

 ** version **   <a name="lex-Type-SlotTypeMetadata-version"></a>
A versão do tipo de slot.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: Não

## Consulte também
<a name="API_SlotTypeMetadata_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeMetadata) 

# SlotTypeRegexConfiguration
<a name="API_SlotTypeRegexConfiguration"></a>

Fornece uma expressão regular usada para validar o valor do slot.

## Conteúdo
<a name="API_SlotTypeRegexConfiguration_Contents"></a>

 ** pattern **   <a name="lex-Type-SlotTypeRegexConfiguration-pattern"></a>
Uma expressão regular usada para validar o valor de slot.   
Use uma expressão regular padrão. O Amazon Lex suporta os seguintes caracteres na expressão regular:  
+ A-Z, a-z
+ 0-9
+ Caracteres unicode ("\$1 u<Unicode>")
Representa caracteres unicode com quatro dígitos, como "\$1u0041" ou "\$1u005A".  
Os seguintes operadores de expressão regular não são aceitos:  
+ Repetidores infinitos: \$1, \$1 ou \$1x,\$1 sem limite superior.
+ Curinga (.)
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Obrigatório: sim

## Consulte também
<a name="API_SlotTypeRegexConfiguration_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeRegexConfiguration) 

# Statement
<a name="API_Statement"></a>

Uma coleção de mensagens que transmitem informações ao usuário. Em runtime, o Amazon Lex seleciona a mensagem a ser transmitida. 

## Conteúdo
<a name="API_Statement_Contents"></a>

 ** messages **   <a name="lex-Type-Statement-messages"></a>
Uma coleção de objetos de mensagem.  
Tipo: Matriz de objetos [Message](API_Message.md)  
Membros da matriz: número mínimo de 1 item. Número máximo de 15 itens.  
Obrigatório: sim

 ** responseCard **   <a name="lex-Type-Statement-responseCard"></a>
 Em tempo de execução, se o cliente estiver usando a [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)API, o Amazon Lex incluirá o cartão de resposta na resposta. Ele substitui todos os atributos da sessão e os valores de slots pelos espaços reservados no cartão de resposta.   
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 50.000.  
Obrigatório: Não

## Consulte também
<a name="API_Statement_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Statement) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Statement) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Statement) 

# Tag
<a name="API_Tag"></a>

Uma lista de pares de chave/valor que identificam um bot, um alias de bot ou um canal de bot. Os caracteres permitidos para chaves e valores são letras Unicode, dígitos, espaço em branco e qualquer um dos seguintes símbolos: \$1 . : / = \$1 - @. 

## Conteúdo
<a name="API_Tag_Contents"></a>

 ** key **   <a name="lex-Type-Tag-key"></a>
A chave para a tag. As chaves não diferenciam maiúsculas de minúsculas.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.  
Obrigatório: sim

 ** value **   <a name="lex-Type-Tag-value"></a>
O valor a ser associado a uma chave. O valor pode ser uma string vazia, mas não pode ser nulo.  
Tipo: string  
Restrições de tamanho: o tamanho mínimo é 0. O tamanho máximo é 256.  
Obrigatório: sim

## Consulte também
<a name="API_Tag_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Tag) 

# UtteranceData
<a name="API_UtteranceData"></a>

Fornece informações sobre uma única declaração que foi feita para seu bot. 

## Conteúdo
<a name="API_UtteranceData_Contents"></a>

 ** count **   <a name="lex-Type-UtteranceData-count"></a>
O número de vezes em que a declaração foi processada.  
Tipo: inteiro  
Obrigatório: não

 ** distinctUsers **   <a name="lex-Type-UtteranceData-distinctUsers"></a>
O número total de indivíduos que usaram a declaração.  
Tipo: número inteiro  
Obrigatório: não

 ** firstUtteredDate **   <a name="lex-Type-UtteranceData-firstUtteredDate"></a>
A data em que a declaração foi registrada pela primeira vez.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** lastUtteredDate **   <a name="lex-Type-UtteranceData-lastUtteredDate"></a>
A data em que a declaração foi registrada pela última vez.  
Tipo: carimbo de data/hora  
Obrigatório: não

 ** utteranceString **   <a name="lex-Type-UtteranceData-utteranceString"></a>
O texto que foi inserido pelo usuário ou a representação de texto de um clipe de áudio.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.000.  
Obrigatório: Não

## Consulte também
<a name="API_UtteranceData_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceData) 

# UtteranceList
<a name="API_UtteranceList"></a>

Fornece uma lista de declarações que foram feitas para uma versão específica do seu bot. A lista contém no máximo 100 declarações.

## Conteúdo
<a name="API_UtteranceList_Contents"></a>

 ** botVersion **   <a name="lex-Type-UtteranceList-botVersion"></a>
A versão do bot que processou a lista.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.  
Padrão: `\$LATEST|[0-9]+`   
Obrigatório: não

 ** utterances **   <a name="lex-Type-UtteranceList-utterances"></a>
Um ou mais objetos [UtteranceData](API_UtteranceData.md) que contêm informações sobre as declarações feitas a um bot. O número máximo de objetos é 100.  
Tipo: matriz de objetos [UtteranceData](API_UtteranceData.md)  
Obrigatório: Não

## Consulte também
<a name="API_UtteranceList_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceList) 

# Serviço de runtime do Amazon Lex
<a name="API_Types_Amazon_Lex_Runtime_Service"></a>

Os seguintes tipos de dados são compatíveis com o Serviço de runtime do Amazon Lex:
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# ActiveContext
<a name="API_runtime_ActiveContext"></a>

Um contexto é uma variável que contém informações sobre o estado atual da conversa entre um usuário e o Amazon Lex. O contexto pode ser definido automaticamente pelo Amazon Lex quando uma intenção é cumprida ou pode ser definido em runtime usando a operação `PutContent`, `PutText` ou `PutSession`.

## Conteúdo
<a name="API_runtime_ActiveContext_Contents"></a>

 ** name **   <a name="lex-Type-runtime_ActiveContext-name"></a>
O nome do contexto.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.  
Padrão: `^([A-Za-z]_?)+$`   
Exigido: Sim

 ** parameters **   <a name="lex-Type-runtime_ActiveContext-parameters"></a>
Variáveis de estado para o contexto atual. Você pode usar esses valores como valores padrão para slots em eventos subsequentes.  
Tipo: mapa de string para string  
Entradas do mapa: número mínimo de 0 itens. Número máximo de 10 itens.  
Restrições de tamanho de chave: tamanho mínimo 1. Comprimento máximo de 100.  
Restrições de tamanho do valor: tamanho mínimo 1. Tamanho máximo de 1.024.  
Obrigatório: sim

 ** timeToLive **   <a name="lex-Type-runtime_ActiveContext-timeToLive"></a>
O intervalo de tempo ou o número de turnos em que um contexto permanece ativo.  
Tipo: objeto [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md)  
Obrigatório: sim

## Consulte também
<a name="API_runtime_ActiveContext_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContext) 

# ActiveContextTimeToLive
<a name="API_runtime_ActiveContextTimeToLive"></a>

O intervalo de tempo ou o número de turnos em que um contexto permanece ativo.

## Conteúdo
<a name="API_runtime_ActiveContextTimeToLive_Contents"></a>

 ** timeToLiveInSeconds **   <a name="lex-Type-runtime_ActiveContextTimeToLive-timeToLiveInSeconds"></a>
O número de segundos em que o contexto deve estar ativo após ser enviado pela primeira vez em uma resposta `PostText` ou `PostContent`. Você pode definir o valor entre 5 e 86.400 segundos (24 horas).  
Tipo: inteiro  
Faixa válida: valor mínimo de 5. Valor máximo de 86.400.  
Obrigatório: não

 ** turnsToLive **   <a name="lex-Type-runtime_ActiveContextTimeToLive-turnsToLive"></a>
O número de turnos de conversação em que o contexto deve ficar ativo. Um turno de conversa é uma solicitação `PostContent` ou `PostText` e a resposta correspondente do Amazon Lex.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 20.  
Obrigatório: Não

## Consulte também
<a name="API_runtime_ActiveContextTimeToLive_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContextTimeToLive) 

# Button
<a name="API_runtime_Button"></a>

Representa uma opção a ser exibida na plataforma do cliente (Facebook, Slack etc.)

## Conteúdo
<a name="API_runtime_Button_Contents"></a>

 ** text **   <a name="lex-Type-runtime_Button-text"></a>
Texto visível para o usuário no botão.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 15.  
Obrigatório: sim

 ** value **   <a name="lex-Type-runtime_Button-value"></a>
O valor enviado para o Amazon Lex quando um usuário escolhe o botão. Por exemplo, considere o texto do botão “NYC”. Quando o usuário escolhe o botão, o valor enviado pode ser “Cidade de Nova York”.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.000.  
Obrigatório: sim

## Consulte também
<a name="API_runtime_Button_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/Button) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/Button) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/Button) 

# DialogAction
<a name="API_runtime_DialogAction"></a>

Descreve a próxima ação que o bot deve realizar em sua interação com o usuário e fornece informações sobre o contexto em que a ação ocorre. Use o tipo de dados `DialogAction` para definir a interação em um estado específico ou para retornar a interação a um estado anterior.

## Conteúdo
<a name="API_runtime_DialogAction_Contents"></a>

 ** type **   <a name="lex-Type-runtime_DialogAction-type"></a>
A próxima ação que o bot deve realizar em sua interação com o usuário. Os valores possíveis são:  
+  `ConfirmIntent`: a próxima ação é perguntar ao usuário se a intenção está completa e pronta para ser atendida. Essa é uma pergunta de sim/não, como “Fazer o pedido?”
+  `Close`: indica que não haverá uma resposta do usuário. Por exemplo, a afirmação "Seu pedido de pizza foi feito" não requer uma resposta.
+  `Delegate`: a próxima ação é determinada pelo Amazon Lex.
+  `ElicitIntent`: a próxima ação é determinar a intenção que o usuário deseja atender.
+  `ElicitSlot`: a próxima ação é ilicitar um valor de slot do usuário.
Tipo: String  
Valores Válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Obrigatório: sim

 ** fulfillmentState **   <a name="lex-Type-runtime_DialogAction-fulfillmentState"></a>
O estado de atendimento da intenção. Os valores possíveis são:  
+  `Failed`: a função do Lambda associada à intenção falhou em atender a intenção.
+  `Fulfilled` - A intenção foi atendida pela função do Lambda associada à intenção. 
+  `ReadyForFulfillment`: todas as informações necessárias para que a intenção esteja presente e pronta para ser atendida pelo aplicativo do cliente.
Tipo: String  
Valores Válidos: `Fulfilled | Failed | ReadyForFulfillment`   
Obrigatório: não

 ** intentName **   <a name="lex-Type-runtime_DialogAction-intentName"></a>
O nome da intenção.  
Tipo: String  
Obrigatório: Não

 ** message **   <a name="lex-Type-runtime_DialogAction-message"></a>
A mensagem que deve ser exibida ao usuário. Se você não especificar uma mensagem, o Amazon Lex usará a mensagem configurada para a intenção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.  
Obrigatório: não

 ** messageFormat **   <a name="lex-Type-runtime_DialogAction-messageFormat"></a>
+  `PlainText` - A mensagem contém texto sem formatação UTF-8.
+  `CustomPayload` - A mensagem é um formato personalizado para o cliente.
+  `SSML` - A mensagem contém texto formatado para saída de voz.
+  `Composite`: a mensagem contém um objeto JSON de escape com uma ou mais mensagens. Para obter mais informações, consulte [Grupos de mensagens](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html). 
Tipo: string  
Valores Válidos: `PlainText | CustomPayload | SSML | Composite`   
Obrigatório: não

 ** slots **   <a name="lex-Type-runtime_DialogAction-slots"></a>
Mapa dos slots que foram coletados e seus valores.   
Tipo: mapa de string para string  
Obrigatório: não

 ** slotToElicit **   <a name="lex-Type-runtime_DialogAction-slotToElicit"></a>
O nome do slot que deve ser obtido do usuário.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_runtime_DialogAction_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DialogAction) 

# GenericAttachment
<a name="API_runtime_GenericAttachment"></a>

Representa uma opção renderizada para o usuário quando um prompt é exibido. Pode ser uma imagem, um botão, um link ou um texto. 

## Conteúdo
<a name="API_runtime_GenericAttachment_Contents"></a>

 ** attachmentLinkUrl **   <a name="lex-Type-runtime_GenericAttachment-attachmentLinkUrl"></a>
O URL de um anexo ao cartão de resposta.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: não

 ** buttons **   <a name="lex-Type-runtime_GenericAttachment-buttons"></a>
A lista de opções a serem mostradas ao usuário.  
Tipo: matriz de objetos [Button](API_runtime_Button.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.  
Obrigatório: não

 ** imageUrl **   <a name="lex-Type-runtime_GenericAttachment-imageUrl"></a>
O URL de uma imagem que é exibida ao usuário.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.  
Obrigatório: não

 ** subTitle **   <a name="lex-Type-runtime_GenericAttachment-subTitle"></a>
O subtítulo mostrado abaixo do título.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 80.  
Obrigatório: não

 ** title **   <a name="lex-Type-runtime_GenericAttachment-title"></a>
O título da opção.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 80.  
Obrigatório: Não

## Consulte também
<a name="API_runtime_GenericAttachment_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GenericAttachment) 

# IntentConfidence
<a name="API_runtime_IntentConfidence"></a>

Fornece uma pontuação que indica o quanto o Amazon Lex tem certeza de que uma intenção satisfaz a intenção do usuário.

## Conteúdo
<a name="API_runtime_IntentConfidence_Contents"></a>

 ** score **   <a name="lex-Type-runtime_IntentConfidence-score"></a>
Uma pontuação que indica o quanto o Amazon Lex tem certeza de que a intenção satisfaz a intenção do usuário. Varia entre 0,00 e 1,00. Pontuações mais altas indicam maior confiança.  
Tipo: duplo  
Obrigatório: Não

## Consulte também
<a name="API_runtime_IntentConfidence_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentConfidence) 

# IntentSummary
<a name="API_runtime_IntentSummary"></a>

Fornece informações sobre o estado de uma intenção. Você pode usar essas informações para obter o estado atual de uma intenção para poder processá-la ou retorná-la ao estado anterior.

## Conteúdo
<a name="API_runtime_IntentSummary_Contents"></a>

 ** dialogActionType **   <a name="lex-Type-runtime_IntentSummary-dialogActionType"></a>
A próxima ação que o bot deve realizar em sua interação com o usuário. Os valores possíveis são:  
+  `ConfirmIntent`: a próxima ação é perguntar ao usuário se a intenção está completa e pronta para ser atendida. Essa é uma pergunta de sim/não, como “Fazer o pedido?”
+  `Close`: indica que não haverá uma resposta do usuário. Por exemplo, a afirmação "Seu pedido de pizza foi feito" não requer uma resposta.
+  `ElicitIntent`: a próxima ação é determinar a intenção que o usuário deseja atender.
+  `ElicitSlot`: a próxima ação é ilicitar um valor de slot do usuário.
Tipo: String  
Valores Válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Obrigatório: sim

 ** checkpointLabel **   <a name="lex-Type-runtime_IntentSummary-checkpointLabel"></a>
Um rótulo definido pelo usuário que identifica uma intenção específica. Você pode usar esse rótulo para retornar a uma intenção anterior.   
Use o parâmetro `checkpointLabelFilter` da operação `GetSessionRequest` para filtrar as intenções retornadas pela operação para aquelas com somente o rótulo especificado.  
Tipo: String  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `[a-zA-Z0-9-]+`   
Obrigatório: não

 ** confirmationStatus **   <a name="lex-Type-runtime_IntentSummary-confirmationStatus"></a>
O status da intenção após o usuário responder ao prompt de confirmação. Se o usuário confirmar a intenção, o Amazon Lex define esse campo como `Confirmed`. Se o usuário negar a intenção, o Amazon Lex define esse valor como `Denied`. Os valores possíveis são:  
+  `Confirmed` - O usuário respondeu “Sim” ao prompt de confirmação, confirmando que a intenção está completa e que está pronta para ser atendida.
+  `Denied` - O usuário respondeu “Não” ao prompt de confirmação.
+  `None` - O usuário nunca recebeu um prompt de confirmação; ou o usuário recebeu um prompt, mas não o confirmou nem negou.
Tipo: String  
Valores Válidos: `None | Confirmed | Denied`   
Obrigatório: não

 ** fulfillmentState **   <a name="lex-Type-runtime_IntentSummary-fulfillmentState"></a>
O estado de atendimento da intenção. Os valores possíveis são:  
+  `Failed`: a função do Lambda associada à intenção falhou em atender a intenção.
+  `Fulfilled` - A intenção foi atendida pela função do Lambda associada à intenção. 
+  `ReadyForFulfillment`: todas as informações necessárias para que a intenção esteja presente e pronta para ser atendida pelo aplicativo do cliente.
Tipo: String  
Valores Válidos: `Fulfilled | Failed | ReadyForFulfillment`   
Obrigatório: não

 ** intentName **   <a name="lex-Type-runtime_IntentSummary-intentName"></a>
O nome da intenção.  
Tipo: String  
Obrigatório: Não

 ** slots **   <a name="lex-Type-runtime_IntentSummary-slots"></a>
Mapa dos slots que foram coletados e seus valores.   
Tipo: mapa de string para string  
Obrigatório: não

 ** slotToElicit **   <a name="lex-Type-runtime_IntentSummary-slotToElicit"></a>
O próximo slot a ser obtido de um usuário. Se não houver espaço para extrair, o campo ficará em branco.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_runtime_IntentSummary_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentSummary) 

# PredictedIntent
<a name="API_runtime_PredictedIntent"></a>

Uma intenção sugerida pelo Amazon Lex satisfaz a intenção do usuário. Inclui o nome da intenção, a confiança que o Amazon Lex tem de que a intenção do usuário está satisfeita e os slots definidos para a intenção.

## Conteúdo
<a name="API_runtime_PredictedIntent_Contents"></a>

 ** intentName **   <a name="lex-Type-runtime_PredictedIntent-intentName"></a>
O nome de uma intenção sugerida pelo Amazon Lex que satisfaz a intenção do usuário.  
Tipo: String  
Obrigatório: Não

 ** nluIntentConfidence **   <a name="lex-Type-runtime_PredictedIntent-nluIntentConfidence"></a>
Indica o quanto o Amazon Lex tem certeza de que a intenção satisfaz a intenção do usuário.  
Tipo: objeto [IntentConfidence](API_runtime_IntentConfidence.md)  
Obrigatório: não

 ** slots **   <a name="lex-Type-runtime_PredictedIntent-slots"></a>
O slot e os valores do slot associados à intenção prevista.  
Tipo: mapa de string para string  
Obrigatório: Não

## Consulte também
<a name="API_runtime_PredictedIntent_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PredictedIntent) 

# ResponseCard
<a name="API_runtime_ResponseCard"></a>

Se você configurar um cartão de resposta ao criar seus bots, o Amazon Lex substituirá os atributos da sessão e os valores de slots disponíveis e os retornará. O cartão de resposta também pode vir de uma função do Lambda (`dialogCodeHook` e `fulfillmentActivity` em uma intenção).

## Conteúdo
<a name="API_runtime_ResponseCard_Contents"></a>

 ** contentType **   <a name="lex-Type-runtime_ResponseCard-contentType"></a>
O tipo de conteúdo da resposta.  
Tipo: string  
Valores Válidos: `application/vnd.amazonaws.card.generic`   
Obrigatório: não

 ** genericAttachments **   <a name="lex-Type-runtime_ResponseCard-genericAttachments"></a>
Uma matriz de objetos anexos representando opções.  
Tipo: matriz de objetos [GenericAttachment](API_runtime_GenericAttachment.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.  
Obrigatório: não

 ** version **   <a name="lex-Type-runtime_ResponseCard-version"></a>
A versão do formato do cartão de resposta.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_runtime_ResponseCard_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ResponseCard) 

# SentimentResponse
<a name="API_runtime_SentimentResponse"></a>

O sentimento expresso em uma declaração.

Quando o bot está configurado para enviar declarações ao Amazon Comprehend para análise de sentimentos, a estrutura desse campo contém o resultado da análise.

## Conteúdo
<a name="API_runtime_SentimentResponse_Contents"></a>

 ** sentimentLabel **   <a name="lex-Type-runtime_SentimentResponse-sentimentLabel"></a>
O sentimento inferido no qual o Amazon Comprehend tem a maior confiança.  
Tipo: String  
Obrigatório: Não

 ** sentimentScore **   <a name="lex-Type-runtime_SentimentResponse-sentimentScore"></a>
A probabilidade de o sentimento ter sido inferido corretamente.  
Tipo: String  
Obrigatório: Não

## Consulte também
<a name="API_runtime_SentimentResponse_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/SentimentResponse)