Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Documentazione di riferimento delle API
<a name="API_Reference"></a>

Questa sezione fornisce la documentazione per le operazioni dell'API Amazon Lex. Per un elenco delle regioni AWS in cui è disponibile Amazon Lex, consulta [Regioni ed endpoints AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#lex_region) nell'*Amazon Web Services General Reference*.

**Argomenti**
+ [Operazioni](API_Operations.md)
+ [Tipi di dati](API_Types.md)

# Operazioni
<a name="API_Operations"></a>

Le seguenti azioni sono supportate da Amazon Lex Model Building Service:
+  [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) 

Le seguenti azioni sono supportate da Amazon Lex Runtime Service:
+  [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) 

# Servizio di creazione di modelli Amazon Lex
<a name="API_Operations_Amazon_Lex_Model_Building_Service"></a>

Le seguenti azioni sono supportate da Amazon Lex Model Building Service:
+  [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>

Crea una nuova versione del bot basata sulla `$LATEST` versione. Se la `$LATEST` versione di questa risorsa non è cambiata da quando hai creato l'ultima versione, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione creata.

**Nota**  
Puoi aggiornare solo la `$LATEST` versione del bot. Non puoi aggiornare le versioni numerate che crei con l'`CreateBotVersion`operazione.

 Quando crei la prima versione di un bot, Amazon Lex imposta la versione su 1. Le versioni successive aumentano di 1. Per ulteriori informazioni, consulta [Controllo delle versioni](versioning-aliases.md#versioning-intro). 

 Questa operazione richiede l’autorizzazione per l'operazione `lex:CreateBotVersion`. 

## Sintassi della richiesta
<a name="API_CreateBotVersion_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateBotVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
Il nome del bot di cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.   
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateBotVersion_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Identifica una revisione specifica della `$LATEST` versione del bot. Se specifichi un checksum e la `$LATEST` versione del bot ha un checksum diverso, viene restituita un'`PreconditionFailedException`eccezione e Amazon Lex non pubblica una nuova versione. Se non specifichi un checksum, Amazon Lex pubblica la `$LATEST` versione.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_CreateBotVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
Il messaggio che Amazon Lex utilizza per annullare una conversazione. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: oggetto [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
Checksum che identifica la versione del bot che è stata creata.  
Tipo: String

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando `true` o `false` nel `childDirected` campo. Specificando `true` nel `childDirected` campo, confermi che l'uso di Amazon Lex **è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando `false` nel `childDirected` campo, confermi che l'uso di Amazon Lex **non è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il `childDirected` campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.  
Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le [domande frequenti su Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Tipo: Booleano

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
Il messaggio che Amazon Lex utilizza quando non comprende la richiesta dell'utente. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
La data in cui è stata creata la versione del bot.  
Tipo: Timestamp

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
Una descrizione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Indica se gli enunciati inseriti dall'utente devono essere inviati ad Amazon Comprehend per l'analisi del sentiment.  
Tipo: Booleano

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
Indica se il bot utilizza miglioramenti di precisione. `true`indica che il bot sta utilizzando i miglioramenti, altrimenti`false`.  
Tipo: Booleano

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a creare il bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: numero intero  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
Un array di oggetti `Intent`. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: matrice di oggetti [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
La data in cui è stata aggiornata la `$LATEST` versione di questo bot.   
Tipo: Timestamp

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Specifica la localizzazione di destinazione per il bot.   
Tipo: String  
Valori validi: `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>
Il nome del bot.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Quando invii una richiesta per creare o aggiornare un bot, Amazon Lex imposta l'elemento di `status` risposta su`BUILDING`. Dopo che Amazon Lex ha creato il bot, viene `status` impostato su`READY`. Se Amazon Lex non è in grado di creare il bot, `status` lo imposta`FAILED`. Amazon Lex restituisce il motivo dell'errore nell'elemento di `failureReason` risposta.   
Tipo: String  
Valori validi: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
La versione del bot.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
L'ID vocale Amazon Polly utilizzato da Amazon Lex per le interazioni vocali con l'utente.  
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_CreateBotVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion) 

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

Crea una nuova versione di un intento basata sulla `$LATEST` versione dell'intento. Se la `$LATEST` versione di questo intento non è cambiata dall'ultimo aggiornamento, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione che hai creato.

**Nota**  
Puoi aggiornare solo la `$LATEST` versione dell'intento. Non è possibile aggiornare le versioni numerate create con l'`CreateIntentVersion`operazione.

 Quando crei una versione di un intento, Amazon Lex imposta la versione su 1. Le versioni successive aumentano di 1. Per ulteriori informazioni, consulta [Controllo delle versioni](versioning-aliases.md#versioning-intro). 

Questa operazione necessita delle autorizzazioni a eseguire l'operazione `lex:CreateIntentVersion`. 

## Sintassi della richiesta
<a name="API_CreateIntentVersion_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
Il nome dell'intento di cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateIntentVersion_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Checksum della `$LATEST` versione dell'intento da utilizzare per creare la nuova versione. Se specifichi un checksum e la `$LATEST` versione dell'intento ha un checksum diverso, Amazon Lex restituisce un'`PreconditionFailedException`eccezione e non pubblica una nuova versione. Se non specifichi un checksum, Amazon Lex pubblica la `$LATEST` versione.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_CreateIntentVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Checksum della versione dell'intento creata.  
Tipo: String

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Dopo che la funzione Lambda specificata nel `fulfillmentActivity` campo soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Se definito, il prompt utilizzato da Amazon Lex per confermare l'intenzione dell'utente prima di soddisfarla.   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
La data di creazione dell'intento.  
Tipo: Timestamp

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Se definita, Amazon Lex richiama questa funzione Lambda per ogni input dell'utente.  
Tipo: oggetto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Se definito, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività utente dopo il raggiungimento dell'intento.   
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Descrive come viene soddisfatto l'intento.   
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informazioni di configurazione, se presenti, per connettere un indice Amazon Kendra con l'intento. `AMAZON.KendraSearchIntent`  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato.   
Tipo: Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
Il nome dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Una matrice di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Un identificatore univoco per un intento incorporato.  
Tipo: String

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita in`confirmationPrompt`, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Una serie di espressioni di esempio configurate per l'intento.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Una serie di tipi di slot che definisce le informazioni necessarie per soddisfare l'intento.  
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
Il numero di versione assegnato alla nuova versione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_CreateIntentVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion) 

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

Crea una nuova versione di un tipo di slot in base alla `$LATEST` versione del tipo di slot specificato. Se la `$LATEST` versione di questa risorsa non è cambiata dall'ultima versione che hai creato, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione che hai creato. 

**Nota**  
È possibile aggiornare solo la `$LATEST` versione di un tipo di slot. Non è possibile aggiornare le versioni numerate create con l'`CreateSlotTypeVersion`operazione.

Quando crei una versione di un tipo di slot, Amazon Lex imposta la versione su 1. Le versioni successive aumentano di 1. Per ulteriori informazioni, consulta [Controllo delle versioni](versioning-aliases.md#versioning-intro). 

Questa operazione richiede le autorizzazioni per l'operazione `lex:CreateSlotTypeVersion`.

## Sintassi della richiesta
<a name="API_CreateSlotTypeVersion_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateSlotTypeVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-uri-name"></a>
Il nome del tipo di slot per cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateSlotTypeVersion_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-checksum"></a>
Checksum per la `$LATEST` versione del tipo di slot che desideri pubblicare. Se specifichi un checksum e la `$LATEST` versione del tipo di slot ha un checksum diverso, Amazon Lex restituisce un'`PreconditionFailedException`eccezione e non pubblica la nuova versione. Se non specifichi un checksum, Amazon Lex pubblica la `$LATEST` versione.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_CreateSlotTypeVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-checksum"></a>
Checksum della `$LATEST` versione del tipo di slot.  
Tipo: String

 ** [createdDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-createdDate"></a>
La data di creazione del tipo di slot.  
Tipo: Timestamp

 ** [description](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-description"></a>
Una descrizione del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [enumerationValues](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-enumerationValues"></a>
Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere.  
Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 elementi.

 ** [lastUpdatedDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-lastUpdatedDate"></a>
La data in cui il tipo di slot è stato aggiornato. Quando si crea una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-name"></a>
Il nome del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-parentSlotTypeSignature"></a>
Il tipo di slot integrato utilizzato come elemento principale del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-slotTypeConfigurations"></a>
Informazioni di configurazione che estendono il tipo di slot integrato principale.  
Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [valueSelectionStrategy](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-valueSelectionStrategy"></a>
La strategia utilizzata da Amazon Lex per determinare il valore dello slot. Per ulteriori informazioni, consulta [PutSlotType](API_PutSlotType.md).  
Tipo: String  
Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-version"></a>
La versione assegnata alla nuova versione del tipo di slot.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto durante l'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_CreateSlotTypeVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateSlotTypeVersion) 

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

Elimina tutte le versioni del bot, inclusa la `$LATEST` versione. Per eliminare una versione specifica del bot, usa l'[DeleteBotVersion](API_DeleteBotVersion.md)operazione. L'`DeleteBot`operazione non rimuove immediatamente lo schema del bot. Viene invece contrassegnato per l'eliminazione e rimosso in seguito.

Amazon Lex archivia gli enunciati a tempo indeterminato per migliorare la capacità del bot di rispondere agli input degli utenti. Questi enunciati non vengono rimossi quando il bot viene eliminato. Per rimuovere gli enunciati, utilizzate l'[DeleteUtterances](API_DeleteUtterances.md)operazione.

Se un bot ha un alias, non puoi eliminarlo. L'`DeleteBot`operazione restituisce invece un'`ResourceInUseException`eccezione che include un riferimento all'alias che si riferisce al bot. Per rimuovere il riferimento al bot, elimina l'alias. Se si verifica nuovamente la stessa eccezione, eliminate l'alias di riferimento fino al completamento dell'`DeleteBot`operazione.

Questa operazione richiede le autorizzazioni per l'operazione `lex:DeleteBot`.

## Sintassi della richiesta
<a name="API_DeleteBot_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteBot_RequestSyntax) **   <a name="lex-DeleteBot-request-uri-name"></a>
Il nome del bot. Il nome distingue tra maiuscole e minuscole.   
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteBot_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBot_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteBot_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteBot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBot) 

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

Elimina un alias per il bot specificato. 

Non puoi eliminare un alias utilizzato nell'associazione tra un bot e un canale di messaggistica. Se un alias viene utilizzato in un'associazione di canali, l'`DeleteBot`operazione restituisce un'`ResourceInUseException`eccezione che include un riferimento all'associazione di canale che si riferisce al bot. È possibile rimuovere il riferimento all'alias eliminando l'associazione di canale. Se si verifica nuovamente la stessa eccezione, eliminate l'associazione di riferimento finché l'`DeleteBotAlias`operazione non avrà esito positivo.

## Sintassi della richiesta
<a name="API_DeleteBotAlias_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBotAlias_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botName](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-botName"></a>
Il nome del bot a cui punta l'alias.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [name](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-name"></a>
Il nome dell'alias da eliminare. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteBotAlias_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteBotAlias_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteBotAlias_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotAlias) 

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

Elimina l'associazione tra un bot Amazon Lex e una piattaforma di messaggistica.

Questa operazione richiede l’autorizzazione per l'operazione `lex:DeleteBotChannelAssociation`.

## Sintassi della richiesta
<a name="API_DeleteBotChannelAssociation_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBotChannelAssociation_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [aliasName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botAlias"></a>
Un alias che rimanda alla versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [botName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botName"></a>
Il nome del bot Amazon Lex.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [name](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-name"></a>
Il nome dell'associazione. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteBotChannelAssociation_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteBotChannelAssociation_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_DeleteBotChannelAssociation_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 

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

Elimina una versione specifica di un bot. Per eliminare tutte le versioni di un bot, usa l'[DeleteBot](API_DeleteBot.md)operazione. 

Questa operazione richiede le autorizzazioni per l'operazione `lex:DeleteBotVersion`.

## Sintassi della richiesta
<a name="API_DeleteBotVersion_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBotVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-name"></a>
Il nome del bot.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-version"></a>
La versione del bot da eliminare. Non è possibile eliminare la `$LATEST` versione del bot. Per eliminare la `$LATEST` versione, usa l'[DeleteBot](API_DeleteBot.md)operazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteBotVersion_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteBotVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto durante l'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteBotVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotVersion) 

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

Elimina tutte le versioni dell'intento, inclusa la `$LATEST` versione. Per eliminare una versione specifica dell'intento, usa l'operazione. [DeleteIntentVersion](API_DeleteIntentVersion.md)

 È possibile eliminare una versione di un intento solo se non è referenziata. Per eliminare un intento a cui si fa riferimento in uno o più bot (vedi[Amazon Lex: come funziona](how-it-works.md)), devi prima rimuovere tali riferimenti. 

**Nota**  
 Se ottieni l'`ResourceInUseException`eccezione, fornisce un esempio di riferimento che mostra dove viene fatto riferimento all'intento. Per rimuovere il riferimento all'intento, aggiorna il bot o eliminalo. Se ottieni la stessa eccezione quando tenti di eliminare nuovamente l'intento, ripeti finché l'intento non ha più riferimenti e la chiamata a `DeleteIntent` ha esito positivo. 

 Questa operazione richiede l’autorizzazione per l'operazione `lex:DeleteIntent`. 

## Sintassi della richiesta
<a name="API_DeleteIntent_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteIntent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteIntent_RequestSyntax) **   <a name="lex-DeleteIntent-request-uri-name"></a>
Il nome dell'intento. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteIntent_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteIntent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteIntent_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntent) 

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

Elimina una versione specifica di un intento. Per eliminare tutte le versioni di un intento, utilizzate l'[DeleteIntent](API_DeleteIntent.md)operazione. 

Questa operazione richiede le autorizzazioni per l'operazione `lex:DeleteIntentVersion`.

## Sintassi della richiesta
<a name="API_DeleteIntentVersion_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteIntentVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-name"></a>
Il nome dell'intento.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-version"></a>
La versione dell'intento da eliminare. Non è possibile eliminare la `$LATEST` versione dell'intento. Per eliminare la `$LATEST` versione, utilizzare l'[DeleteIntent](API_DeleteIntent.md)operazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteIntentVersion_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteIntentVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteIntentVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntentVersion) 

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

Elimina tutte le versioni del tipo di slot, inclusa la `$LATEST` versione. Per eliminare una versione specifica del tipo di slot, utilizzare l'[DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md)operazione.

 È possibile eliminare una versione di un tipo di slot solo se non è referenziata. Per eliminare un tipo di slot a cui si fa riferimento in uno o più intenti, è necessario rimuovere prima tali riferimenti. 

**Nota**  
 Se ottenete l'`ResourceInUseException`eccezione, l'eccezione fornisce un esempio di riferimento che mostra l'intento in cui viene fatto riferimento al tipo di slot. Per rimuovere il riferimento al tipo di slot, aggiorna l'intento o eliminalo. Se si verifica la stessa eccezione quando si tenta di eliminare nuovamente il tipo di slot, ripetere l'operazione fino a quando il tipo di slot non contiene riferimenti e la `DeleteSlotType` chiamata ha esito positivo. 

Questa operazione richiede l’autorizzazione per l'operazione `lex:DeleteSlotType`.

## Sintassi della richiesta
<a name="API_DeleteSlotType_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteSlotType_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteSlotType_RequestSyntax) **   <a name="lex-DeleteSlotType-request-uri-name"></a>
Il nome del tipo di slot. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteSlotType_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteSlotType_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteSlotType_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteSlotType_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotType) 

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

Elimina una versione specifica di un tipo di slot. Per eliminare tutte le versioni di un tipo di slot, utilizzare l'[DeleteSlotType](API_DeleteSlotType.md)operazione. 

Questa operazione richiede le autorizzazioni per l'operazione `lex:DeleteSlotTypeVersion`.

## Sintassi della richiesta
<a name="API_DeleteSlotTypeVersion_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteSlotTypeVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-name"></a>
Il nome del tipo di slot.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-version"></a>
La versione del tipo di slot da eliminare. Non è possibile eliminare la `$LATEST` versione del tipo di slot. Per eliminare la `$LATEST` versione, utilizzare l'[DeleteSlotType](API_DeleteSlotType.md)operazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteSlotTypeVersion_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteSlotTypeVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** ResourceInUseException **   
La risorsa che stai tentando di eliminare viene richiamata da un'altra risorsa. Utilizzate queste informazioni per rimuovere i riferimenti alla risorsa che state tentando di eliminare.  
Il corpo dell'eccezione contiene un oggetto JSON che descrive la risorsa.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteSlotTypeVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 

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

Elimina gli enunciati memorizzati.

Amazon Lex archivia gli enunciati che gli utenti inviano al tuo bot. Gli enunciati vengono archiviati per 15 giorni per essere utilizzati con l'[GetUtterancesView](API_GetUtterancesView.md)operazione e quindi archiviati a tempo indeterminato per essere utilizzati per migliorare la capacità del bot di rispondere agli input dell'utente.

Utilizzate l'`DeleteUtterances`operazione per eliminare manualmente gli enunciati memorizzati per un utente specifico. Quando si utilizza l'`DeleteUtterances`operazione, gli enunciati memorizzati per migliorare la capacità del bot di rispondere agli input dell'utente vengono eliminati immediatamente. Gli enunciati memorizzati per essere utilizzati con l'`GetUtterancesView`operazione vengono eliminati dopo 15 giorni.

Questa operazione richiede le autorizzazioni per l'operazione `lex:DeleteUtterances`.

## Sintassi della richiesta
<a name="API_DeleteUtterances_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteUtterances_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
Il nome del bot che ha memorizzato gli enunciati.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 L'identificatore univoco dell'utente che ha emesso gli enunciati. Si tratta dell'ID utente inviato nella richiesta di [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)operazione [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o contenente l'enunciato.  
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteUtterances_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteUtterances_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_DeleteUtterances_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances) 

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

Restituisce informazioni sui metadati per un bot specifico. È necessario fornire il nome del bot e la versione o l'alias del bot. 

 Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBot`. 

## Sintassi della richiesta
<a name="API_GetBot_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
Il nome del bot. Il nome distingue tra maiuscole e minuscole.   
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [versionoralias](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
La versione o l'alias del bot.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBot_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [abortStatement](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-abortStatement"></a>
Il messaggio che Amazon Lex restituisce quando l'utente decide di terminare la conversazione senza completarla. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: oggetto [Statement](API_Statement.md)

 ** [checksum](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-checksum"></a>
Checksum del bot utilizzato per identificare una revisione specifica della versione del bot. `$LATEST`  
Tipo: String

 ** [childDirected](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-childDirected"></a>
Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando `true` o `false` nel `childDirected` campo. Specificando `true` nel `childDirected` campo, confermi che l'uso di Amazon Lex **è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando `false` nel `childDirected` campo, confermi che l'uso di Amazon Lex **non è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il `childDirected` campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.  
Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le [domande frequenti su Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Tipo: Booleano

 ** [clarificationPrompt](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
Il messaggio che Amazon Lex utilizza quando non comprende la richiesta dell'utente. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-createdDate"></a>
La data di creazione del bot.  
Tipo: Timestamp

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
Una descrizione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
Indica se gli enunciati degli utenti devono essere inviati ad Amazon Comprehend per l'analisi del sentiment.  
Tipo: Booleano

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
Indica se il bot utilizza miglioramenti di precisione. `true`indica che il bot sta utilizzando i miglioramenti, altrimenti`false`.  
Tipo: Booleano

 ** [failureReason](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex spiega perché non è riuscito a creare il bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: numero intero  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.

 ** [intents](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-intents"></a>
Un array di oggetti `intent`. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: matrice di oggetti [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-lastUpdatedDate"></a>
La data in cui il bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.   
Tipo: Timestamp

 ** [locale](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-locale"></a>
 Il locale di destinazione per il bot.   
Tipo: String  
Valori validi: `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>
Il nome del bot.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
Il punteggio che determina dove Amazon Lex inserisce o entrambi quando restituisce intenti alternativi in una risposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html). `AMAZON.FallbackIntent` `AMAZON.KendraSearchIntent` `AMAZON.FallbackIntent`viene inserito se il punteggio di confidenza a tutti gli effetti è inferiore a questo valore. `AMAZON.KendraSearchIntent`viene inserito solo se è configurato per il bot.  
Tipo: numero a doppia precisione  
Intervallo valido: valore minimo di 0. Valore massimo di 1.

 ** [status](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-status"></a>
Lo stato del bot.   
Quando lo stato è, `BUILDING` Amazon Lex crea il bot per il test e l'uso.  
Se lo stato del bot è uguale`READY_BASIC_TESTING`, puoi testarlo utilizzando le espressioni esatte specificate nelle intenzioni del bot. Quando il bot è pronto per il test completo o per l'esecuzione, lo stato è. `READY`  
Se c'è stato un problema con la creazione del bot, lo stato è `FAILED` e il `failureReason` campo spiega perché il bot non ha creato.  
Se il bot è stato salvato ma non creato, lo stato è`NOT_BUILT`.  
Tipo: String  
Valori validi: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-version"></a>
La versione del bot. Per un nuovo bot, la versione è sempre`$LATEST`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-voiceId"></a>
L'ID vocale Amazon Polly utilizzato da Amazon Lex per l'interazione vocale con l'utente. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot) 

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

Restituisce informazioni su un alias bot di Amazon Lex. Per ulteriori informazioni sugli alias, consultare [Funzione Versioni multiple e alias](versioning-aliases.md).

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBotAlias`.

## Sintassi della richiesta
<a name="API_GetBotAlias_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBotAlias_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botName](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-botName"></a>
Il nome del bot.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [name](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-name"></a>
Il nome dell'alias del bot. Il nome distingue tra maiuscole e minuscole.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBotAlias_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBotAlias_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botName](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botName"></a>
Il nome del bot a cui punta l'alias.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botVersion"></a>
La versione del bot a cui punta l'alias.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [checksum](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-checksum"></a>
Checksum dell'alias del bot.  
Tipo: String

 ** [conversationLogs](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-conversationLogs"></a>
Le impostazioni che determinano in che modo Amazon Lex utilizza i log delle conversazioni per l'alias.  
Tipo: oggetto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-createdDate"></a>
La data di creazione dell'alias del bot.  
Tipo: Timestamp

 ** [description](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-description"></a>
Una descrizione dell'alias del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [lastUpdatedDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-lastUpdatedDate"></a>
La data in cui l'alias del bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-name"></a>
Il nome dell'alias del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBotAlias_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAlias) 

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

Restituisce un elenco di alias per un bot Amazon Lex specificato.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBotAliases`.

## Sintassi della richiesta
<a name="API_GetBotAliases_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBotAliases_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botName](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-botName"></a>
Il nome del bot.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [maxResults](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-maxResults"></a>
Il numero massimo di alias da restituire nella risposta. L'impostazione predefinita è 50.   
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi degli alias dei bot. Verrà restituito un alias se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva di alias. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di alias, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetBotAliases_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBotAliases_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [BotAliases](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-BotAliases"></a>
Una serie di `BotAliasMetadata` oggetti, ciascuno dei quali descrive un alias bot.  
Tipo: matrice di oggetti [BotAliasMetadata](API_BotAliasMetadata.md)

 ** [nextToken](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva di alias. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di alias, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetBotAliases_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAliases) 

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

Restituisce informazioni sull'associazione tra un bot Amazon Lex e una piattaforma di messaggistica.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBotChannelAssociation`.

## Sintassi della richiesta
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
Un alias che indica la versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
Il nome del bot Amazon Lex.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
Il nome dell'associazione tra il bot e il canale. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBotChannelAssociation_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
Un alias che indica la versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
Fornisce le informazioni necessarie alla piattaforma di messaggistica per comunicare con il bot Amazon Lex.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 10 elementi.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
Il nome del bot Amazon Lex.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
La data di creazione dell'associazione tra il bot e il canale.  
Tipo: Timestamp

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
Una descrizione dell'associazione tra il bot e il canale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a creare l'associazione.  
Tipo: String

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
Il nome dell'associazione tra il bot e il canale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
Lo stato del canale bot.   
+  `CREATED`- Il canale è stato creato ed è pronto per l'uso.
+  `IN_PROGRESS`- La creazione del canale è in corso.
+  `FAILED`- Si è verificato un errore durante la creazione del canale. Per informazioni sul motivo dell'errore, consulta il `failureReason` campo.
Tipo: String  
Valori validi: `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
Il tipo di piattaforma di messaggistica.  
Tipo: String  
Valori validi: `Facebook | Slack | Twilio-Sms | Kik` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation) 

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

 Restituisce un elenco di tutti i canali associati al bot specificato. 

L'`GetBotChannelAssociations`operazione richiede le autorizzazioni per l'`lex:GetBotChannelAssociations`azione.

## Sintassi della richiesta
<a name="API_GetBotChannelAssociations_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBotChannelAssociations_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
Un alias che indica la versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^(-|^([A-Za-z]_?)+$)$`   
Obbligatorio: sì

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
Il nome del bot Amazon Lex nell'associazione.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
Il numero massimo di associazioni da restituire nella risposta. L'impostazione predefinita è 50.   
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi delle associazioni di canale. Verrà restituita un'associazione se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz». Per restituire tutte le associazioni dei canali dei bot, utilizzate un trattino («-») come parametro. `nameContains`  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva di associazioni. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di associazioni, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetBotChannelAssociations_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBotChannelAssociations_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Una serie di oggetti, uno per ogni associazione, che fornisce informazioni sul bot Amazon Lex e sulla sua associazione con il canale.   
Tipo: matrice di oggetti [BotChannelAssociation](API_BotChannelAssociation.md)

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva di associazioni. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di associazioni, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations) 

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

Restituisce le informazioni sul bot come segue: 
+ Se fornite il `nameContains` campo, la risposta include informazioni sulla `$LATEST` versione di tutti i bot il cui nome contiene la stringa specificata.
+ Se non specifichi il `nameContains` campo, l'operazione restituisce informazioni sulla `$LATEST` versione di tutti i tuoi bot.

Questa operazione richiede l’autorizzazione per l'operazione `lex:GetBots`.

## Sintassi della richiesta
<a name="API_GetBots_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBots_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
Il numero massimo di bot da restituire nella risposta che la richiesta restituirà. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi dei bot. Un bot verrà restituito se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva dei bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva dei bot, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetBots_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBots_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
Una serie di `botMetadata` oggetti, con un ingresso per ogni bot.   
Tipo: matrice di oggetti [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
Se la risposta viene troncata, include un token di impaginazione che puoi specificare nella tua prossima richiesta per recuperare la pagina successiva dei bot.   
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBots_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots) 

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

Ottiene informazioni su tutte le versioni di un bot.

L'`GetBotVersions`operazione restituisce un `BotMetadata` oggetto per ogni versione di un bot. Ad esempio, se un bot ha tre versioni numerate, l'`GetBotVersions`operazione restituisce quattro `BotMetadata` oggetti nella risposta, uno per ogni versione numerata e uno per la `$LATEST` versione. 

L'`GetBotVersions`operazione restituisce sempre almeno una versione, la `$LATEST` versione.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetBotVersions`.

## Sintassi della richiesta
<a name="API_GetBotVersions_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBotVersions_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-maxResults"></a>
Il numero massimo di versioni del bot da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [name](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-name"></a>
Il nome del bot per il quale restituire le versioni.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [nextToken](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni dei bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetBotVersions_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetBotVersions_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [bots](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-bots"></a>
Una serie di `BotMetadata` oggetti, uno per ogni versione numerata del bot più uno per la versione. `$LATEST`  
Tipo: matrice di oggetti [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni del bot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

## Errori
<a name="API_GetBotVersions_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBotVersions_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotVersions) 

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

Restituisce informazioni su un intento integrato.

Questa operazione richiede l’autorizzazione per l'operazione `lex:GetBuiltinIntent`.

## Sintassi della richiesta
<a name="API_GetBuiltinIntent_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBuiltinIntent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [signature](#API_GetBuiltinIntent_RequestSyntax) **   <a name="lex-GetBuiltinIntent-request-uri-signature"></a>
L'identificatore univoco per un intento integrato. *Per trovare la firma di un intento, consulta [Standard Built-in Intents](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) nell'Alexa Skills Kit.*  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBuiltinIntent_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBuiltinIntent_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBuiltinIntent_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [signature](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-signature"></a>
L'identificatore univoco di un intento integrato.  
Tipo: String

 ** [slots](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-slots"></a>
Una serie di `BuiltinIntentSlot` oggetti, una voce per ogni tipo di slot nell'intento.  
Tipo: matrice di oggetti [BuiltinIntentSlot](API_BuiltinIntentSlot.md)

 ** [supportedLocales](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-supportedLocales"></a>
Un elenco di impostazioni locali supportate dall'intento.  
Tipo: array di stringhe  
Valori validi: `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` 

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetBuiltinIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntent) 

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

Consente di ottenere un elenco di intenti integrati che soddisfano i criteri specificati.

Questa operazione richiede l’autorizzazione per l'operazione `lex:GetBuiltinIntents`.

## Sintassi della richiesta
<a name="API_GetBuiltinIntents_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBuiltinIntents_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [locale](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-locale"></a>
Un elenco di impostazioni locali supportate dall'intento.  
Valori validi: `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>
Il numero massimo di intenti da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nextToken](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva di intenti. Se questa chiamata API viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina di intenti successiva, utilizza il token di impaginazione nella richiesta successiva.

 ** [signatureContains](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-signatureContains"></a>
Sottostringa da abbinare alle firme di intento integrate. Verrà restituito un intento se una parte della sua firma corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz». *Per trovare la firma di un intento, consulta [Standard](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) Built-in Intents nell'Alexa Skills Kit.*

## Corpo della richiesta
<a name="API_GetBuiltinIntents_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBuiltinIntents_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBuiltinIntents_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [intents](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-intents"></a>
Una serie di `builtinIntentMetadata` oggetti, uno per ogni intento della risposta.  
Tipo: matrice di oggetti [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md)

 ** [nextToken](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva di intenti. Se la risposta a questa chiamata API viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina di intenti successiva, specifica il token di impaginazione nella richiesta successiva.  
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetBuiltinIntents_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntents) 

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

Restituisce un elenco di tipi di slot integrati che soddisfano i criteri specificati.

Per un elenco dei tipi di slot integrati, consulta [Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) nell'*Alexa Skills Kit*.

Questa operazione richiede l’autorizzazione per l'operazione `lex:GetBuiltInSlotTypes`.

## Sintassi della richiesta
<a name="API_GetBuiltinSlotTypes_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBuiltinSlotTypes_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [locale](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-locale"></a>
Un elenco di impostazioni locali supportate dal tipo di slot.  
Valori validi: `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>
Il numero massimo di tipi di slot da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nextToken](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva dei tipi di slot. Se la risposta a questa chiamata API viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva dei tipi di slot, specifica il token di impaginazione nella richiesta successiva.

 ** [signatureContains](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-signatureContains"></a>
Sottostringa da abbinare alle firme di tipo slot integrate. Verrà restituito un tipo di slot se una parte della sua firma corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».

## Corpo della richiesta
<a name="API_GetBuiltinSlotTypes_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBuiltinSlotTypes_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBuiltinSlotTypes_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [nextToken](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-nextToken"></a>
Se la risposta viene troncata, la risposta include un token di impaginazione che puoi utilizzare nella tua richiesta successiva per recuperare la pagina successiva di tipi di slot.  
Tipo: String

 ** [slotTypes](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-slotTypes"></a>
Viene restituita una matrice di `BuiltInSlotTypeMetadata` oggetti, una voce per ogni tipo di slot.  
Tipo: matrice di oggetti [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md)

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetBuiltinSlotTypes_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 

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

Esporta il contenuto di una risorsa Amazon Lex in un formato specificato. 

## Sintassi della richiesta
<a name="API_GetExport_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetExport_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [exportType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-exportType"></a>
Il formato dei dati esportati.  
Valori validi: `ALEXA_SKILLS_KIT | LEX`   
Obbligatorio: sì

 ** [name](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-name"></a>
Il nome del bot da esportare.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z_]+`   
Obbligatorio: sì

 ** [resourceType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-resourceType"></a>
Il tipo di risorsa da esportare.   
Valori validi: `BOT | INTENT | SLOT_TYPE`   
Obbligatorio: sì

 ** [version](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-version"></a>
La versione del bot da esportare.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetExport_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetExport_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [exportStatus](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportStatus"></a>
Lo stato dell'esportazione.   
+  `IN_PROGRESS`- L'esportazione è in corso.
+  `READY`- L'esportazione è completa.
+  `FAILED`- L'esportazione non può essere completata.
Tipo: String  
Valori validi: `IN_PROGRESS | READY | FAILED` 

 ** [exportType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportType"></a>
Il formato dei dati esportati.  
Tipo: String  
Valori validi: `ALEXA_SKILLS_KIT | LEX` 

 ** [failureReason](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a esportare la risorsa.  
Tipo: String

 ** [name](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-name"></a>
Il nome del bot che viene esportato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-resourceType"></a>
Il tipo di risorsa esportata.  
Tipo: String  
Valori validi: `BOT | INTENT | SLOT_TYPE` 

 ** [url](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-url"></a>
Un URL prefirmato S3 che fornisce la posizione della risorsa esportata. La risorsa esportata è un archivio ZIP che contiene la risorsa esportata in formato JSON. La struttura dell'archivio potrebbe cambiare. Il codice non deve basarsi sulla struttura dell'archivio.  
Tipo: String

 ** [version](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-version"></a>
La versione del bot che viene esportata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetExport_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetExport) 

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

Ottiene informazioni su un processo di importazione iniziato con l'`StartImport`operazione.

## Sintassi della richiesta
<a name="API_GetImport_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetImport_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [importId](#API_GetImport_RequestSyntax) **   <a name="lex-GetImport-request-uri-importId"></a>
L'identificatore delle informazioni sul processo di importazione da restituire.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetImport_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetImport_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [createdDate](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-createdDate"></a>
Un timestamp per la data e l'ora di creazione del processo di importazione.  
Tipo: Timestamp

 ** [failureReason](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-failureReason"></a>
Una stringa che descrive il motivo per cui un processo di importazione non è stato completato.  
Tipo: array di stringhe

 ** [importId](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importId"></a>
L'identificatore per il processo di importazione specifico.  
Tipo: String

 ** [importStatus](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importStatus"></a>
Lo stato del processo di importazione. Se lo stato è`FAILED`, è possibile ottenere il motivo dell'errore dal `failureReason` campo.  
Tipo: String  
Valori validi: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-mergeStrategy"></a>
Azione intrapresa in caso di conflitto tra una risorsa esistente e una risorsa nel file di importazione.  
Tipo: String  
Valori validi: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-name"></a>
Il nome assegnato al processo di importazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-resourceType"></a>
Il tipo di risorsa importata.  
Tipo: String  
Valori validi: `BOT | INTENT | SLOT_TYPE` 

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetImport_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetImport) 

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

 Restituisce informazioni su un intento. Oltre al nome dell'intento, è necessario specificare la versione dell'intento. 

 Questa operazione necessita delle autorizzazioni a eseguire l'operazione `lex:GetIntent`. 

## Sintassi della richiesta
<a name="API_GetIntent_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetIntent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
Il nome dell'intento. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
La versione dell'intento.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetIntent_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetIntent_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
Checksum dell'intento.  
Tipo: String

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
Dopo che la funzione Lambda specificata nell'`fulfillmentActivity`elemento soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.  
Tipo: oggetto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
Se definito nel bot, Amazon Lex utilizza il prompt per confermare l'intento prima di soddisfare la richiesta dell'utente. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
La data di creazione dell'intento.  
Tipo: Timestamp

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
Se definita nel bot, Amazon Amazon Lex richiama questa funzione Lambda per ogni input dell'utente. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
Se definito nel bot, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività dell'utente dopo il raggiungimento dell'intento. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).  
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
Descrive come viene soddisfatto l'intento. Per ulteriori informazioni, consulta [PutIntent](API_PutIntent.md).   
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Informazioni di configurazione, se presenti, per connettersi a un indice Amazon Kendra con l'intento. `AMAZON.KendraSearchIntent`  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.   
Tipo: Timestamp

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
Il nome dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
Una matrice di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
Un identificatore univoco per un intento incorporato.  
Tipo: String

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita in`confirmationPrompt`, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
Una serie di espressioni di esempio configurate per l'intento.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
Una serie di slot di intento configurati per l'intento.  
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
La versione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent) 

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

Restituisce le informazioni sull'intento come segue: 
+ Se si specifica il `nameContains` campo, restituisce la `$LATEST` versione di tutti gli intenti che contengono la stringa specificata.
+  Se non si specifica il `nameContains` campo, restituisce informazioni sulla `$LATEST` versione di tutti gli intenti. 

 L'operazione richiede l'autorizzazione per l'`lex:GetIntents`azione. 

## Sintassi della richiesta
<a name="API_GetIntents_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetIntents_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-maxResults"></a>
Il numero massimo di intenti da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi degli intenti. Verrà restituito un intento se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva di intenti. Se la risposta a questa chiamata API viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina di intenti successiva, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetIntents_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetIntents_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [intents](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-intents"></a>
Un array di oggetti `Intent`. Per ulteriori informazioni, consulta [PutBot](API_PutBot.md).  
Tipo: matrice di oggetti [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-nextToken"></a>
Se la risposta viene troncata, la risposta include un token di impaginazione che puoi specificare nella tua richiesta successiva per recuperare la pagina successiva di intenti.   
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetIntents_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntents) 

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

Ottiene informazioni su tutte le versioni di un intento.

L'`GetIntentVersions`operazione restituisce un `IntentMetadata` oggetto per ogni versione di un intento. Ad esempio, se un intento ha tre versioni numerate, l'`GetIntentVersions`operazione restituisce quattro `IntentMetadata` oggetti nella risposta, uno per ogni versione numerata e uno per la versione. `$LATEST` 

L'`GetIntentVersions`operazione restituisce sempre almeno una versione, la versione. `$LATEST`

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetIntentVersions`.

## Sintassi della richiesta
<a name="API_GetIntentVersions_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetIntentVersions_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-maxResults"></a>
Il numero massimo di versioni di intento da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [name](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-name"></a>
Il nome dell'intento per il quale devono essere restituite le versioni.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [nextToken](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni di intent. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetIntentVersions_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetIntentVersions_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [intents](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-intents"></a>
Una serie di `IntentMetadata` oggetti, uno per ogni versione numerata dell'intento più uno per la versione. `$LATEST`  
Tipo: matrice di oggetti [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni di intent. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

## Errori
<a name="API_GetIntentVersions_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetIntentVersions_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntentVersions) 

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

Fornisce dettagli su una migrazione continua o completa da un bot Amazon Lex V1 a un bot Amazon Lex V2. Utilizza questa operazione per visualizzare gli avvisi e gli avvisi di migrazione relativi alla migrazione.

## Sintassi della richiesta
<a name="API_GetMigration_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetMigration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
L'identificatore univoco della migrazione da visualizzare. `migrationID`Viene restituito dall'[StartMigration](API_StartMigration.md)operazione.  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetMigration_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetMigration_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Un elenco di avvisi e avvisi che indicano problemi con la migrazione del bot Amazon Lex V1 ad Amazon Lex V2. Ricevi un avviso quando una funzionalità di Amazon Lex V1 ha un'implementazione diversa in Amazon Lex V2.  
Per ulteriori informazioni, consulta [Migrazione di un bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) nella guida per *sviluppatori di Amazon Lex V2*.  
Tipo: matrice di oggetti [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
L'identificatore univoco della migrazione. È lo stesso identificatore utilizzato per richiamare l'`GetMigration`operazione.  
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indica lo stato della migrazione. Quando lo stato è, `COMPLETE` la migrazione è terminata e il bot è disponibile in Amazon Lex V2. Potrebbero esserci avvisi e avvisi che devono essere risolti per completare la migrazione.  
Tipo: String  
Valori validi: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
+  `CREATE_NEW`- Crea un nuovo bot Amazon Lex V2 e migra il bot Amazon Lex V1 al nuovo bot.
+  `UPDATE_EXISTING`- Sovrascrive i metadati del bot di Amazon Lex V2 esistenti e le impostazioni locali da migrare. Non modifica le altre impostazioni locali nel bot Amazon Lex V2. Se la locale non esiste, viene creata una nuova locale nel bot Amazon Lex V2.
Tipo: String  
Valori validi: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
La data e l'ora di inizio della migrazione.  
Tipo: Timestamp

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
Le impostazioni locali del bot Amazon Lex V1 sono state migrate su Amazon Lex V2.  
Tipo: String  
Valori validi: `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>
Il nome del bot Amazon Lex V1 è stato migrato ad Amazon Lex V2.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
La versione del bot Amazon Lex V1 è stata migrata ad Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
L'identificatore univoco del bot Amazon Lex V2 verso cui viene effettuata la migrazione di Amazon Lex V1.  
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetMigration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration) 

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

Ottiene un elenco di migrazioni tra Amazon Lex V1 e Amazon Lex V2.

## Sintassi della richiesta
<a name="API_GetMigrations_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetMigrations_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
Il numero massimo di migrazioni da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
Filtra l'elenco per contenere solo le migrazioni nello stato specificato.  
Valori validi: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva delle migrazioni. Se la risposta a questa operazione viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva delle migrazioni, specifica il token di impaginazione nella richiesta.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
Il campo in base al quale ordinare l'elenco delle migrazioni. Puoi ordinare in base al nome del bot di Amazon Lex V1 o alla data e all'ora di inizio della migrazione.  
Valori validi: `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
L'ordine consente di ordinare l'elenco.  
Valori validi: `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
Filtra l'elenco per contenere solo i bot il cui nome contiene la stringa specificata. La stringa trova una corrispondenza in un punto qualsiasi del nome del bot.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

## Corpo della richiesta
<a name="API_GetMigrations_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetMigrations_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Una serie di riepiloghi per le migrazioni da Amazon Lex V1 ad Amazon Lex V2. Per visualizzare i dettagli della migrazione, utilizza il riepilogo `migrationId` contenuto in una chiamata all'operazione. [GetMigration](API_GetMigration.md)  
Tipo: matrice di oggetti [MigrationSummary](API_MigrationSummary.md)

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
Se la risposta viene troncata, include un token di impaginazione che puoi specificare nella tua richiesta successiva per recuperare la pagina successiva di migrazioni.  
Tipo: String

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetMigrations_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations) 

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

Restituisce informazioni su una specifica versione di un tipo di slot. Oltre a specificare il nome del tipo di slot, è necessario specificare la versione del tipo di slot.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetSlotType`.

## Sintassi della richiesta
<a name="API_GetSlotType_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetSlotType_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-name"></a>
Il nome del tipo di slot. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [version](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-version"></a>
La versione del tipo di slot.   
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetSlotType_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_GetSlotType_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-checksum"></a>
Checksum della `$LATEST` versione del tipo di slot.  
Tipo: String

 ** [createdDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-createdDate"></a>
La data di creazione del tipo di slot.  
Tipo: Timestamp

 ** [description](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-description"></a>
Una descrizione del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [enumerationValues](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-enumerationValues"></a>
Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere.  
Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 elementi.

 ** [lastUpdatedDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-lastUpdatedDate"></a>
La data in cui il tipo di slot è stato aggiornato. Quando si crea una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-name"></a>
Il nome del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-parentSlotTypeSignature"></a>
Il tipo di slot integrato utilizzato come elemento principale per il tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-slotTypeConfigurations"></a>
Informazioni di configurazione che estendono il tipo di slot integrato principale.  
Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [valueSelectionStrategy](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-valueSelectionStrategy"></a>
La strategia utilizzata da Amazon Lex per determinare il valore dello slot. Per ulteriori informazioni, consulta [PutSlotType](API_PutSlotType.md).  
Tipo: String  
Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-version"></a>
La versione del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetSlotType_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotType) 

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

Restituisce le informazioni sul tipo di slot come segue: 
+ Se si specifica il `nameContains` campo, restituisce la `$LATEST` versione di tutti i tipi di slot che contengono la stringa specificata.
+  Se non si specifica il `nameContains` campo, restituisce informazioni sulla `$LATEST` versione di tutti i tipi di slot. 

 L'operazione richiede l'autorizzazione per l'`lex:GetSlotTypes`azione. 

## Sintassi della richiesta
<a name="API_GetSlotTypes_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetSlotTypes_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-maxResults"></a>
Il numero massimo di tipi di slot da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [nameContains](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nameContains"></a>
Sottostringa da abbinare nei nomi dei tipi di slot. Un tipo di slot verrà restituito se una parte del suo nome corrisponde alla sottostringa. Ad esempio, «xyz» corrisponde sia a «xyzabc» che a «abcxyz».  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nextToken"></a>
Un token di impaginazione che recupera la pagina successiva dei tipi di slot. Se la risposta a questa chiamata API viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva dei tipi di slot, specifica il token di impaginazione nella richiesta successiva.

## Corpo della richiesta
<a name="API_GetSlotTypes_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
      }
   ]
}
```

## Elementi di risposta
<a name="API_GetSlotTypes_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [nextToken](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-nextToken"></a>
Se la risposta viene troncata, include un token di impaginazione che potete specificare nella richiesta successiva per recuperare la pagina successiva dei tipi di slot.  
Tipo: String

 ** [slotTypes](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-slotTypes"></a>
Una serie di oggetti, uno per ogni tipo di slot, che fornisce informazioni come il nome del tipo di slot, la versione e una descrizione.  
Tipo: matrice di oggetti [SlotTypeMetadata](API_SlotTypeMetadata.md)

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetSlotTypes_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypes) 

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

Ottiene informazioni su tutte le versioni di un tipo di slot.

L'`GetSlotTypeVersions`operazione restituisce un `SlotTypeMetadata` oggetto per ogni versione di un tipo di slot. Ad esempio, se un tipo di slot ha tre versioni numerate, l'`GetSlotTypeVersions`operazione restituisce quattro `SlotTypeMetadata` oggetti nella risposta, uno per ogni versione numerata e uno per la `$LATEST` versione. 

L'`GetSlotTypeVersions`operazione restituisce sempre almeno una versione, la `$LATEST` versione.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetSlotTypeVersions`.

## Sintassi della richiesta
<a name="API_GetSlotTypeVersions_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetSlotTypeVersions_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-maxResults"></a>
Il numero massimo di versioni del tipo di slot da restituire nella risposta. Il valore predefinito è 10.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

 ** [name](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-name"></a>
Il nome del tipo di slot per il quale devono essere restituite le versioni.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [nextToken](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni di tipo slot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva. 

## Corpo della richiesta
<a name="API_GetSlotTypeVersions_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
      }
   ]
}
```

## Elementi di risposta
<a name="API_GetSlotTypeVersions_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [nextToken](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-nextToken"></a>
Un token di impaginazione per recuperare la pagina successiva delle versioni di tipo slot. Se la risposta a questa chiamata viene troncata, Amazon Lex restituisce un token di impaginazione nella risposta. Per recuperare la pagina successiva di versioni, specifica il token di impaginazione nella richiesta successiva.   
Tipo: String

 ** [slotTypes](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-slotTypes"></a>
Una serie di `SlotTypeMetadata` oggetti, uno per ogni versione numerata del tipo di slot più uno per la versione. `$LATEST`  
Tipo: matrice di oggetti [SlotTypeMetadata](API_SlotTypeMetadata.md)

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

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_GetSlotTypeVersions_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypeVersions) 

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

Usa l'`GetUtterancesView`operazione per ottenere informazioni sulle espressioni che i tuoi utenti hanno fatto al tuo bot. Puoi usare questo elenco per ottimizzare gli enunciati a cui risponde il bot.

Ad esempio, supponiamo di aver creato un bot per ordinare fiori. Dopo che gli utenti hanno utilizzato il bot per un certo periodo, utilizzate l'`GetUtterancesView`operazione per vedere le richieste che hanno fatto e se hanno avuto successo. Potresti scoprire che l'espressione «Voglio dei fiori» non viene riconosciuta. È possibile aggiungere questo enunciato all'`OrderFlowers`intento in modo che il bot lo riconosca.

Dopo aver pubblicato una nuova versione di un bot, è possibile ottenere informazioni sulla versione precedente e sulla nuova in modo da poter confrontare le prestazioni tra le due versioni. 

Una volta al giorno vengono create le statistiche delle enunciazioni. I dati sono disponibili per gli ultimi 15 giorni. Puoi richiedere informazioni per un massimo di 5 versioni del tuo bot per ogni richiesta. Amazon Lex restituisce gli enunciati più frequenti ricevuti dal bot negli ultimi 15 giorni. La risposta contiene informazioni su un massimo di 100 enunciati per ogni versione.

Le statistiche sugli enunciati non vengono generate nelle seguenti condizioni:
+ Il `childDirected` campo era impostato su true al momento della creazione del bot.
+ Stai usando l'offuscamento degli slot con uno o più slot.
+ Hai scelto di non partecipare al miglioramento di Amazon Lex.

Questa operazione richiede le autorizzazioni per l'operazione `lex:GetUtterancesView`.

## Sintassi della richiesta
<a name="API_GetUtterancesView_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetUtterancesView_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botname](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botName"></a>
Il nome del bot per il quale devono essere restituite le informazioni sull'enunciato.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [botVersions](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botVersions"></a>
Una serie di versioni dei bot per le quali devono essere restituite le informazioni sull'enunciato. Il limite è di 5 versioni per richiesta.  
Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

 ** [statusType](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-statusType"></a>
Per restituire enunciati che sono stati riconosciuti e gestiti, usa. `Detected` Per restituire enunciati che non sono stati riconosciuti, usa. `Missed`  
Valori validi: `Detected | Missed`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetUtterancesView_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
            }
         ]
      }
   ]
}
```

## Elementi di risposta
<a name="API_GetUtterancesView_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botName](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-botName"></a>
Il nome del bot per il quale sono state restituite le informazioni sull'enunciato.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [utterances](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-utterances"></a>
Una serie di [UtteranceList](API_UtteranceList.md) oggetti, ciascuno contenente un elenco di [UtteranceData](API_UtteranceData.md) oggetti che descrivono gli enunciati elaborati dal bot. La risposta contiene un massimo di 100 `UtteranceData` oggetti per ogni versione. Amazon Lex restituisce gli enunciati più frequenti ricevuti dal bot negli ultimi 15 giorni.  
Tipo: matrice di oggetti [UtteranceList](API_UtteranceList.md)

## Errori
<a name="API_GetUtterancesView_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_GetUtterancesView_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Ottiene un elenco di tag associati alla risorsa specificata. Solo ai bot, agli alias dei bot e ai canali dei bot possono essere associati tag.

## Sintassi della richiesta
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListTagsForResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="lex-ListTagsForResource-request-uri-resourceArn"></a>
L'Amazon Resource Name (ARN) della risorsa per cui ottenere un elenco di tag.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_ListTagsForResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListTagsForResource_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="lex-ListTagsForResource-response-tags"></a>
I tag associati a una risorsa.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

## Errori
<a name="API_ListTagsForResource_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_ListTagsForResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ListTagsForResource) 

# PutBot
<a name="API_PutBot"></a>

Crea un bot conversazionale Amazon Lex o sostituisce un bot esistente. Quando crei o aggiorni un bot, ti viene richiesto solo di specificare un nome, una lingua e se il bot è rivolto a bambini di età inferiore ai 13 anni. Puoi usarlo per aggiungere intenti in un secondo momento o per rimuovere intenti da un bot esistente. Quando crei un bot con le informazioni minime, il bot viene creato o aggiornato ma Amazon Lex restituisce la `` risposta`FAILED`. Puoi creare il bot dopo aver aggiunto uno o più intenti. Per ulteriori informazioni sui bot Amazon Lex, consulta[Amazon Lex: come funziona](how-it-works.md). 

Se specifichi il nome di un bot esistente, i campi della richiesta sostituiscono i valori esistenti nella `$LATEST` versione del bot. Amazon Lex rimuove tutti i campi per i quali non vengono forniti valori nella richiesta, ad eccezione dei `privacySettings` campi `idleTTLInSeconds` e, che sono impostati sui valori predefiniti. Se non specifichi valori per i campi obbligatori, Amazon Lex genera un'eccezione.

Questa operazione richiede le autorizzazioni per l'operazione `lex:PutBot`. Per ulteriori informazioni, consulta [Identity and Access Management per Amazon Lex](security-iam.md).

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI
<a name="API_PutBot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-uri-name"></a>
Il nome del bot. Il nome *non* fa distinzione tra maiuscole e minuscole.   
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutBot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [abortStatement](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-abortStatement"></a>
Quando Amazon Lex non è in grado di comprendere l'input dell'utente nel contesto, tenta di richiamare le informazioni alcune volte. Successivamente, Amazon Lex invia il messaggio definito `abortStatement` all'utente e quindi annulla la conversazione. Per impostare il numero di tentativi, utilizza il `valueElicitationPrompt` campo per il tipo di slot.   
Ad esempio, in un bot per ordinare pizze, Amazon Lex potrebbe chiedere a un utente «Che tipo di crosta preferisci?» Se la risposta dell'utente non è una delle risposte previste (ad esempio, «crosta sottile», «piatto profondo», ecc.), Amazon Lex tenta di ottenere una risposta corretta ancora qualche volta.   
Ad esempio, in un'applicazione per ordinare pizze, `OrderPizza` potrebbe essere uno degli intenti. Questo intento potrebbe richiedere lo slot. `CrustType` Il `valueElicitationPrompt` campo viene specificato quando si crea lo `CrustType` slot.  
Se è stato definito un intento di fallback, l'istruzione cancel non verrà inviata all'utente, ma verrà utilizzato l'intento di fallback. [Per ulteriori informazioni, consulta AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Tipo: oggetto [Statement](API_Statement.md)  
Obbligatorio: no

 ** [checksum](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-checksum"></a>
Identifica una revisione specifica della `$LATEST` versione.  
Quando crei un nuovo bot, lascia il `checksum` campo vuoto. Se si specifica un checksum si ottiene un'`BadRequestException`eccezione.  
Quando vuoi aggiornare un bot, imposta il `checksum` campo sul checksum della revisione più recente della versione. `$LATEST` Se non specifichi il ` checksum` campo o se il checksum non corrisponde alla `$LATEST` versione, ottieni un'eccezione. `PreconditionFailedException`  
▬Tipo: stringa  
Obbligatorio: no

 ** [childDirected](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-childDirected"></a>
Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando `true` o `false` nel `childDirected` campo. Specificando `true` nel `childDirected` campo, confermi che l'uso di Amazon Lex **è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando `false` nel `childDirected` campo, confermi che l'uso di Amazon Lex **non è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il `childDirected` campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.  
Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le [domande frequenti su Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Tipo: Booleano  
Obbligatorio: sì

 ** [clarificationPrompt](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-clarificationPrompt"></a>
Quando Amazon Lex non comprende l'intenzione dell'utente, utilizza questo messaggio per ottenere chiarimenti. Per specificare quante volte Amazon Lex deve ripetere la richiesta di chiarimento, utilizza il `maxAttempts` campo. Se Amazon Lex continua a non capire, invia il messaggio nel `abortStatement` campo.   
Quando crei una richiesta di chiarimento, assicurati che suggerisca la risposta corretta dell'utente. Ad esempio, per un bot che ordina pizza e bevande, potresti creare questo messaggio di chiarimento: «Cosa vorresti fare? Puoi dire 'Ordina una pizza' o 'Ordina un drink. '»  
Se hai definito un intento di riserva, questo verrà invocato se la richiesta di chiarimento viene ripetuta il numero di volte definito nel campo. `maxAttempts` [Per ulteriori informazioni, consulta AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Se non definisci una richiesta di chiarimento, in fase di esecuzione Amazon Lex restituirà un'eccezione 400 Bad Request in tre casi:   
+ Richiesta di follow-up: quando l'utente risponde a una richiesta di follow-up ma non fornisce un'intenzione. Ad esempio, in risposta a una richiesta di follow-up che dice «Vuoi qualcos'altro oggi?» l'utente dice «Sì». Amazon Lex restituirà un'eccezione 400 Bad Request perché non dispone di un messaggio di chiarimento da inviare all'utente per determinare l'intento.
+ Funzione Lambda: quando si utilizza una funzione Lambda, si restituisce un tipo di dialogo. `ElicitIntent` Poiché Amazon Lex non dispone di una richiesta di chiarimento per ottenere un'intenzione dall'utente, restituisce un'eccezione 400 Bad Request.
+ PutSession operazione: quando si utilizza l'`PutSession`operazione, si invia un `ElicitIntent` tipo di dialogo. Poiché Amazon Lex non dispone di una richiesta di chiarimento per ottenere un'intenzione dall'utente, restituisce un'eccezione 400 Bad Request.
Tipo: oggetto [Prompt](API_Prompt.md)  
Obbligatorio: no

 ** [createVersion](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-createVersion"></a>
Se impostato su, viene creata `true` una nuova versione numerata del bot. È lo stesso che chiamare l'`CreateBotVersion`operazione. Se non si specifica`createVersion`, l'impostazione predefinita è`false`.  
Tipo: Booleano  
Obbligatorio: no

 ** [description](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-description"></a>
Una descrizione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Obbligatorio: no

 ** [detectSentiment](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-detectSentiment"></a>
Se impostato su `true` utente, gli enunciati vengono inviati ad Amazon Comprehend per l'analisi del sentiment. Se non lo specifichi`detectSentiment`, l'impostazione predefinita è. `false`  
Tipo: Booleano  
Obbligatorio: no

 ** [enableModelImprovements](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-enableModelImprovements"></a>
Impostato `true` per consentire l'accesso ai miglioramenti della comprensione del linguaggio naturale.   
Quando si imposta il `enableModelImprovements` parametro su, `true` è possibile utilizzarlo per configurare i `nluIntentConfidenceThreshold` punteggi di confidenza. Per ulteriori informazioni, vedere [Confidence Scores](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
È possibile impostare il `enableModelImprovements` parametro solo in determinate regioni. Se imposti il parametro su`true`, il bot ha accesso a miglioramenti della precisione.  
Le regioni in cui è possibile impostare il `enableModelImprovements` parametro `false` per la localizzazione en-US sono:  
+ Stati Uniti orientali (Virginia settentrionale) (us-east-1)
+ Stati Uniti occidentali (Oregon) (us-west-2)
+ Asia Pacifico (Sydney) (ap-southeast-2)
+ UE (Irlanda): eu-west-1
In altre regioni e impostazioni locali, il `enableModelImprovements` parametro è impostato su come impostazione predefinita`true`. In queste regioni e impostazioni locali, l'impostazione del parametro to `false` genera un'eccezione. `ValidationException`  
Tipo: Booleano  
Obbligatorio: no

 ** [idleSessionTTLInSeconds](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-idleSessionTTLInSeconds"></a>
Il tempo massimo, in secondi, durante il quale Amazon Lex conserva i dati raccolti in una conversazione.  
Una sessione di interazione con l'utente rimane attiva per il periodo di tempo specificato. Se durante questo periodo non si verifica alcuna conversazione, la sessione scade e Amazon Lex elimina tutti i dati forniti prima del timeout.  
Ad esempio, supponiamo che un utente scelga l' OrderPizza intento, ma venga distratto a metà dell'ordine. Se l'utente non completa l'ordine entro il tempo specificato, Amazon Lex elimina le informazioni sullo slot raccolte e l'utente deve ricominciare da capo.  
Se non includi l'`idleSessionTTLInSeconds`elemento in una richiesta di `PutBot` operazione, Amazon Lex utilizza il valore predefinito. Questo vale anche se la richiesta sostituisce un bot esistente.  
Il valore predefinito è 300 secondi (5 minuti).  
Tipo: numero intero  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.  
Obbligatorio: no

 ** [intents](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-intents"></a>
Un array di oggetti `Intent`. Ogni intento rappresenta un comando che un utente può esprimere. Ad esempio, un bot per ordinare pizze potrebbe supportare un OrderPizza intento. Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md).  
Tipo: matrice di oggetti [Intent](API_Intent.md)  
Obbligatorio: no

 ** [locale](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-locale"></a>
 Specifica il locale di destinazione per il bot. Qualsiasi intento utilizzato nel bot deve essere compatibile con le impostazioni locali del bot.   
Il valore predefinito è `en-US`.  
Tipo: String  
Valori validi: `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`   
Obbligatorio: sì

 ** [nluIntentConfidenceThreshold](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-nluIntentConfidenceThreshold"></a>
Determina la soglia in cui Amazon Lex inserirà o entrambi quando restituisce intenti alternativi in una [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)risposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o. `AMAZON.FallbackIntent` `AMAZON.KendraSearchIntent` `AMAZON.FallbackIntent`e `AMAZON.KendraSearchIntent` vengono inseriti solo se sono configurati per il bot.  
È necessario impostare il `enableModelImprovements` parametro per `true` utilizzare i punteggi di confidenza nelle seguenti regioni.  
+ Stati Uniti orientali (Virginia settentrionale) (us-east-1)
+ Stati Uniti occidentali (Oregon) (us-west-2)
+ Asia Pacifico (Sydney) (ap-southeast-2)
+ UE (Irlanda): eu-west-1
In altre regioni, il `enableModelImprovements` parametro è impostato come `true` impostazione predefinita.  
Ad esempio, supponiamo che un bot sia configurato con la soglia di confidenza di 0,80 e il. `AMAZON.FallbackIntent` Amazon Lex restituisce tre intenti alternativi con i seguenti punteggi di confidenza: intentA (0,70), IntentB (0,60), IntentC (0,50). La risposta dell'operazione sarebbe: `PostText`  
+ AMAZON. FallbackIntent
+ a Tenta
+ Intento B
+ Intento C
Tipo: numero a doppia precisione  
Intervallo valido: valore minimo di 0. Valore massimo di 1.  
Obbligatorio: no

 ** [processBehavior](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-processBehavior"></a>
Se imposti l'`processBehavior`elemento su`BUILD`, Amazon Lex crea il bot in modo che possa essere eseguito. Se imposti l'elemento `SAVE` su Amazon Lex, il bot viene salvato, ma non lo crea.   
Se non specifichi questo valore, il valore predefinito è`BUILD`.  
Tipo: String  
Valori validi: `SAVE | BUILD`   
Campo obbligatorio: no

 ** [tags](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-tags"></a>
Un elenco di tag da aggiungere al bot. È possibile aggiungere tag solo quando si crea un bot, non è possibile utilizzare l'`PutBot`operazione per aggiornare i tag su un bot. Per aggiornare i tag, utilizza l'operazione `TagResource`.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

 ** [voiceId](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-voiceId"></a>
L'ID vocale Amazon Polly che desideri venga utilizzato da Amazon Lex per le interazioni vocali con l'utente. Le impostazioni locali configurate per la voce devono corrispondere alle impostazioni locali del bot. Per ulteriori informazioni, consulta [Voices in Amazon Polly nella Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) *Developer Guide*.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_PutBot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [abortStatement](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-abortStatement"></a>
Il messaggio che Amazon Lex utilizza per annullare una conversazione. Per ulteriori informazioni, consulta [PutBot](#API_PutBot).  
Tipo: oggetto [Statement](API_Statement.md)

 ** [checksum](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-checksum"></a>
Checksum del bot che hai creato.  
Tipo: String

 ** [childDirected](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-childDirected"></a>
Per ogni bot Amazon Lex creato con Amazon Lex Model Building Service, devi specificare se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al Children's Online Privacy Protection Act (COPPA) specificando `true` o `false` nel `childDirected` campo. Specificando `true` nel `childDirected` campo, confermi che l'uso di Amazon Lex **è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetto al COPPA. Specificando `false` nel `childDirected` campo, confermi che l'uso di Amazon Lex **non è** correlato a un sito Web, programma o altra applicazione indirizzato o destinato, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetti al COPPA. Non puoi specificare un valore predefinito per il `childDirected` campo che non riflette accuratamente se l'uso di Amazon Lex è correlato a un sito Web, programma o altra applicazione indirizzata o destinata, in tutto o in parte, a bambini di età inferiore ai 13 anni e soggetta al COPPA.  
Se l'uso di Amazon Lex si riferisce a un sito Web, programma o altra applicazione rivolta, in tutto o in parte, a bambini di età inferiore ai 13 anni, devi ottenere il consenso genitoriale verificabile richiesto ai sensi del COPPA. Per informazioni sull'uso di Amazon Lex in relazione a siti Web, programmi o altre applicazioni rivolti o destinati, in tutto o in parte, a bambini di età inferiore ai 13 anni, consulta le [domande frequenti su Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Tipo: Booleano

 ** [clarificationPrompt](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-clarificationPrompt"></a>
 I prompt che Amazon Lex utilizza quando non comprende le intenzioni dell'utente. Per ulteriori informazioni, consulta [PutBot](#API_PutBot).   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createdDate"></a>
La data di creazione del bot.  
Tipo: Timestamp

 ** [createVersion](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createVersion"></a>
 `True`se è stata creata una nuova versione del bot. Se il `createVersion` campo non è stato specificato nella richiesta, il `createVersion` campo è impostato su false nella risposta.  
Tipo: Booleano

 ** [description](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-description"></a>
Una descrizione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [detectSentiment](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-detectSentiment"></a>
 `true`se il bot è configurato per inviare le espressioni degli utenti ad Amazon Comprehend per l'analisi del sentiment. Se il `detectSentiment` campo non è stato specificato nella richiesta, si `detectSentiment` trova `false` nella risposta.  
Tipo: Booleano

 ** [enableModelImprovements](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-enableModelImprovements"></a>
Indica se il bot utilizza miglioramenti di precisione. `true`indica che il bot sta utilizzando i miglioramenti, altrimenti`false`.  
Tipo: Booleano

 ** [failureReason](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a creare il bot.  
Tipo: String

 ** [idleSessionTTLInSeconds](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-idleSessionTTLInSeconds"></a>
Il periodo massimo di conservazione dei dati raccolti in una conversazione da parte di Amazon Lex. Per ulteriori informazioni, consulta [PutBot](#API_PutBot).  
Tipo: numero intero  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 86400.

 ** [intents](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-intents"></a>
Un array di oggetti `Intent`. Per ulteriori informazioni, consulta [PutBot](#API_PutBot).  
Tipo: matrice di oggetti [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-lastUpdatedDate"></a>
La data in cui il bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [locale](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-locale"></a>
 Il locale di destinazione per il bot.   
Tipo: String  
Valori validi: `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>
Il nome del bot.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-nluIntentConfidenceThreshold"></a>
Il punteggio che determina dove Amazon Lex inserisce o entrambi quando restituisce intenti alternativi in una risposta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html). `AMAZON.FallbackIntent` `AMAZON.KendraSearchIntent` `AMAZON.FallbackIntent`viene inserito se il punteggio di confidenza a tutti gli effetti è inferiore a questo valore. `AMAZON.KendraSearchIntent`viene inserito solo se è configurato per il bot.  
Tipo: numero a doppia precisione  
Intervallo valido: valore minimo di 0. Valore massimo di 1.

 ** [status](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-status"></a>
 Quando invii una richiesta per creare un bot con `processBehavior` set to`BUILD`, Amazon Lex imposta l'elemento di `status` risposta su`BUILDING`.  
`READY_BASIC_TESTING`Nello stato, puoi testare il bot con input utente che corrispondono esattamente alle espressioni configurate per gli intenti e i valori del bot nei tipi di slot.  
Se Amazon Lex non è in grado di creare il bot, Amazon Lex decide `status` di farlo`FAILED`. Amazon Lex restituisce il motivo dell'errore nell'elemento di `failureReason` risposta.   
Quando lo `processBehavior` imposti`SAVE`, Amazon Lex imposta il codice di stato su`NOT BUILT`.  
Quando il bot è nello `READY` stato, puoi testarlo e pubblicarlo.  
Tipo: String  
Valori validi: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [tags](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-tags"></a>
Un elenco di tag associati al bot.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

 ** [version](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-version"></a>
La versione del bot. Per un nuovo bot, la versione è sempre`$LATEST`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-voiceId"></a>
L'ID vocale Amazon Polly utilizzato da Amazon Lex per l'interazione vocale con l'utente. Per ulteriori informazioni, consulta [PutBot](#API_PutBot).  
Tipo: String

## Errori
<a name="API_PutBot_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_PutBot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBot) 

# PutBotAlias
<a name="API_PutBotAlias"></a>

Crea un alias per la versione specificata del bot o sostituisce un alias per il bot specificato. Per cambiare la versione del bot a cui punta l'alias, sostituisci l'alias. Per ulteriori informazioni sugli alias, consultare [Funzione Versioni multiple e alias](versioning-aliases.md).

Questa operazione richiede le autorizzazioni per l'operazione `lex:PutBotAlias`. 

## Sintassi della richiesta
<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"
      }
   ]
}
```

## Parametri della richiesta URI
<a name="API_PutBotAlias_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
Il nome del bot.  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
Nome dell'alias. Il nome *non fa distinzione tra maiuscole e minuscole*.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutBotAlias_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></a>
La versione del bot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
Identifica una revisione specifica della `$LATEST` versione.  
Quando crei un nuovo alias bot, lascia il `checksum` campo vuoto. Se si specifica un checksum si ottiene un'`BadRequestException`eccezione.  
Quando desideri aggiornare un alias bot, imposta il `checksum` campo sul checksum della revisione più recente della versione. `$LATEST` Se non specifichi il ` checksum` campo o se il checksum non corrisponde alla `$LATEST` versione, ottieni un'eccezione. `PreconditionFailedException`  
▬Tipo: stringa  
Obbligatorio: no

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
Impostazioni per i registri delle conversazioni per l'alias.  
Tipo: oggetto [ConversationLogsRequest](API_ConversationLogsRequest.md)  
Obbligatorio: no

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
Una descrizione degli alias.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Obbligatorio: no

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
Un elenco di tag da aggiungere all'alias del bot. È possibile aggiungere tag solo quando si crea un alias, non è possibile utilizzare l'`PutBotAlias`operazione per aggiornare i tag su un alias bot. Per aggiornare i tag, utilizza l'operazione `TagResource`.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

## Sintassi della risposta
<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"
      }
   ]
}
```

## Elementi di risposta
<a name="API_PutBotAlias_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botName](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
Il nome del bot a cui punta l'alias.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
La versione del bot a cui punta l'alias.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
Il checksum per la versione corrente dell'alias.  
Tipo: String

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
Le impostazioni che determinano in che modo Amazon Lex utilizza i log delle conversazioni per l'alias.  
Tipo: oggetto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
La data di creazione dell'alias del bot.  
Tipo: Timestamp

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
Una descrizione degli alias.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
La data in cui l'alias del bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-name"></a>
Nome dell'alias.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
Un elenco di tag associati a un bot.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

## Errori
<a name="API_PutBotAlias_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_PutBotAlias_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias) 

# PutIntent
<a name="API_PutIntent"></a>

Crea un intento o sostituisce un intento esistente.

Per definire l'interazione tra l'utente e il bot, si utilizzano uno o più intenti. Per un bot che ordina pizze, ad esempio, dovresti creare un `OrderPizza` intento. 

Per creare un intento o sostituire un intento esistente, devi fornire quanto segue:
+ Nome dell'intento. Ad esempio, `OrderPizza`.
+ Esempi di enunciati. Ad esempio, «Posso ordinare una pizza, per favore». e «Voglio ordinare una pizza».
+ Informazioni da raccogliere. Specificate i tipi di slot per le informazioni che il bot richiederà all'utente. È possibile specificare tipi di slot standard, come una data o un'ora, o tipi di slot personalizzati come la dimensione e la crosta di una pizza.
+ Come verrà realizzato l'intento. È possibile fornire una funzione Lambda o configurare l'intento di restituire le informazioni sull'intento all'applicazione client. Se usi una funzione Lambda, quando tutte le informazioni sull'intento sono disponibili, Amazon Lex richiama la tua funzione Lambda. Se configuri l'intenzione di restituire le informazioni sull'intento all'applicazione client. 

È possibile specificare altre informazioni opzionali nella richiesta, ad esempio:
+ Una richiesta di conferma per chiedere all'utente di confermare un'intenzione. Ad esempio, «Devo ordinare la tua pizza?»
+ Una dichiarazione conclusiva da inviare all'utente dopo che l'intento è stato raggiunto. Ad esempio, «Ho ordinato la tua pizza».
+ Una richiesta di follow-up che richiede all'utente attività aggiuntive. Ad esempio, chiedendo «Vuoi ordinare qualcosa da bere con la tua pizza?»

Se specifichi un nome di intento esistente per aggiornare l'intento, Amazon Lex sostituisce i valori nella `$LATEST` versione dell'intento con i valori nella richiesta. Amazon Lex rimuove i campi che non fornisci nella richiesta. Se non specifichi i campi obbligatori, Amazon Lex genera un'eccezione. Quando aggiorni la `$LATEST` versione di un intento, il `status` campo di qualsiasi bot che utilizza la `$LATEST` versione dell'intento viene impostato su. `NOT_BUILT`

Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md).

Questa operazione richiede le autorizzazioni per l'operazione `lex:PutIntent`.

## Sintassi della richiesta
<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"
         }
      }
   ]
}
```

## Parametri della richiesta URI
<a name="API_PutIntent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-uri-name"></a>
Il nome dell'intento. Il nome *non fa distinzione tra maiuscole e minuscole*.   
Il nome non può corrispondere a un nome di intento incorporato o a un nome di intento integrato con «AMAZON». rimosso. Ad esempio, poiché esiste un intento integrato chiamato`AMAZON.HelpIntent`, non è possibile creare un intento personalizzato chiamato. `HelpIntent`  
Per un elenco di intenti incorporati, consulta la sezione relativa agli [intenti incorporati standard](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) in *Alexa Skills Kit*.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutIntent_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-checksum"></a>
Identifica una revisione specifica della versione. `$LATEST`  
Quando crei un nuovo intento, lascia il `checksum` campo vuoto. Se si specifica un checksum si ottiene un'`BadRequestException`eccezione.  
Quando desideri aggiornare un intento, imposta il `checksum` campo sul checksum della revisione più recente della versione. `$LATEST` Se non specifichi il ` checksum` campo o se il checksum non corrisponde alla `$LATEST` versione, ottieni un'eccezione. `PreconditionFailedException`  
▬Tipo: stringa  
Obbligatorio: no

 ** [conclusionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-conclusionStatement"></a>
 L'istruzione che desideri che Amazon Lex trasmetta all'utente dopo che l'intento è stato soddisfatto con successo dalla funzione Lambda.   
Questo elemento è rilevante solo se si fornisce una funzione Lambda in. `fulfillmentActivity` Se restituisci l'intento all'applicazione client, non puoi specificare questo elemento.  
I `followUpPrompt` e si `conclusionStatement` escludono a vicenda. È possibile specificarne solo uno.
Tipo: oggetto [Statement](API_Statement.md)  
Obbligatorio: no

 ** [confirmationPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-confirmationPrompt"></a>
Richiede all'utente di confermare l'intento. Questa domanda dovrebbe avere una risposta sì o no.  
Amazon Lex utilizza questo prompt per garantire che l'utente riconosca che l'intento è pronto per l'adempimento. Ad esempio, con l'`OrderPizza`intento, potresti voler confermare che l'ordine è corretto prima di effettuarlo. Per altri scopi, ad esempio intenti a rispondere semplicemente alle domande degli utenti, potrebbe non essere necessario chiedere conferma all'utente prima di fornire le informazioni.   
È necessario fornire sia il che il `rejectionStatement``confirmationPrompt`, oppure nessuno dei due.
Tipo: oggetto [Prompt](API_Prompt.md)  
Obbligatorio: no

 ** [createVersion](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-createVersion"></a>
Se impostato su `true` una nuova versione numerata dell'intento, viene creata. È lo stesso che chiamare l'`CreateIntentVersion`operazione. Se non si specifica`createVersion`, l'impostazione predefinita è`false`.  
Tipo: Booleano  
Obbligatorio: no

 ** [description](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Obbligatorio: no

 ** [dialogCodeHook](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-dialogCodeHook"></a>
 Specifica una funzione Lambda da richiamare per ogni input dell'utente. È possibile richiamare questa funzione Lambda per personalizzare l'interazione dell'utente.   
Ad esempio, supponiamo che il bot determini che l'utente è John. La tua funzione Lambda potrebbe recuperare le informazioni di John da un database di backend e precompilare alcuni valori. Ad esempio, se scopri che John è intollerante al glutine, puoi impostare lo slot di intenti corrispondente, su true. `GlutenIntolerant` Potresti trovare il numero di telefono di John e impostare l'attributo di sessione corrispondente.   
Tipo: oggetto [CodeHook](API_CodeHook.md)  
Obbligatorio: no

 ** [followUpPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-followUpPrompt"></a>
Amazon Lex utilizza questo prompt per sollecitare attività aggiuntive dopo aver soddisfatto un intento. Ad esempio, una volta raggiunto l'`OrderPizza`intento, potresti richiedere all'utente di ordinare un drink.  
L'azione intrapresa da Amazon Lex dipende dalla risposta dell'utente, come segue:  
+ Se l'utente dice «Sì», risponde con la richiesta di chiarimento configurata per il bot.
+ se l'utente dice «Sì» e continua con un'espressione che fa scattare un intento, avvia una conversazione sull'intento.
+ Se l'utente dice «No», risponde con la dichiarazione di rifiuto configurata per la richiesta di follow-up.
+ Se non riconosce l'enunciato, ripete nuovamente la richiesta di follow-up.
Il `followUpPrompt` campo e il campo si escludono a `conclusionStatement` vicenda. È possibile specificarne solo uno.   
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)  
Obbligatorio: no

 ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-fulfillmentActivity"></a>
Obbligatorio. Descrive come viene soddisfatto l'intento. Ad esempio, dopo che un utente ha fornito tutte le informazioni per un ordine di pizza, `fulfillmentActivity` definisce in che modo il bot effettua un ordine presso una pizzeria locale.   
 Puoi configurare Amazon Lex per restituire tutte le informazioni sull'intento all'applicazione client o indirizzarla a richiamare una funzione Lambda in grado di elaborare l'intento (ad esempio, effettuare un ordine presso una pizzeria).   
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)  
Obbligatorio: no

 ** [inputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.  
Obbligatorio: no

 ** [kendraConfiguration](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-kendraConfiguration"></a>
Informazioni di configurazione necessarie per utilizzare l'`AMAZON.KendraSearchIntent`intento di connessione a un indice Amazon Kendra. [Per ulteriori informazioni, consulta AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)  
Obbligatorio: no

 ** [outputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-outputContexts"></a>
Una serie di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Obbligatorio: no

 ** [parentIntentSignature](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-parentIntentSignature"></a>
Un identificativo univoco dell'intento integrato su cui basare questo intento. *Per trovare la firma di un intento, consulta [Standard Built-in](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) Intents nell'Alexa Skills Kit.*  
▬Tipo: stringa  
Obbligatorio: no

 ** [rejectionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-rejectionStatement"></a>
Quando l'utente risponde «no» alla domanda definita in`confirmationPrompt`, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Devi fornire sia il che il, oppure nessuno `rejectionStatement` dei `confirmationPrompt` due.
Tipo: oggetto [Statement](API_Statement.md)  
Obbligatorio: no

 ** [sampleUtterances](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-sampleUtterances"></a>
Una serie di enunciati (stringhe) che un utente potrebbe pronunciare per segnalare l'intento. Ad esempio, «I want \$1PizzaSize\$1 pizza», «Order \$1Quantity\$1 \$1PizzaSize\$1 pizze».   
In ogni enunciato, il nome di uno slot è racchiuso tra parentesi graffe.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.  
Obbligatorio: no

 ** [slots](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-slots"></a>
Una serie di slot di intenti. In fase di esecuzione, Amazon Lex richiede all'utente i valori degli slot richiesti utilizzando i prompt definiti negli slot. Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md).   
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_PutIntent_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-checksum"></a>
Checksum della `$LATEST` versione dell'intento creata o aggiornata.  
Tipo: String

 ** [conclusionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-conclusionStatement"></a>
Dopo che la funzione Lambda specificata nell'`fulfillmentActivity`intento soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.  
Tipo: oggetto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-confirmationPrompt"></a>
Se definito nell'intento, Amazon Lex richiede all'utente di confermare l'intento prima di realizzarlo.  
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createdDate"></a>
La data in cui è stato creato l'intento.  
Tipo: Timestamp

 ** [createVersion](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createVersion"></a>
 `True`se è stata creata una nuova versione dell'intento. Se il `createVersion` campo non è stato specificato nella richiesta, il `createVersion` campo è impostato su false nella risposta.  
Tipo: Booleano

 ** [description](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-dialogCodeHook"></a>
Se definita nell'intento, Amazon Lex richiama questa funzione Lambda per ogni input dell'utente.  
Tipo: oggetto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-followUpPrompt"></a>
Se definito nell'intento, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività dell'utente dopo il raggiungimento dell'intento.  
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-fulfillmentActivity"></a>
Se definita nell'intento, Amazon Lex richiama questa funzione Lambda per soddisfare l'intento dopo che l'utente ha fornito tutte le informazioni richieste dall'intento.  
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

 ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-kendraConfiguration"></a>
Informazioni di configurazione, se presenti, necessarie per connettersi a un indice Amazon Kendra e utilizzare l'intento. `AMAZON.KendraSearchIntent`  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato. Quando crei una risorsa, la data di creazione e le date dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-name"></a>
Il nome dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-outputContexts"></a>
Una matrice di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-parentIntentSignature"></a>
Un identificatore univoco per l'intento incorporato su cui si basa questo intento.  
Tipo: String

 ** [rejectionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita in `confirmationPrompt` Amazon Lex, risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-sampleUtterances"></a>
 Una serie di espressioni di esempio configurate per l'intento.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

 ** [slots](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-slots"></a>
Una serie di slot di intento configurati per l'intento.  
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

 ** [version](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-version"></a>
La versione dell'intento. Per un nuovo intento, la versione è sempre. `$LATEST`  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

## Errori
<a name="API_PutIntent_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_PutIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent) 

# PutSlotType
<a name="API_PutSlotType"></a>

Crea un tipo di slot personalizzato o sostituisce un tipo di slot personalizzato esistente.

Per creare un tipo di slot personalizzato, specificate un nome per il tipo di slot e un set di valori di enumerazione, che sono i valori che uno slot di questo tipo può assumere. Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md).

Se specificate il nome di un tipo di slot esistente, i campi della richiesta sostituiscono i valori esistenti nella `$LATEST` versione del tipo di slot. Amazon Lex rimuove i campi che non fornisci nella richiesta. Se non specifichi i campi obbligatori, Amazon Lex genera un'eccezione. Quando aggiorni la `$LATEST` versione di un tipo di slot, se un bot utilizza la `$LATEST` versione di un intento che contiene il tipo di slot, il `status` campo del bot viene impostato su. `NOT_BUILT`

Questa operazione richiede le autorizzazioni per l'operazione `lex:PutSlotType`.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI
<a name="API_PutSlotType_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-uri-name"></a>
Il nome del tipo di slot. Il nome *non* fa distinzione tra maiuscole e minuscole.   
Il nome non può corrispondere al nome di un tipo di slot integrato o al nome di un tipo di slot integrato con «AMAZON». rimosso. Ad esempio, poiché esiste un tipo di slot integrato chiamato`AMAZON.DATE`, non è possibile creare un tipo di slot personalizzato chiamato`DATE`.  
Per un elenco dei tipi di slot integrati, consulta [Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) nell'*Alexa Skills Kit*.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutSlotType_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-checksum"></a>
Identifica una revisione specifica della versione. `$LATEST`  
Quando crei un nuovo tipo di slot, lascia il `checksum` campo vuoto. Se si specifica un checksum si ottiene un'`BadRequestException`eccezione.  
Quando desideri aggiornare un tipo di slot, imposta il `checksum` campo sul checksum della revisione più recente della versione. `$LATEST` Se non specifichi il ` checksum` campo o se il checksum non corrisponde alla `$LATEST` versione, ottieni un'eccezione. `PreconditionFailedException`  
▬Tipo: stringa  
Obbligatorio: no

 ** [createVersion](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-createVersion"></a>
Se impostato su `true` una nuova versione numerata dello slot, viene creato un tipo di slot. Equivale a chiamare l'`CreateSlotTypeVersion`operazione. Se non si specifica`createVersion`, l'impostazione predefinita è`false`.  
Tipo: Booleano  
Obbligatorio: no

 ** [description](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-description"></a>
Una descrizione del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Obbligatorio: no

 ** [enumerationValues](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-enumerationValues"></a>
Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere. Ogni valore può avere un elenco di `synonyms` valori aggiuntivi che aiutano ad addestrare il modello di apprendimento automatico sui valori che risolve per uno slot.   
Un tipo di slot per espressioni regolari non richiede valori di enumerazione. Tutti gli altri tipi di slot richiedono un elenco di valori di enumerazione.  
Quando Amazon Lex risolve un valore di slot, genera un elenco di risoluzione che contiene fino a cinque valori possibili per lo slot. Se si utilizza una funzione Lambda, questo elenco di risoluzioni viene passato alla funzione. Se non si utilizza una funzione Lambda, è possibile scegliere di restituire il valore immesso dall'utente o il primo valore nell'elenco delle risoluzioni come valore dello slot. Il `valueSelectionStrategy` campo indica l'opzione da utilizzare.   
Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 articoli.  
Obbligatorio: no

 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-parentSlotTypeSignature"></a>
Il tipo di slot integrato utilizzato come elemento principale del tipo di slot. Quando si definisce un tipo di slot principale, il nuovo tipo di slot presenta la stessa configurazione dello slot principale.  
Solo `AMAZON.AlphaNumeric`è supportata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obbligatorio: no

 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-slotTypeConfigurations"></a>
Informazioni di configurazione che estendono il tipo di slot integrato principale. La configurazione viene aggiunta alle impostazioni per il tipo di slot principale.  
Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Obbligatorio: no

 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-valueSelectionStrategy"></a>
Determina la strategia di risoluzione degli slot utilizzata da Amazon Lex per restituire i valori del tipo di slot. Il campo può essere impostato su uno dei seguenti valori:  
+  `ORIGINAL_VALUE`- Restituisce il valore inserito dall'utente, se il valore utente è simile al valore dello slot.
+  `TOP_RESOLUTION`- Se esiste un elenco di risoluzioni per lo slot, restituisce il primo valore nell'elenco delle risoluzioni come valore del tipo di slot. Se non è presente un elenco di risoluzioni, viene restituito null.
Se non si specifica il`valueSelectionStrategy`, l'impostazione predefinita è`ORIGINAL_VALUE`.  
Tipo: String  
Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION`   
Campo obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_PutSlotType_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-checksum"></a>
Checksum della `$LATEST` versione del tipo di slot.  
Tipo: String

 ** [createdDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createdDate"></a>
La data di creazione del tipo di slot.  
Tipo: Timestamp

 ** [createVersion](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createVersion"></a>
 `True`se è stata creata una nuova versione del tipo di slot. Se il `createVersion` campo non è stato specificato nella richiesta, il `createVersion` campo è impostato su false nella risposta.  
Tipo: Booleano

 ** [description](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-description"></a>
Una descrizione del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [enumerationValues](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-enumerationValues"></a>
Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere.  
Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 elementi.

 ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-lastUpdatedDate"></a>
La data in cui il tipo di slot è stato aggiornato. Quando si crea un tipo di slot, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp

 ** [name](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-name"></a>
Il nome del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-parentSlotTypeSignature"></a>
Il tipo di slot integrato utilizzato come elemento principale del tipo di slot.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-slotTypeConfigurations"></a>
Informazioni di configurazione che estendono il tipo di slot integrato principale.  
Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-valueSelectionStrategy"></a>
La strategia di risoluzione degli slot utilizzata da Amazon Lex per determinare il valore dello slot. Per ulteriori informazioni, consulta [PutSlotType](#API_PutSlotType).  
Tipo: String  
Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-version"></a>
La versione del tipo di slot. Per un nuovo tipo di slot, la versione è sempre`$LATEST`.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

## Errori
<a name="API_PutSlotType_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_PutSlotType_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType) 

# StartImport
<a name="API_StartImport"></a>

Avvia un'attività per importare una risorsa in Amazon Lex.

## Sintassi della richiesta
<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"
      }
   ]
}
```

## Parametri della richiesta URI:
<a name="API_StartImport_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartImport_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
Speciifica l'azione che l'`StartImport`operazione deve intraprendere quando esiste una risorsa con lo stesso nome.  
+ FAIL\$1ON\$1CONFLICT - L'operazione di importazione viene interrotta al primo conflitto tra una risorsa nel file di importazione e una risorsa esistente. Il nome della risorsa che causa il conflitto si trova nel `failureReason` campo della risposta all'operazione. `GetImport`

  OVERWRITE\$1LATEST - L'operazione di importazione procede anche in caso di conflitto con una risorsa esistente. La versione \$1LASTEST della risorsa esistente viene sovrascritta con i dati del file di importazione.
Tipo: String  
Valori validi: `OVERWRITE_LATEST | FAIL_ON_CONFLICT`   
Obbligatorio: sì

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
Un archivio zip in formato binario. L'archivio deve contenere un file, un file JSON contenente la risorsa da importare. La risorsa deve corrispondere al tipo specificato nel `resourceType` campo.  
Tipo: oggetto dati binari con codifica Base64  
Obbligatorio: sì

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
Speciifica il tipo di risorsa da esportare. Ogni risorsa esporta anche tutte le risorse da cui dipende.   
+ Un bot esporta intenti dipendenti.
+ Un intento esporta i tipi di slot dipendenti.
Tipo: String  
Valori validi: `BOT | INTENT | SLOT_TYPE`   
Obbligatorio: sì

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
Un elenco di tag da aggiungere al bot importato. Puoi aggiungere tag solo quando importi un bot, non puoi aggiungere tag a un intento o a un tipo di slot.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

## Sintassi della risposta
<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"
      }
   ]
}
```

## Elementi di risposta
<a name="API_StartImport_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
Un timestamp per la data e l'ora in cui è stato richiesto il processo di importazione.  
Tipo: Timestamp

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
L'identificatore per il processo di importazione specifico.  
Tipo: String

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
Lo stato del processo di importazione. Se lo stato è`FAILED`, è possibile ottenere il motivo dell'errore utilizzando l'`GetImport`operazione.  
Tipo: String  
Valori validi: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
L'azione da intraprendere in caso di conflitto di fusione.  
Tipo: String  
Valori validi: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
Il nome assegnato al processo di importazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
Il tipo di risorsa da importare.  
Tipo: String  
Valori validi: `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
Un elenco di tag aggiunti al bot importato.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

## Errori
<a name="API_StartImport_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_StartImport_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport) 

# StartMigration
<a name="API_StartMigration"></a>

Inizia la migrazione di un bot da Amazon Lex V1 ad Amazon Lex V2. Esegui la migrazione del bot quando desideri sfruttare le nuove funzionalità di Amazon Lex V2.

Per ulteriori informazioni, consulta [Migrazione di un bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) nella *guida per sviluppatori di Amazon Lex*.

## Sintassi della richiesta
<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"
}
```

## Parametri della richiesta URI:
<a name="API_StartMigration_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartMigration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
+  `CREATE_NEW`- Crea un nuovo bot Amazon Lex V2 e migra il bot Amazon Lex V1 al nuovo bot.
+  `UPDATE_EXISTING`- Sovrascrive i metadati del bot di Amazon Lex V2 esistenti e le impostazioni locali da migrare. Non modifica le altre impostazioni locali nel bot Amazon Lex V2. Se la localizzazione non esiste, viene creata una nuova locale nel bot Amazon Lex V2.
Tipo: String  
Valori validi: `CREATE_NEW | UPDATE_EXISTING`   
Obbligatorio: sì

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
La versione del bot per la migrazione ad Amazon Lex V2. Puoi migrare la `$LATEST` versione così come qualsiasi versione numerata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Obbligatorio: sì

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
Il nome del bot Amazon Lex V2 su cui stai migrando il bot Amazon Lex V1.   
+ Se il bot Amazon Lex V2 non esiste, devi utilizzare la strategia di `CREATE_NEW` migrazione.
+ Se il bot Amazon Lex V2 esiste, è necessario utilizzare la strategia di `UPDATE_EXISTING` migrazione per modificare i contenuti del bot Amazon Lex V2.
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([0-9a-zA-Z][_-]?)+$`   
Obbligatorio: sì

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obbligatorio: sì

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_StartMigration_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 202.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
L'identificatore univoco assegnato da Amazon Lex alla migrazione.  
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
Tipo: String  
Valori validi: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
La data e l'ora di inizio della migrazione.  
Tipo: Timestamp

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
Le impostazioni locali utilizzate per il bot Amazon Lex V1.   
Tipo: String  
Valori validi: `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>
Il nome del bot Amazon Lex V1 che stai migrando ad Amazon Lex V2.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
La versione del bot per la migrazione ad Amazon Lex V2.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
L'identificatore univoco per il bot Amazon Lex V2.   
Tipo: String  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Errori
<a name="API_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Il tuo utente o ruolo IAM non dispone dell'autorizzazione per chiamare l'Amazon Lex V2 APIs necessario per migrare il bot.  
Codice di stato HTTP: 403

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_StartMigration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration) 

# TagResource
<a name="API_TagResource"></a>

Aggiunge i tag specificati alla risorsa specificata. Se esiste già una chiave di tag, il valore esistente viene sostituito con il nuovo valore.

## Sintassi della richiesta
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Parametri della richiesta URI
<a name="API_TagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-uri-resourceArn"></a>
L'Amazon Resource Name (ARN) del bot, dell'alias del bot o del canale bot da taggare.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_TagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-tags"></a>
Un elenco di chiavi di tag da aggiungere alla risorsa. Se esiste già una chiave di tag, il valore esistente viene sostituito con il nuovo valore.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_TagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_TagResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Rimuove i tag da un bot, da un alias bot o da un canale bot.

## Sintassi della richiesta
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_UntagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-resourceArn"></a>
L'Amazon Resource Name (ARN) della risorsa da cui rimuovere i tag.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-tagKeys"></a>
Un elenco di chiavi di tag da rimuovere dalla risorsa. Se una chiave di tag non esiste sulla risorsa, viene ignorata.  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_UntagResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_UntagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

## Errori
<a name="API_UntagResource_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_UntagResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UntagResource) 

# Servizio Amazon Lex Runtime
<a name="API_Operations_Amazon_Lex_Runtime_Service"></a>

Le seguenti azioni sono supportate da Amazon Lex Runtime Service:
+  [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>

Rimuove le informazioni di sessione per un bot, alias e ID utente specificato. 

## Sintassi della richiesta
<a name="API_runtime_DeleteSession_RequestSyntax"></a>

```
DELETE /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_runtime_DeleteSession_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botAlias](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botAlias"></a>
L'alias in uso per il bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [botName](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botName"></a>
Il nome del bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [userId](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-userId"></a>
L'identificatore dell'utente associato ai dati della sessione.  
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_runtime_DeleteSession_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_runtime_DeleteSession_ResponseSyntax"></a>

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

{
   "botAlias": "string",
   "botName": "string",
   "sessionId": "string",
   "userId": "string"
}
```

## Elementi di risposta
<a name="API_runtime_DeleteSession_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [botAlias](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botAlias"></a>
L'alias in uso per il bot associato ai dati della sessione.  
Tipo: String

 ** [botName](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botName"></a>
Il nome del bot associato ai dati della sessione.  
Tipo: String

 ** [sessionId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-sessionId"></a>
L'identificatore univoco della sessione.  
Tipo: String

 ** [userId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-userId"></a>
L'ID dell'utente dell'applicazione client.  
Tipo: String  
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+` 

## Errori
<a name="API_runtime_DeleteSession_Errors"></a>

 ** BadRequestException **   
 La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto oppure la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.   
Codice di stato HTTP: 400

 ** ConflictException **   
 Due client utilizzano lo stesso account AWS, lo stesso bot Amazon Lex e lo stesso ID utente.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Errore interno del servizio. Riprova la chiamata.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_runtime_DeleteSession_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DeleteSession) 

# GetSession
<a name="API_runtime_GetSession"></a>

Restituisce le informazioni di sessione per un bot, alias e ID utente specificato.

## Sintassi della richiesta
<a name="API_runtime_GetSession_RequestSyntax"></a>

```
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_runtime_GetSession_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
L'alias in uso per il bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
Il nome del bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
Una stringa usata per filtrare gli intenti restituiti nella `recentIntentSummaryView` struttura.   
Quando si specifica un filtro, vengono restituiti solo gli intenti il cui `checkpointLabel` campo è impostato su quella stringa.  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
L'ID dell'utente dell'applicazione client. Amazon Lex lo utilizza per identificare la conversazione di un utente con il tuo bot.   
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_runtime_GetSession_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_runtime_GetSession_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
Un elenco di contesti attivi per la sessione. Un contesto può essere impostato quando un intento viene soddisfatto o chiamando l'operazione `PostContent``PostText`, o. `PutSession`  
È possibile utilizzare un contesto per controllare gli intenti che possono far seguito a un intento o per modificare il funzionamento dell'applicazione.  
Tipo: matrice di oggetti [ActiveContext](API_runtime_ActiveContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
Descrive lo stato attuale del bot.  
Tipo: oggetto [DialogAction](API_runtime_DialogAction.md)

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
Una serie di informazioni sugli intenti utilizzati nella sessione. L'array può contenere un massimo di tre riepiloghi. Se nella sessione vengono utilizzati più di tre intenti, l'`recentIntentSummaryView`operazione contiene informazioni sugli ultimi tre intenti utilizzati.  
Se impostate il `checkpointLabelFilter` parametro nella richiesta, l'array contiene solo gli intenti con l'etichetta specificata.  
Tipo: matrice di oggetti [IntentSummary](API_runtime_IntentSummary.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 3 elementi.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
Mappa di key/value coppie che rappresentano le informazioni di contesto specifiche della sessione. Contiene informazioni sull'applicazione trasferite tra Amazon Lex e un'applicazione client.  
Tipo: mappatura stringa a stringa

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
Un identificatore univoco per la sessione.  
Tipo: String

## Errori
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto o la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.   
Codice di stato HTTP: 400

 ** InternalFailureException **   
Errore interno del servizio. Riprova la chiamata.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_runtime_GetSession_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GetSession) 

# PostContent
<a name="API_runtime_PostContent"></a>

 Invia l'input dell'utente (testo o parlato) ad Amazon Lex. I client utilizzano questa API per inviare richieste di testo e audio ad Amazon Lex in fase di esecuzione. Amazon Lex interpreta l'input dell'utente utilizzando il modello di apprendimento automatico creato per il bot. 

L'`PostContent`operazione supporta l'ingresso audio a 8 kHz e 16 kHz. È possibile utilizzare l'audio a 8 kHz per ottenere una maggiore precisione di riconoscimento vocale nelle applicazioni audio telefoniche. 

 In risposta, Amazon Lex restituisce il messaggio successivo da trasmettere all'utente. Considera i seguenti messaggi di esempio: 
+  Per un input dell'utente «Vorrei una pizza», Amazon Lex potrebbe restituire una risposta con un messaggio che richiama i dati relativi allo slot (ad esempio,`PizzaSize`): «Che dimensione di pizza vorresti?». 
+  Dopo che l'utente ha fornito tutte le informazioni sull'ordine della pizza, Amazon Lex potrebbe restituire una risposta con un messaggio per ottenere la conferma dell'utente: «Ordina la pizza?». 
+  Dopo che l'utente ha risposto «Sì» alla richiesta di conferma, Amazon Lex potrebbe restituire una dichiarazione conclusiva: «Grazie, la tua pizza al formaggio è stata ordinata». 

 Non tutti i messaggi Amazon Lex richiedono una risposta da parte dell'utente. Ad esempio, le dichiarazioni conclusive non richiedono una risposta. Alcuni messaggi richiedono solo una risposta affermativa o negativa. Oltre a`message`, Amazon Lex fornisce un contesto aggiuntivo sul messaggio nella risposta che puoi utilizzare per migliorare il comportamento del client, ad esempio visualizzando l'interfaccia utente client appropriata. Considerare i seguenti esempi: 
+  Se il messaggio serve a richiamare dati sugli slot, Amazon Lex restituisce le seguenti informazioni di contesto: 
  +  `x-amz-lex-dialog-state`intestazione impostata su `ElicitSlot` 
  +  `x-amz-lex-intent-name`intestazione impostata sul nome dell'intento nel contesto corrente 
  +  `x-amz-lex-slot-to-elicit`intestazione impostata sul nome dello slot per il quale sta ottenendo informazioni `message` 
  +  `x-amz-lex-slots`header impostato su una mappa di slot configurati per l'intento con i loro valori correnti 
+  Se il messaggio è una richiesta di conferma, l'`x-amz-lex-dialog-state`intestazione viene impostata su `Confirmation` e l'`x-amz-lex-slot-to-elicit`intestazione viene omessa. 
+  Se il messaggio è una richiesta di chiarimenti configurata per l'intento e indica che l'intento dell'utente non è compreso, l'intestazione viene impostata su e l'`x-amz-dialog-state`intestazione viene omessa. `ElicitIntent` `x-amz-slot-to-elicit` 

 Inoltre, Amazon Lex restituisce anche prodotti specifici per l'applicazione`sessionAttributes`. Per ulteriori informazioni, consulta [Managing](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html) Conversation Context. 

## Sintassi della richiesta
<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
```

## Parametri della richiesta URI
<a name="API_runtime_PostContent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 Si passa questo valore come intestazione `Accept` HTTP.   
 Il messaggio che Amazon Lex restituisce nella risposta può essere di testo o vocale in base al valore dell'intestazione `Accept` HTTP nella richiesta.   
+  Se il valore è`text/plain; charset=utf-8`, Amazon Lex restituisce il testo nella risposta. 
+  Se il valore inizia con`audio/`, Amazon Lex restituisce la voce nella risposta. Amazon Lex utilizza Amazon Polly per generare il parlato (utilizzando la configurazione specificata nell'`Accept`intestazione). Ad esempio, se si specifica `audio/mpeg` come valore, Amazon Lex restituisce la voce in formato MPEG.
+ Se il valore è`audio/pcm`, la voce restituita è `audio/pcm` in formato little endian a 16 bit. 
+ I valori accettati sono i seguenti:
  + audio/mpeg
  + audio/ogg
  + audio/pcm
  + testo/semplice; set di caratteri = utf-8
  + audio/\$1 (il valore predefinito è mpeg)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
Un elenco di contesti attivi per la richiesta. Un contesto può essere attivato quando viene soddisfatto un intento precedente o includendo il contesto nella richiesta,  
Se non specifichi un elenco di contesti, Amazon Lex utilizzerà l'elenco corrente di contesti per la sessione. Se specifichi un elenco vuoto, tutti i contesti della sessione vengono cancellati.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
Alias del bot Amazon Lex.  
Obbligatorio: sì

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
Nome del bot Amazon Lex.  
Obbligatorio: sì

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 Passi questo valore come intestazione `Content-Type` HTTP.   
 Indica il formato audio o il testo. Il valore dell'intestazione deve iniziare con uno dei seguenti prefissi:   
+ Formato PCM, i dati audio devono essere in ordine di byte little-endian.
  + audio/l16; rate=16000; canali=1
  + audio/x-l16; frequenza di campionamento = 16000; numero di canali=1
  + audio/lpcm; frequenza di campionamento = 8000; =16; conteggio canali = 1; sample-size-bits =falso is-big-endian 
+ Formato Opus
  + audio/ x-cbr-opus-with -preamble; dimensione del preambolo=0; bit-rate=256000; =4 frame-size-milliseconds
+ Formato testo
  + testo/semplice; set di caratteri = utf-8
Obbligatorio: sì

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
Si passa questo valore come intestazione HTTP. `x-amz-lex-request-attributes`  
Informazioni specifiche sulla richiesta trasferite tra Amazon Lex e un'applicazione client. Il valore deve essere una mappa serializzata JSON e codificata in base64 con chiavi e valori di stringa. La dimensione totale delle `sessionAttributes` intestazioni `requestAttributes` and è limitata a 12 KB.  
Lo spazio dei nomi `x-amz-lex:` è riservato agli attributi speciali. Non creare alcun attributo di richiesta con il prefisso. `x-amz-lex:`  
Per ulteriori informazioni, vedere [Impostazione degli attributi della richiesta](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>
Questo valore viene passato come intestazione `x-amz-lex-session-attributes` HTTP.  
Informazioni specifiche dell'applicazione trasferite tra Amazon Lex e un'applicazione client. Il valore deve essere una mappa serializzata JSON e codificata in base64 con chiavi e valori di stringa. La dimensione totale delle `requestAttributes` intestazioni `sessionAttributes` and è limitata a 12 KB.  
Per ulteriori informazioni, vedere [Impostazione degli attributi di sessione](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>
L'ID dell'utente dell'applicazione client. Amazon Lex lo utilizza per identificare la conversazione di un utente con il tuo bot. In fase di esecuzione, ogni richiesta deve contenere il `userID` campo.  
Per decidere l'ID utente da utilizzare per la tua applicazione, considera i seguenti fattori.  
+ Il `userID` campo non deve contenere informazioni di identificazione personale dell'utente, ad esempio nome, numeri di identificazione personale o altre informazioni personali dell'utente finale.
+ Se desideri che un utente inizi una conversazione su un dispositivo e continui su un altro dispositivo, utilizza un identificatore specifico dell'utente.
+ Se desideri che lo stesso utente possa tenere due conversazioni indipendenti su due dispositivi diversi, scegli un identificatore specifico del dispositivo.
+ Un utente non può avere due conversazioni indipendenti con due versioni diverse dello stesso bot. Ad esempio, un utente non può conversare con le versioni PROD e BETA dello stesso bot. Se prevedi che un utente debba conversare con due versioni diverse, ad esempio durante il test, includi l'alias bot nell'ID utente per separare le due conversazioni.
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_runtime_PostContent_RequestBody"></a>

La richiesta accetta i seguenti dati binari.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 Input dell'utente in formato audio PCM o Opus o in formato di testo come descritto nell'intestazione HTTP. `Content-Type`   
Puoi trasmettere dati audio ad Amazon Lex oppure creare un buffer locale che acquisisca tutti i dati audio prima dell'invio. In generale, si ottengono prestazioni migliori se si effettuano lo streaming di dati audio anziché il buffering dei dati localmente.  
Obbligatorio: sì

## Sintassi della risposta
<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
```

## Elementi di risposta
<a name="API_runtime_PostContent_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

La risposta restituisce le seguenti intestazioni HTTP.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
Un elenco di contesti attivi per la sessione. Un contesto può essere impostato quando un intento viene soddisfatto o chiamando l'operazione `PostContent``PostText`, o. `PutSession`  
È possibile utilizzare un contesto per controllare gli intenti che possono far seguito a un intento o per modificare il funzionamento dell'applicazione.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
Da uno a quattro intenti alternativi che possono essere applicabili all'intento dell'utente.  
Ogni alternativa include un punteggio che indica quanto Amazon Lex sia sicuro che l'intento corrisponda a quello dell'utente. Le intenzioni sono ordinate in base al punteggio di confidenza.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
La versione del bot che ha risposto alla conversazione. Puoi utilizzare queste informazioni per determinare se una versione di un bot funziona meglio di un'altra versione.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
Tipo di contenuto come specificato nell'intestazione `Accept` HTTP della richiesta.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
Identifica lo stato corrente dell'interazione dell'utente. Amazon Lex restituisce uno dei seguenti valori come`dialogState`. Il client può opzionalmente utilizzare queste informazioni per personalizzare l'interfaccia utente.   
+  `ElicitIntent`- Amazon Lex vuole suscitare l'intento dell'utente. Considerare i seguenti esempi: 

   Ad esempio, un utente potrebbe esprimere un intento («Voglio ordinare una pizza»). Se Amazon Lex non è in grado di dedurre l'intento dell'utente da questo enunciato, restituirà questo stato di dialogo. 
+  `ConfirmIntent`- Amazon Lex prevede una risposta «sì» o «no». 

  Ad esempio, Amazon Lex richiede la conferma dell'utente prima di soddisfare un intento. Invece di una semplice risposta «sì» o «no», un utente potrebbe rispondere fornendo informazioni aggiuntive. Ad esempio, «sì, ma preparala come una pizza dalla crosta densa» o «no, voglio ordinare da bere». Amazon Lex può elaborare tali informazioni aggiuntive (in questi esempi, aggiornare lo slot del tipo di crosta o modificare l'intento da OrderPizza a OrderDrink). 
+  `ElicitSlot`- Amazon Lex prevede il valore di uno slot per l'intento attuale. 

   Ad esempio, supponiamo che nella risposta Amazon Lex invii questo messaggio: «Che dimensione di pizza vorresti?». Un utente potrebbe rispondere con il valore dello slot (ad esempio, «medio»). L'utente potrebbe anche fornire informazioni aggiuntive nella risposta (ad esempio, «pizza con crosta di medio spessore»). Amazon Lex può elaborare tali informazioni aggiuntive in modo appropriato. 
+  `Fulfilled`- Indica che la funzione Lambda ha raggiunto con successo l'intento. 
+  `ReadyForFulfillment`- Indica che il cliente deve soddisfare la richiesta. 
+  `Failed`- Indica che la conversazione con l'utente è fallita. 

   Ciò può accadere per vari motivi, tra cui il fatto che l'utente non fornisce una risposta appropriata alle richieste del servizio (puoi configurare quante volte Amazon Lex può richiedere a un utente informazioni specifiche) o se la funzione Lambda non riesce a soddisfare l'intento. 
Valori validi: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
Il testo utilizzato per elaborare la richiesta.  
In caso di input di flusso audio, il campo `encodedInputTranscript` contiene il testo estratto dal flusso audio. Questo è il testo che viene effettivamente elaborato per riconoscere gli intenti e i valori dello slot. Puoi utilizzare queste informazioni per determinare se Amazon Lex sta elaborando correttamente l'audio che invii.  
Il `encodedInputTranscript` campo è codificato in base 64. È necessario decodificare il campo prima di poter utilizzare il valore.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
Il messaggio da trasmettere all'utente. Il messaggio può provenire dalla configurazione del bot o da una funzione Lambda.  
Se l'intento non è configurato con una funzione Lambda o se la funzione Lambda viene `Delegate` restituita come tale `dialogAction.type` nella sua risposta, Amazon Lex decide la linea d'azione successiva e seleziona un messaggio appropriato dalla configurazione del bot in base al contesto di interazione corrente. Ad esempio, se Amazon Lex non è in grado di comprendere l'input dell'utente, utilizza un messaggio di richiesta di chiarimento.  
Quando crei un intento, puoi assegnare messaggi ai gruppi. Quando i messaggi vengono assegnati a gruppi, Amazon Lex restituisce un messaggio per ogni gruppo nella risposta. Il campo del messaggio è una stringa JSON in escape contenente i messaggi. Per ulteriori informazioni sulla struttura della stringa JSON restituita, consulta. [Formati di messaggio supportati](howitworks-manage-prompts.md#msg-prompts-formats)  
Se la funzione Lambda restituisce un messaggio, Amazon Lex lo trasmette al client nella sua risposta.  
Il `encodedMessage` campo è codificato in base 64. È necessario decodificare il campo prima di poter utilizzare il valore.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1366.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *Questa intestazione è obsoleta.*   
Il testo utilizzato per elaborare la richiesta.  
Puoi utilizzare questo campo solo nelle versioni locali de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. `inputTranscript`In tutte le altre lingue, il campo è nullo. Dovresti invece usare il `encodedInputTranscript` campo.  
In caso di input di flusso audio, il campo `inputTranscript` contiene il testo estratto dal flusso audio. Questo è il testo che viene effettivamente elaborato per riconoscere gli intenti e i valori dello slot. Puoi utilizzare queste informazioni per determinare se Amazon Lex sta elaborando correttamente l'audio che invii.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
L'attuale intenzione dell'utente di cui Amazon Lex è a conoscenza.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *Questa intestazione è obsoleta.*   
Puoi utilizzare questo campo solo nelle versioni locali de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. `message`In tutte le altre lingue, il campo è nullo. Dovresti invece usare il `encodedMessage` campo.  
Il messaggio da trasmettere all'utente. Il messaggio può provenire dalla configurazione del bot o da una funzione Lambda.  
Se l'intento non è configurato con una funzione Lambda o se la funzione Lambda viene `Delegate` restituita come tale `dialogAction.type` nella sua risposta, Amazon Lex decide la linea d'azione successiva e seleziona un messaggio appropriato dalla configurazione del bot in base al contesto di interazione corrente. Ad esempio, se Amazon Lex non è in grado di comprendere l'input dell'utente, utilizza un messaggio di richiesta di chiarimento.  
Quando crei un intento, puoi assegnare messaggi ai gruppi. Quando i messaggi vengono assegnati a gruppi, Amazon Lex restituisce un messaggio per ogni gruppo nella risposta. Il campo del messaggio è una stringa JSON in escape contenente i messaggi. Per ulteriori informazioni sulla struttura della stringa JSON restituita, consulta. [Formati di messaggio supportati](howitworks-manage-prompts.md#msg-prompts-formats)  
Se la funzione Lambda restituisce un messaggio, Amazon Lex lo trasmette al client nella sua risposta.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
Il formato del messaggio di risposta. Uno dei seguenti valori:  
+  `PlainText`- Il messaggio contiene testo UTF-8 semplice.
+  `CustomPayload`- Il messaggio è un formato personalizzato per il cliente.
+  `SSML`- Il messaggio contiene testo formattato per l'output vocale.
+  `Composite`- Il messaggio contiene un oggetto JSON in escape contenente uno o più messaggi provenienti dai gruppi a cui sono stati assegnati i messaggi al momento della creazione dell'intento.
Valori validi: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Fornisce un punteggio che indica quanto Amazon Lex sia sicuro che l'intento restituito corrisponda all'intento dell'utente. Il punteggio è compreso tra 0,0 e 1,0.  
Il punteggio è un punteggio relativo, non assoluto. Il punteggio può cambiare in base ai miglioramenti apportati ad Amazon Lex. 

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
Il sentimento espresso in un enunciato.  
Quando il bot è configurato per inviare enunciati ad Amazon Comprehend per l'analisi del sentiment, questo campo contiene il risultato dell'analisi.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 Mappa di key/value coppie che rappresentano le informazioni di contesto specifiche della sessione. 

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
L'identificatore univoco della sessione.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Mappa di zero o più slot di intenti (coppie nome/valore) che Amazon Lex ha rilevato dall'input dell'utente durante la conversazione. Il campo è codificato in base 64.  
Amazon Lex crea un elenco di risoluzioni contenente i valori probabili per uno slot. Il valore restituito è determinato dal valore `valueSelectionStrategy` selezionato al momento della creazione o dell'aggiornamento del tipo di slot. Se `valueSelectionStrategy` è impostato su`ORIGINAL_VALUE`, viene restituito il valore fornito dall'utente, se il valore utente è simile ai valori dello slot. Se `valueSelectionStrategy` è impostato `TOP_RESOLUTION` su Amazon Lex restituisce il primo valore nell'elenco delle risoluzioni o, se non esiste un elenco di risoluzioni, null. Se non specifichi a`valueSelectionStrategy`, l'impostazione predefinita è`ORIGINAL_VALUE`.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 Se il `dialogState` valore è`ElicitSlot`, restituisce il nome dello slot per il quale Amazon Lex sta ottenendo un valore. 

La risposta restituisce quanto segue come corpo HTTP.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
Il prompt (o l'istruzione) da trasmettere all'utente. Questo si basa sulla configurazione e sul contesto del bot. Ad esempio, se Amazon Lex non comprende l'intento dell'utente, invia il file `clarificationPrompt` configurato per il bot. Se l'intento richiede una conferma prima di intraprendere l'azione di adempimento, invia il. `confirmationPrompt` Un altro esempio: supponiamo che la funzione Lambda abbia soddisfatto con successo l'intento e abbia inviato un messaggio da trasmettere all'utente. Quindi Amazon Lex invia quel messaggio nella risposta. 

## Errori
<a name="API_runtime_PostContent_Errors"></a>

 ** BadGatewayException **   
Il bot Amazon Lex è ancora in fase di creazione oppure uno dei servizi dipendenti (Amazon Polly, AWS Lambda) non è riuscito a causa di un errore interno del servizio.  
Codice di stato HTTP: 502

 ** BadRequestException **   
 La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto oppure la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.   
Codice di stato HTTP: 400

 ** ConflictException **   
 Due client utilizzano lo stesso account AWS, lo stesso bot Amazon Lex e lo stesso ID utente.   
Codice di stato HTTP: 409

 ** DependencyFailedException **   
 Una delle dipendenze, come AWS Lambda o Amazon Polly, generava un'eccezione. Ad esempio,   
+ Se Amazon Lex non dispone di autorizzazioni sufficienti per chiamare una funzione Lambda.
+ Se l'esecuzione di una funzione Lambda richiede più di 30 secondi.
+ Se una funzione Lambda di adempimento restituisce un'azione di `Delegate` dialogo senza rimuovere alcun valore dello slot.
Codice di stato HTTP: 424

 ** InternalFailureException **   
Errore interno del servizio. Riprova la chiamata.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 429

 ** LoopDetectedException **   
Questa eccezione non viene utilizzata.  
Codice di stato HTTP: 508

 ** NotAcceptableException **   
L'intestazione accept nella richiesta non ha un valore valido.  
Codice di stato HTTP: 406

 ** NotFoundException **   
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.  
Codice di stato HTTP: 404

 ** RequestTimeoutException **   
Il discorso di input è troppo lungo.  
Codice di stato HTTP: 408

 ** UnsupportedMediaTypeException **   
L'intestazione Content-Type (`PostContent`API) ha un valore non valido.   
Codice di stato HTTP: 415

## Esempi
<a name="API_runtime_PostContent_Examples"></a>

### Esempio 1
<a name="API_runtime_PostContent_Example_1"></a>

 In questa richiesta, l'URI identifica un bot (Traffic), una versione del bot (\$1LATEST) e un nome utente finale (someuser). L'`Content-Type`intestazione identifica il formato dell'audio nel corpo. Amazon Lex supporta anche altri formati. Per convertire l'audio da un formato all'altro, se necessario, puoi utilizzare il software open source SoX. È possibile specificare il formato in cui si desidera ottenere la risposta aggiungendo l'intestazione `Accept` HTTP. 

 Nella risposta, l'`x-amz-lex-message`intestazione mostra la risposta restituita da Amazon Lex. Il client può quindi inviare questa risposta all'utente. Lo stesso messaggio viene inviato in audio/MPEG formato tramite codifica a blocchi (come richiesto). 

#### Richiesta di esempio
<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]"
…
```

#### Risposta di esempio
<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
…
```

## Vedi anche
<a name="API_runtime_PostContent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 

# PostText
<a name="API_runtime_PostText"></a>

Invia l'input dell'utente ad Amazon Lex. Le applicazioni client possono utilizzare questa API per inviare richieste ad Amazon Lex in fase di esecuzione. Amazon Lex interpreta quindi l'input dell'utente utilizzando il modello di apprendimento automatico creato per il bot. 

 In risposta, Amazon Lex restituisce il successivo `message` per comunicare all'utente un'opzione `responseCard` da visualizzare. Considera i seguenti messaggi di esempio: 
+  Per un input dell'utente «Vorrei una pizza», Amazon Lex potrebbe restituire una risposta con un messaggio che richiama i dati relativi allo slot (ad esempio, PizzaSize): «Che dimensione di pizza vorresti?» 
+  Dopo che l'utente ha fornito tutte le informazioni sull'ordine della pizza, Amazon Lex potrebbe restituire una risposta con un messaggio per ottenere la conferma dell'utente «Procedere con l'ordine della pizza?». 
+  Dopo che l'utente ha risposto a una richiesta di conferma con un «sì», Amazon Lex potrebbe restituire una dichiarazione conclusiva: «Grazie, la tua pizza al formaggio è stata ordinata». 

 Non tutti i messaggi Amazon Lex richiedono una risposta da parte dell'utente. Ad esempio, una dichiarazione conclusiva non richiede una risposta. Alcuni messaggi richiedono solo una risposta utente «sì» o «no». Oltre a`message`, Amazon Lex fornisce un contesto aggiuntivo sul messaggio nella risposta che è possibile utilizzare per migliorare il comportamento del client, ad esempio per visualizzare l'interfaccia utente client appropriata. Questi sono i `slots` campi `slotToElicit` `dialogState``intentName`,, e della risposta. Considerare i seguenti esempi: 
+ Se il messaggio serve a richiamare dati sugli slot, Amazon Lex restituisce le seguenti informazioni di contesto:
  +  `dialogState`impostato su ElicitSlot 
  +  `intentName`impostato sul nome dell'intento nel contesto corrente 
  +  `slotToElicit`impostato sul nome dello slot per il quale `message` sta ottenendo informazioni 
  +  `slots`impostato su una mappa di slot, configurata per l'intento, con valori attualmente noti 
+  Se il messaggio è una richiesta di conferma, `dialogState` è impostato su ConfirmIntent e impostato su `SlotToElicit` null. 
+ Se il messaggio è una richiesta di chiarimenti (configurata per l'intento) che indica che l'intento dell'utente non è compreso, viene impostato su e impostato su `dialogState` null. ElicitIntent `slotToElicit` 

 Inoltre, Amazon Lex restituisce anche prodotti specifici per l'applicazione`sessionAttributes`. Per ulteriori informazioni, consulta [Managing](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html) Conversation Context. 

## Sintassi della richiesta
<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" 
   }
}
```

## Parametri della richiesta URI
<a name="API_runtime_PostText_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [botAlias](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botAlias"></a>
L'alias del bot Amazon Lex.  
Obbligatorio: sì

 ** [botName](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botName"></a>
Il nome del bot Amazon Lex.  
Obbligatorio: sì

 ** [userId](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-userId"></a>
L'ID dell'utente dell'applicazione client. Amazon Lex lo utilizza per identificare la conversazione di un utente con il tuo bot. In fase di esecuzione, ogni richiesta deve contenere il `userID` campo.  
Per decidere l'ID utente da utilizzare per l'applicazione, considera i seguenti fattori.  
+ Il `userID` campo non deve contenere informazioni di identificazione personale dell'utente, ad esempio nome, numeri di identificazione personale o altre informazioni personali dell'utente finale.
+ Se desideri che un utente inizi una conversazione su un dispositivo e continui su un altro dispositivo, utilizza un identificatore specifico dell'utente.
+ Se desideri che lo stesso utente possa tenere due conversazioni indipendenti su due dispositivi diversi, scegli un identificatore specifico del dispositivo.
+ Un utente non può avere due conversazioni indipendenti con due versioni diverse dello stesso bot. Ad esempio, un utente non può conversare con le versioni PROD e BETA dello stesso bot. Se prevedi che un utente debba conversare con due versioni diverse, ad esempio durante il test, includi l'alias bot nell'ID utente per separare le due conversazioni.
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_runtime_PostText_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [activeContexts](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-activeContexts"></a>
Un elenco di contesti attivi per la richiesta. Un contesto può essere attivato quando viene soddisfatto un intento precedente o includendo il contesto nella richiesta,  
Se non specifichi un elenco di contesti, Amazon Lex utilizzerà l'elenco corrente di contesti per la sessione. Se specifichi un elenco vuoto, tutti i contesti della sessione vengono cancellati.  
Tipo: matrice di oggetti [ActiveContext](API_runtime_ActiveContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.  
Obbligatorio: no

 ** [inputText](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-inputText"></a>
Il testo inserito dall'utente (Amazon Lex interpreta questo testo).  
Quando utilizzi l'AWS CLI, non puoi passare un URL nel `--input-text` parametro. Passa invece l'URL utilizzando il `--cli-input-json` parametro.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Obbligatorio: sì

 ** [requestAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-requestAttributes"></a>
Informazioni specifiche sulla richiesta trasferite tra Amazon Lex e un'applicazione client.  
Lo spazio dei nomi `x-amz-lex:` è riservato agli attributi speciali. Non creare alcun attributo di richiesta con il prefisso. `x-amz-lex:`  
Per ulteriori informazioni, vedere [Impostazione degli attributi della richiesta](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-sessionAttributes"></a>
Informazioni specifiche dell'applicazione trasferite tra Amazon Lex e un'applicazione client.  
Per ulteriori informazioni, consulta [Impostazione](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs) degli attributi di sessione.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_runtime_PostText_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [activeContexts](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-activeContexts"></a>
Un elenco di contesti attivi per la sessione. Un contesto può essere impostato quando un intento viene soddisfatto o chiamando l'operazione `PostContent``PostText`, o. `PutSession`  
È possibile utilizzare un contesto per controllare gli intenti che possono far seguito a un intento o per modificare il funzionamento dell'applicazione.  
Tipo: matrice di oggetti [ActiveContext](API_runtime_ActiveContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.

 ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-alternativeIntents"></a>
Da uno a quattro intenti alternativi che possono essere applicabili all'intento dell'utente.  
Ogni alternativa include un punteggio che indica quanto Amazon Lex sia sicuro che l'intento corrisponda a quello dell'utente. Le intenzioni sono ordinate in base al punteggio di confidenza.  
Tipo: matrice di oggetti [PredictedIntent](API_runtime_PredictedIntent.md)  
Membri della matrice: numero massimo di 4 elementi.

 ** [botVersion](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-botVersion"></a>
La versione del bot che ha risposto alla conversazione. Puoi utilizzare queste informazioni per determinare se una versione di un bot funziona meglio di un'altra versione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[0-9]+|\$LATEST` 

 ** [dialogState](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-dialogState"></a>
 Identifica lo stato attuale dell'interazione dell'utente. Amazon Lex restituisce uno dei seguenti valori come`dialogState`. Il client può opzionalmente utilizzare queste informazioni per personalizzare l'interfaccia utente.   
+  `ElicitIntent`- Amazon Lex vuole suscitare l'intenzione dell'utente. 

  Ad esempio, un utente potrebbe esprimere un intento («Voglio ordinare una pizza»). Se Amazon Lex non è in grado di dedurre l'intento dell'utente da questo enunciato, restituirà questo DialogState.
+  `ConfirmIntent`- Amazon Lex prevede una risposta «sì» o «no». 

   Ad esempio, Amazon Lex richiede la conferma dell'utente prima di soddisfare un intento. 

  Invece di un semplice «sì» o «no», un utente potrebbe rispondere fornendo informazioni aggiuntive. Ad esempio, «sì, ma preparala una pizza dalla crosta densa» o «no, voglio ordinare da bere». Amazon Lex può elaborare tali informazioni aggiuntive (in questi esempi, aggiornare il valore dello slot del tipo di crosta o modificare l'intento da OrderPizza a OrderDrink).
+  `ElicitSlot`- Amazon Lex prevede un valore di slot per l'intento attuale. 

  Ad esempio, supponiamo che nella risposta Amazon Lex invii questo messaggio: «Che dimensione di pizza vorresti?». Un utente potrebbe rispondere con il valore dello slot (ad esempio, «medio»). L'utente potrebbe anche fornire informazioni aggiuntive nella risposta (ad esempio, «pizza con crosta di medio spessore»). Amazon Lex è in grado di elaborare tali informazioni aggiuntive in modo appropriato. 
+  `Fulfilled`- Indica che la funzione Lambda configurata per l'intento ha soddisfatto con successo l'intento. 
+  `ReadyForFulfillment`- Indica che il cliente deve soddisfare l'intento. 
+  `Failed`- Indica che la conversazione con l'utente è fallita. 

   Ciò può accadere per vari motivi, tra cui il fatto che l'utente non ha fornito una risposta appropriata alle richieste del servizio (puoi configurare quante volte Amazon Lex può richiedere a un utente informazioni specifiche) o la funzione Lambda non è riuscita a soddisfare l'intento. 
Tipo: String  
Valori validi: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [intentName](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-intentName"></a>
L'attuale intenzione dell'utente di cui Amazon Lex è a conoscenza.  
Tipo: String

 ** [message](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-message"></a>
Il messaggio da trasmettere all'utente. Il messaggio può provenire dalla configurazione del bot o da una funzione Lambda.  
Se l'intento non è configurato con una funzione Lambda o se la funzione Lambda viene `Delegate` restituita come `dialogAction.type` risposta, Amazon Lex decide la linea d'azione successiva e seleziona un messaggio appropriato dalla configurazione del bot in base al contesto di interazione corrente. Ad esempio, se Amazon Lex non è in grado di comprendere l'input dell'utente, utilizza un messaggio di richiesta di chiarimento.  
Quando crei un intento, puoi assegnare messaggi ai gruppi. Quando i messaggi vengono assegnati a gruppi, Amazon Lex restituisce un messaggio per ogni gruppo nella risposta. Il campo del messaggio è una stringa JSON in escape contenente i messaggi. Per ulteriori informazioni sulla struttura della stringa JSON restituita, vedere. [Formati di messaggio supportati](howitworks-manage-prompts.md#msg-prompts-formats)  
Se la funzione Lambda restituisce un messaggio, Amazon Lex lo trasmette al client nella sua risposta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

 ** [messageFormat](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-messageFormat"></a>
Il formato del messaggio di risposta. Uno dei seguenti valori:  
+  `PlainText`- Il messaggio contiene testo UTF-8 semplice.
+  `CustomPayload`- Il messaggio è un formato personalizzato definito dalla funzione Lambda.
+  `SSML`- Il messaggio contiene testo formattato per l'output vocale.
+  `Composite`- Il messaggio contiene un oggetto JSON in escape contenente uno o più messaggi provenienti dai gruppi a cui sono stati assegnati i messaggi al momento della creazione dell'intento.
Tipo: String  
Valori validi: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-nluIntentConfidence"></a>
Fornisce un punteggio che indica quanto Amazon Lex sia sicuro che l'intento restituito corrisponda all'intento dell'utente. Il punteggio è compreso tra 0,0 e 1,0. Per ulteriori informazioni, vedere [Confidence Scores.](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html)  
Il punteggio è un punteggio relativo, non assoluto. Il punteggio può cambiare in base ai miglioramenti apportati ad Amazon Lex.  
Tipo: oggetto [IntentConfidence](API_runtime_IntentConfidence.md)

 ** [responseCard](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-responseCard"></a>
Rappresenta le opzioni a disposizione dell'utente per rispondere alla richiesta corrente. La Response Card può provenire dalla configurazione del bot (nella console Amazon Lex, scegli il pulsante delle impostazioni accanto a uno slot) o da un code hook (funzione Lambda).   
Tipo: oggetto [ResponseCard](API_runtime_ResponseCard.md)

 ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sentimentResponse"></a>
Il sentimento espresso in ed enunciato.  
Quando il bot è configurato per inviare enunciati ad Amazon Comprehend per l'analisi del sentiment, questo campo contiene il risultato dell'analisi.  
Tipo: oggetto [SentimentResponse](API_runtime_SentimentResponse.md)

 ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionAttributes"></a>
Una mappa di coppie chiave-valore che rappresentano le informazioni di contesto specifiche della sessione.  
Tipo: mappatura stringa a stringa

 ** [sessionId](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionId"></a>
Un identificatore univoco per la sessione.  
Tipo: String

 ** [slots](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slots"></a>
 Gli slot di intenti rilevati da Amazon Lex in base all'input dell'utente nella conversazione.   
Amazon Lex crea un elenco di risoluzioni contenente i valori probabili per uno slot. Il valore restituito è determinato dal valore `valueSelectionStrategy` selezionato al momento della creazione o dell'aggiornamento del tipo di slot. Se `valueSelectionStrategy` è impostato su`ORIGINAL_VALUE`, viene restituito il valore fornito dall'utente, se il valore utente è simile ai valori dello slot. Se `valueSelectionStrategy` è impostato `TOP_RESOLUTION` su Amazon Lex restituisce il primo valore nell'elenco delle risoluzioni o, se non esiste un elenco di risoluzioni, null. Se non specifichi a`valueSelectionStrategy`, l'impostazione predefinita è`ORIGINAL_VALUE`.  
Tipo: mappatura stringa a stringa

 ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slotToElicit"></a>
Se il `dialogState` valore è`ElicitSlot`, restituisce il nome dello slot per il quale Amazon Lex sta ottenendo un valore.   
Tipo: String

## Errori
<a name="API_runtime_PostText_Errors"></a>

 ** BadGatewayException **   
Il bot Amazon Lex è ancora in fase di creazione oppure uno dei servizi dipendenti (Amazon Polly, AWS Lambda) non è riuscito a causa di un errore interno del servizio.  
Codice di stato HTTP: 502

 ** BadRequestException **   
 La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto oppure la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.   
Codice di stato HTTP: 400

 ** ConflictException **   
 Due client utilizzano lo stesso account AWS, lo stesso bot Amazon Lex e lo stesso ID utente.   
Codice di stato HTTP: 409

 ** DependencyFailedException **   
 Una delle dipendenze, come AWS Lambda o Amazon Polly, generava un'eccezione. Ad esempio,   
+ Se Amazon Lex non dispone di autorizzazioni sufficienti per chiamare una funzione Lambda.
+ Se l'esecuzione di una funzione Lambda richiede più di 30 secondi.
+ Se una funzione Lambda di adempimento restituisce un'azione di `Delegate` dialogo senza rimuovere alcun valore dello slot.
Codice di stato HTTP: 424

 ** InternalFailureException **   
Errore interno del servizio. Riprova la chiamata.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 429

 ** LoopDetectedException **   
Questa eccezione non viene utilizzata.  
Codice di stato HTTP: 508

 ** NotFoundException **   
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_runtime_PostText_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText) 

# PutSession
<a name="API_runtime_PutSession"></a>

Crea una nuova sessione o modifica una sessione esistente con un bot Amazon Lex. Utilizzate questa operazione per consentire all'applicazione di impostare lo stato del bot.

Per ulteriori informazioni, consulta [Gestione delle sessioni](https://docs.aws.amazon.com/lex/latest/dg/how-session-api.html).

## Sintassi della richiesta
<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" 
   }
}
```

## Parametri della richiesta URI
<a name="API_runtime_PutSession_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [accept](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-accept"></a>
Il messaggio che Amazon Lex restituisce nella risposta può essere testuale o vocale a seconda del valore di questo campo.  
+ Se il valore è`text/plain; charset=utf-8`, Amazon Lex restituisce il testo nella risposta.
+ Se il valore inizia con`audio/`, Amazon Lex restituisce la voce nella risposta. Amazon Lex utilizza Amazon Polly per generare il parlato nella configurazione specificata. Ad esempio, se si specifica `audio/mpeg` come valore, Amazon Lex restituisce la voce in formato MPEG.
+ Se il valore è`audio/pcm`, la voce viene restituita `audio/pcm` nel formato little endian a 16 bit.
+ I valori accettati sono i seguenti:
  +  `audio/mpeg` 
  +  `audio/ogg` 
  +  `audio/pcm` 
  +  `audio/*`(il valore predefinito è mpeg)
  +  `text/plain; charset=utf-8` 

 ** [botAlias](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botAlias"></a>
L'alias in uso per il bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [botName](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botName"></a>
Il nome del bot che contiene i dati della sessione.  
Obbligatorio: sì

 ** [userId](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-userId"></a>
L'ID dell'utente dell'applicazione client. Amazon Lex lo utilizza per identificare la conversazione di un utente con il tuo bot.   
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.  
Modello: `[0-9a-zA-Z._:-]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_runtime_PutSession_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [activeContexts](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-activeContexts"></a>
Un elenco di contesti attivi per la richiesta. Un contesto può essere attivato quando viene soddisfatto un intento precedente o includendo il contesto nella richiesta,  
Se non specifichi un elenco di contesti, Amazon Lex utilizzerà l'elenco corrente di contesti per la sessione. Se specifichi un elenco vuoto, tutti i contesti della sessione vengono cancellati.  
Tipo: matrice di oggetti [ActiveContext](API_runtime_ActiveContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.  
Obbligatorio: no

 ** [dialogAction](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-dialogAction"></a>
Imposta l'azione successiva che il bot deve intraprendere per completare la conversazione.  
Tipo: oggetto [DialogAction](API_runtime_DialogAction.md)  
Obbligatorio: no

 ** [recentIntentSummaryView](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-recentIntentSummaryView"></a>
Un riepilogo delle intenzioni recenti del bot. È possibile utilizzare la visualizzazione di riepilogo degli intenti per impostare un'etichetta di checkpoint su un intento e modificare gli attributi degli intenti. Puoi anche usarla per rimuovere o aggiungere oggetti di riepilogo degli intenti all'elenco.  
Un intento che modifichi o aggiungi all'elenco deve avere senso per il bot. Ad esempio, il nome dell'intento deve essere valido per il bot. È necessario fornire valori validi per:  
+  `intentName` 
+ nomi di slot
+  `slotToElict` 
Se si invia il `recentIntentSummaryView` parametro in una `PutSession` richiesta, il contenuto della nuova visualizzazione di riepilogo sostituisce la vecchia visualizzazione di riepilogo. Ad esempio, se una `GetSession` richiesta restituisce tre intenti nella visualizzazione di riepilogo e si chiama `PutSession` con un intento nella visualizzazione di riepilogo, la chiamata successiva `GetSession` restituirà solo un intento.  
Tipo: matrice di oggetti [IntentSummary](API_runtime_IntentSummary.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 3 elementi.  
Obbligatorio: no

 ** [sessionAttributes](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-sessionAttributes"></a>
Mappa di key/value coppie che rappresentano le informazioni di contesto specifiche della sessione. Contiene informazioni sull'applicazione trasferite tra Amazon Lex e un'applicazione client.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

## Sintassi della risposta
<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
```

## Elementi di risposta
<a name="API_runtime_PutSession_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

La risposta restituisce le seguenti intestazioni HTTP.

 ** [activeContexts](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-activeContexts"></a>
Un elenco di contesti attivi per la sessione.

 ** [contentType](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-contentType"></a>
Tipo di contenuto specificato nell'intestazione `Accept` HTTP della richiesta.

 ** [dialogState](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-dialogState"></a>
  
+  `ConfirmIntent`- Amazon Lex si aspetta una risposta «sì» o «no» per confermare l'intento prima di realizzarlo.
+  `ElicitIntent`- Amazon Lex vuole suscitare l'intento dell'utente.
+  `ElicitSlot`- Amazon Lex prevede il valore di uno slot per l'intento attuale.
+  `Failed`- Indica che la conversazione con l'utente è fallita. Ciò può accadere per vari motivi, tra cui l'utente non fornisce una risposta appropriata alle richieste del servizio o se la funzione Lambda non riesce a soddisfare l'intento.
+  `Fulfilled`- Indica che la funzione Lambda ha raggiunto con successo l'intento.
+  `ReadyForFulfillment`- Indica che il cliente deve soddisfare l'intento.
Valori validi: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedMessage](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-encodedMessage"></a>
Il messaggio successivo che deve essere presentato all'utente.  
Il `encodedMessage` campo è codificato in base 64. È necessario decodificare il campo prima di poter utilizzare il valore.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1366.

 ** [intentName](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-intentName"></a>
Il nome dell'intento corrente.

 ** [message](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-message"></a>
 *Questa intestazione è obsoleta.*   
Il messaggio successivo che dovrebbe essere presentato all'utente.  
È possibile utilizzare questo campo solo nelle versioni locali de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. `message`In tutte le altre lingue, il campo è nullo. Dovresti invece usare il `encodedMessage` campo.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

 ** [messageFormat](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-messageFormat"></a>
Il formato del messaggio di risposta. Uno dei seguenti valori:  
+  `PlainText`- Il messaggio contiene testo UTF-8 semplice.
+  `CustomPayload`- Il messaggio è un formato personalizzato per il cliente.
+  `SSML`- Il messaggio contiene testo formattato per l'output vocale.
+  `Composite`- Il messaggio contiene un oggetto JSON in escape contenente uno o più messaggi provenienti dai gruppi a cui sono stati assegnati i messaggi al momento della creazione dell'intento.
Valori validi: `PlainText | CustomPayload | SSML | Composite` 

 ** [sessionAttributes](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionAttributes"></a>
Mappa di key/value coppie che rappresentano informazioni di contesto specifiche della sessione.

 ** [sessionId](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionId"></a>
Un identificatore univoco per la sessione.

 ** [slots](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slots"></a>
Mappa degli slot con zero o più intenti rilevati da Amazon Lex in base all'input dell'utente durante la conversazione.  
Amazon Lex crea un elenco di risoluzioni contenente i valori probabili per uno slot. Il valore restituito è determinato dal valore `valueSelectionStrategy` selezionato al momento della creazione o dell'aggiornamento del tipo di slot. Se `valueSelectionStrategy` è impostato su`ORIGINAL_VALUE`, viene restituito il valore fornito dall'utente, se il valore utente è simile ai valori dello slot. Se `valueSelectionStrategy` è impostato `TOP_RESOLUTION` su Amazon Lex restituisce il primo valore nell'elenco delle risoluzioni o, se non esiste un elenco di risoluzioni, null. Se non specifichi a, `valueSelectionStrategy` l'impostazione predefinita è`ORIGINAL_VALUE`. 

 ** [slotToElicit](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slotToElicit"></a>
Se `dialogState` è`ElicitSlot`, restituisce il nome dello slot per il quale Amazon Lex sta ottenendo un valore.

La risposta restituisce quanto segue come corpo HTTP.

 ** [audioStream](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-audioStream"></a>
La versione audio del messaggio da trasmettere all'utente.

## Errori
<a name="API_runtime_PutSession_Errors"></a>

 ** BadGatewayException **   
Il bot Amazon Lex è ancora in fase di creazione oppure uno dei servizi dipendenti (Amazon Polly, AWS Lambda) non è riuscito a causa di un errore interno del servizio.  
Codice di stato HTTP: 502

 ** BadRequestException **   
 La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto oppure la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.   
Codice di stato HTTP: 400

 ** ConflictException **   
 Due client utilizzano lo stesso account AWS, lo stesso bot Amazon Lex e lo stesso ID utente.   
Codice di stato HTTP: 409

 ** DependencyFailedException **   
 Una delle dipendenze, come AWS Lambda o Amazon Polly, generava un'eccezione. Ad esempio,   
+ Se Amazon Lex non dispone di autorizzazioni sufficienti per chiamare una funzione Lambda.
+ Se l'esecuzione di una funzione Lambda richiede più di 30 secondi.
+ Se una funzione Lambda di adempimento restituisce un'azione di `Delegate` dialogo senza rimuovere alcun valore dello slot.
Codice di stato HTTP: 424

 ** InternalFailureException **   
Errore interno del servizio. Riprova la chiamata.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 429

 ** NotAcceptableException **   
L'intestazione accept nella richiesta non ha un valore valido.  
Codice di stato HTTP: 406

 ** NotFoundException **   
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_runtime_PutSession_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PutSession) 

# Tipi di dati
<a name="API_Types"></a>

I seguenti tipi di dati sono supportati da Amazon Lex Model Building Service:
+  [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) 

I seguenti tipi di dati sono supportati da Amazon Lex Runtime Service:
+  [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) 

# Servizio di creazione di modelli Amazon Lex
<a name="API_Types_Amazon_Lex_Model_Building_Service"></a>

I seguenti tipi di dati sono supportati da Amazon Lex Model Building Service:
+  [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>

Fornisce informazioni su un alias bot.

## Indice
<a name="API_BotAliasMetadata_Contents"></a>

 ** botName **   <a name="lex-Type-BotAliasMetadata-botName"></a>
Il nome del bot a cui punta l'alias.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** botVersion **   <a name="lex-Type-BotAliasMetadata-botVersion"></a>
La versione del bot Amazon Lex a cui punta l'alias.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

 ** checksum **   <a name="lex-Type-BotAliasMetadata-checksum"></a>
Checksum dell'alias del bot.  
Tipo: string  
Campo obbligatorio: no

 ** conversationLogs **   <a name="lex-Type-BotAliasMetadata-conversationLogs"></a>
Impostazioni che determinano in che modo Amazon Lex utilizza i log delle conversazioni per l'alias.  
Tipo: oggetto [ConversationLogsResponse](API_ConversationLogsResponse.md)  
Campo obbligatorio: no

 ** createdDate **   <a name="lex-Type-BotAliasMetadata-createdDate"></a>
La data di creazione dell'alias del bot.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-BotAliasMetadata-description"></a>
Una descrizione dell'alias del bot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** lastUpdatedDate **   <a name="lex-Type-BotAliasMetadata-lastUpdatedDate"></a>
La data in cui l'alias del bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** name **   <a name="lex-Type-BotAliasMetadata-name"></a>
Il nome dell'alias del bot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_BotAliasMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotAliasMetadata) 

# BotChannelAssociation
<a name="API_BotChannelAssociation"></a>

Rappresenta un'associazione tra un bot Amazon Lex e una piattaforma di messaggistica esterna.

## Indice
<a name="API_BotChannelAssociation_Contents"></a>

 ** botAlias **   <a name="lex-Type-BotChannelAssociation-botAlias"></a>
Un alias che indica la versione specifica del bot Amazon Lex a cui viene effettuata questa associazione.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** botConfiguration **   <a name="lex-Type-BotChannelAssociation-botConfiguration"></a>
Fornisce le informazioni necessarie per comunicare con la piattaforma di messaggistica.   
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 10 elementi.  
Campo obbligatorio: no

 ** botName **   <a name="lex-Type-BotChannelAssociation-botName"></a>
Il nome del bot Amazon Lex a cui viene creata questa associazione.   
Attualmente, Amazon Lex supporta le associazioni con Facebook e Slack e Twilio.
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** createdDate **   <a name="lex-Type-BotChannelAssociation-createdDate"></a>
Data di creazione dell'associazione tra il bot Amazon Lex e il canale.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-BotChannelAssociation-description"></a>
Una descrizione testuale dell'associazione che stai creando.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** failureReason **   <a name="lex-Type-BotChannelAssociation-failureReason"></a>
In caso `status` `FAILED` affermativo, Amazon Lex fornisce il motivo per cui non è riuscita a creare l'associazione.  
Tipo: string  
Campo obbligatorio: no

 ** name **   <a name="lex-Type-BotChannelAssociation-name"></a>
Il nome dell'associazione tra il bot e il canale.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** status **   <a name="lex-Type-BotChannelAssociation-status"></a>
Lo stato del canale bot.   
+  `CREATED`- Il canale è stato creato ed è pronto per l'uso.
+  `IN_PROGRESS`- La creazione del canale è in corso.
+  `FAILED`- Si è verificato un errore durante la creazione del canale. Per informazioni sul motivo dell'errore, consulta il `failureReason` campo.
Tipo: stringa  
Valori validi: `IN_PROGRESS | CREATED | FAILED`   
Campo obbligatorio: no

 ** type **   <a name="lex-Type-BotChannelAssociation-type"></a>
Speciifica il tipo di associazione indicando il tipo di canale che viene stabilito tra il bot Amazon Lex e la piattaforma di messaggistica esterna.  
Tipo: stringa  
Valori validi: `Facebook | Slack | Twilio-Sms | Kik`   
Campo obbligatorio: no

## Vedi anche
<a name="API_BotChannelAssociation_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotChannelAssociation) 

# BotMetadata
<a name="API_BotMetadata"></a>

Fornisce informazioni su un bot.

## Indice
<a name="API_BotMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-BotMetadata-createdDate"></a>
La data di creazione del bot.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-BotMetadata-description"></a>
Una descrizione del bot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** lastUpdatedDate **   <a name="lex-Type-BotMetadata-lastUpdatedDate"></a>
La data in cui il bot è stato aggiornato. Quando crei un bot, la data di creazione e la data dell'ultimo aggiornamento coincidono.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** name **   <a name="lex-Type-BotMetadata-name"></a>
Il nome del bot.   
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** status **   <a name="lex-Type-BotMetadata-status"></a>
Lo stato del bot.  
Tipo: stringa  
Valori validi: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT`   
Campo obbligatorio: no

 ** version **   <a name="lex-Type-BotMetadata-version"></a>
La versione del bot. Per un nuovo bot, la versione è sempre`$LATEST`.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

## Vedi anche
<a name="API_BotMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotMetadata) 

# BuiltinIntentMetadata
<a name="API_BuiltinIntentMetadata"></a>

Fornisce metadati per un intento integrato.

## Indice
<a name="API_BuiltinIntentMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinIntentMetadata-signature"></a>
Un identificatore univoco per l'intento integrato. *Per trovare la firma di un intento, consulta [Standard Built-in Intents](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) nell'Alexa Skills Kit.*  
Tipo: string  
Campo obbligatorio: no

 ** supportedLocales **   <a name="lex-Type-BuiltinIntentMetadata-supportedLocales"></a>
Un elenco di identificatori per le impostazioni locali supportate dall'intento.  
Tipo: matrice di stringhe  
Valori validi: `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`   
Campo obbligatorio: no

## Vedi anche
<a name="API_BuiltinIntentMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentMetadata) 

# BuiltinIntentSlot
<a name="API_BuiltinIntentSlot"></a>

Fornisce informazioni su uno slot utilizzato in un intento integrato.

## Indice
<a name="API_BuiltinIntentSlot_Contents"></a>

 ** name **   <a name="lex-Type-BuiltinIntentSlot-name"></a>
Un elenco degli slot definiti per l'intento.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_BuiltinIntentSlot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentSlot) 

# BuiltinSlotTypeMetadata
<a name="API_BuiltinSlotTypeMetadata"></a>

Fornisce informazioni su un tipo di slot integrato.

## Indice
<a name="API_BuiltinSlotTypeMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinSlotTypeMetadata-signature"></a>
Un identificatore univoco per il tipo di slot integrato. Per trovare la firma per un tipo di slot, consulta [Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) nell'*Alexa Skills Kit*.  
Tipo: string  
Campo obbligatorio: no

 ** supportedLocales **   <a name="lex-Type-BuiltinSlotTypeMetadata-supportedLocales"></a>
Un elenco di localizzazioni di destinazione per lo slot.   
Tipo: matrice di stringhe  
Valori validi: `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`   
Campo obbligatorio: no

## Vedi anche
<a name="API_BuiltinSlotTypeMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 

# CodeHook
<a name="API_CodeHook"></a>

Specifica una funzione Lambda che verifica le richieste a un bot o soddisfa la richiesta dell'utente a un bot.

## Indice
<a name="API_CodeHook_Contents"></a>

 ** messageVersion **   <a name="lex-Type-CodeHook-messageVersion"></a>
La versione della richiesta-risposta che desideri che Amazon Lex utilizzi per richiamare la tua funzione Lambda. Per ulteriori informazioni, consulta [Utilizzo delle funzioni Lambda](using-lambda.md).  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 5.  
Campo obbligatorio: sì

 ** uri **   <a name="lex-Type-CodeHook-uri"></a>
Il nome della risorsa Amazon (ARN) della funzione Lambda.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `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-_]+)?`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_CodeHook_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CodeHook) 

# ConversationLogsRequest
<a name="API_ConversationLogsRequest"></a>

Fornisce le impostazioni necessarie per i registri delle conversazioni.

## Indice
<a name="API_ConversationLogsRequest_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsRequest-iamRoleArn"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM con il permesso di scrivere nei tuoi CloudWatch log per i log di testo e nel tuo bucket S3 per i log audio. Se la crittografia audio è abilitata, questo ruolo fornisce anche l'autorizzazione di accesso per la chiave AWS KMS utilizzata per crittografare i log audio. Per ulteriori informazioni, consulta [Creazione di un ruolo e di una policy IAM per i registri di](https://docs.aws.amazon.com/lex/latest/dg/conversation-logs-role-and-policy.html) conversazione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Campo obbligatorio: sì

 ** logSettings **   <a name="lex-Type-ConversationLogsRequest-logSettings"></a>
Le impostazioni per i registri delle conversazioni. È possibile registrare il testo della conversazione, l'audio della conversazione o entrambi.  
Tipo: matrice di oggetti [LogSettingsRequest](API_LogSettingsRequest.md)  
Campo obbligatorio: sì

## Vedi anche
<a name="API_ConversationLogsRequest_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsRequest) 

# ConversationLogsResponse
<a name="API_ConversationLogsResponse"></a>

Contiene informazioni sulle impostazioni del registro delle conversazioni.

## Indice
<a name="API_ConversationLogsResponse_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsResponse-iamRoleArn"></a>
L'Amazon Resource Name (ARN) del ruolo IAM usato per scrivere i log in CloudWatch Logs o in un bucket S3.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Campo obbligatorio: no

 ** logSettings **   <a name="lex-Type-ConversationLogsResponse-logSettings"></a>
Le impostazioni per i registri delle conversazioni. Puoi registrare testo, audio o entrambi.  
Tipo: matrice di oggetti [LogSettingsResponse](API_LogSettingsResponse.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_ConversationLogsResponse_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsResponse) 

# EnumerationValue
<a name="API_EnumerationValue"></a>

Ogni tipo di slot può disporre di un set di valori. Ogni valore di enumerazione rappresenta un valore che il tipo di slot può assumere. 

Ad esempio, un bot per ordinare pizze potrebbe avere un tipo di slot che specifica il tipo di crosta che deve avere la pizza. Il tipo di slot potrebbe includere i valori 
+ spessa
+ thin
+ farciti

## Indice
<a name="API_EnumerationValue_Contents"></a>

 ** value **   <a name="lex-Type-EnumerationValue-value"></a>
Il valore del tipo di slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 140.  
Campo obbligatorio: sì

 ** synonyms **   <a name="lex-Type-EnumerationValue-synonyms"></a>
Valori aggiuntivi relativi al valore del tipo di slot.  
Tipo: matrice di stringhe  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 140.  
Campo obbligatorio: no

## Vedi anche
<a name="API_EnumerationValue_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/EnumerationValue) 

# FollowUpPrompt
<a name="API_FollowUpPrompt"></a>

Richiesta di attività aggiuntive dopo il raggiungimento di un intento. Ad esempio, una volta soddisfatto l'`OrderPizza`intento, potresti richiedere all'utente di scoprire se desidera ordinare bevande.

## Indice
<a name="API_FollowUpPrompt_Contents"></a>

 ** prompt **   <a name="lex-Type-FollowUpPrompt-prompt"></a>
Richiede informazioni all'utente.   
Tipo: oggetto [Prompt](API_Prompt.md)  
Campo obbligatorio: sì

 ** rejectionStatement **   <a name="lex-Type-FollowUpPrompt-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita nel `prompt` campo, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)  
Campo obbligatorio: sì

## Vedi anche
<a name="API_FollowUpPrompt_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FollowUpPrompt) 

# FulfillmentActivity
<a name="API_FulfillmentActivity"></a>

 Descrive come l'intento viene soddisfatto dopo che l'utente ha fornito tutte le informazioni necessarie per l'intento. È possibile fornire una funzione Lambda per elaborare l'intento oppure restituire le informazioni sull'intento all'applicazione client. Ti consigliamo di utilizzare una funzione Lambda in modo che la logica pertinente risieda nel cloud e limiti il codice lato client principalmente alla presentazione. Se è necessario aggiornare la logica, è sufficiente aggiornare la funzione Lambda; non è necessario aggiornare l'applicazione client. 

Considerare i seguenti esempi:
+ In un'applicazione per ordinare pizze, dopo che l'utente ha fornito tutte le informazioni per effettuare un ordine, si utilizza una funzione Lambda per effettuare un ordine presso una pizzeria. 
+ In un'applicazione di gioco, quando un utente dice «pick up a rock», queste informazioni devono tornare all'applicazione client in modo che possa eseguire l'operazione e aggiornare la grafica. In questo caso, desideri che Amazon Lex restituisca i dati sulle intenzioni al client. 

## Indice
<a name="API_FulfillmentActivity_Contents"></a>

 ** type **   <a name="lex-Type-FulfillmentActivity-type"></a>
 Come deve essere raggiunto l'intento, eseguendo una funzione Lambda o restituendo i dati dello slot all'applicazione client.   
Tipo: stringa  
Valori validi: `ReturnIntent | CodeHook`   
Campo obbligatorio: sì

 ** codeHook **   <a name="lex-Type-FulfillmentActivity-codeHook"></a>
 Una descrizione della funzione Lambda che viene eseguita per soddisfare l'intento.   
Tipo: oggetto [CodeHook](API_CodeHook.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_FulfillmentActivity_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FulfillmentActivity) 

# InputContext
<a name="API_InputContext"></a>

Il nome di un contesto che deve essere attivo affinché un intento possa essere selezionato da Amazon Lex.

## Indice
<a name="API_InputContext_Contents"></a>

 ** name **   <a name="lex-Type-InputContext-name"></a>
Il nome del contesto.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_InputContext_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/InputContext) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/InputContext) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/InputContext) 

# Intent
<a name="API_Intent"></a>

Identifica la versione specifica di un intento.

## Indice
<a name="API_Intent_Contents"></a>

 ** intentName **   <a name="lex-Type-Intent-intentName"></a>
Il nome dell'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: sì

 ** intentVersion **   <a name="lex-Type-Intent-intentVersion"></a>
La versione dell'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: sì

## Vedi anche
<a name="API_Intent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Intent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Intent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Intent) 

# IntentMetadata
<a name="API_IntentMetadata"></a>

Fornisce informazioni su un intento.

## Indice
<a name="API_IntentMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-IntentMetadata-createdDate"></a>
La data in cui è stato creato l'intento.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-IntentMetadata-description"></a>
Una descrizione dell'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** lastUpdatedDate **   <a name="lex-Type-IntentMetadata-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato. Quando crei un intento, la data di creazione e la data dell'ultimo aggiornamento coincidono.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** name **   <a name="lex-Type-IntentMetadata-name"></a>
Il nome dell'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** version **   <a name="lex-Type-IntentMetadata-version"></a>
La versione dell'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

## Vedi anche
<a name="API_IntentMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/IntentMetadata) 

# KendraConfiguration
<a name="API_KendraConfiguration"></a>

Fornisce informazioni di configurazione per AMAZON. KendraSearchIntentintento. Quando usi questo intento, Amazon Lex cerca nell'indice Amazon Kendra specificato e restituisce i documenti dall'indice che corrispondono all'enunciato dell'utente. [Per ulteriori informazioni, consulta AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).

## Indice
<a name="API_KendraConfiguration_Contents"></a>

 ** kendraIndex **   <a name="lex-Type-KendraConfiguration-kendraIndex"></a>
L'Amazon Resource Name (ARN) dell'indice Amazon Kendra su cui desideri inserire AMAZON. KendraSearchIntent intenzione di effettuare una ricerca. L'indice deve trovarsi nello stesso account e nella stessa regione del bot Amazon Lex. Se l'indice Amazon Kendra non esiste, ottieni un'eccezione quando chiami l'operazione. `PutIntent`  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `arn:aws:kendra:[a-z]+-[a-z]+-[0-9]:[0-9]{12}:index\/[a-zA-Z0-9][a-zA-Z0-9_-]*`   
Campo obbligatorio: sì

 ** role **   <a name="lex-Type-KendraConfiguration-role"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM autorizzato a effettuare ricerche nell'indice Amazon Kendra. Il ruolo deve trovarsi nello stesso account e nella stessa regione del bot Amazon Lex. Se il ruolo non esiste, si ottiene un'eccezione quando si chiama l'`PutIntent`operazione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `arn:aws:iam::[0-9]{12}:role/.*`   
Campo obbligatorio: sì

 ** queryFilterString **   <a name="lex-Type-KendraConfiguration-queryFilterString"></a>
Un filtro di query che Amazon Lex invia ad Amazon Kendra per filtrare la risposta dalla query. Il filtro è nel formato definito da Amazon Kendra. Per ulteriori informazioni, consulta [Filtraggio](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html) delle interrogazioni.  
È possibile sovrascrivere questa stringa di filtro con una nuova stringa di filtro in fase di esecuzione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0.  
Campo obbligatorio: no

## Vedi anche
<a name="API_KendraConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/KendraConfiguration) 

# LogSettingsRequest
<a name="API_LogSettingsRequest"></a>

Impostazioni utilizzate per configurare la modalità di consegna e la destinazione per i registri delle conversazioni.

## Indice
<a name="API_LogSettingsRequest_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsRequest-destination"></a>
Dove verranno consegnati i log. I log di testo vengono consegnati a un gruppo di CloudWatch log Logs. I log audio vengono inviati a un bucket S3.  
Tipo: stringa  
Valori validi: `CLOUDWATCH_LOGS | S3`   
Campo obbligatorio: sì

 ** logType **   <a name="lex-Type-LogSettingsRequest-logType"></a>
Il tipo di registrazione da abilitare. I log di testo vengono consegnati a un gruppo di CloudWatch log Logs. I log audio vengono inviati a un bucket S3.  
Tipo: stringa  
Valori validi: `AUDIO | TEXT`   
Campo obbligatorio: sì

 ** resourceArn **   <a name="lex-Type-LogSettingsRequest-resourceArn"></a>
L'Amazon Resource Name (ARN) del gruppo di log CloudWatch Logs o del bucket S3 in cui devono essere consegnati i log.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Modello: `^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])$`   
Campo obbligatorio: sì

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsRequest-kmsKeyArn"></a>
L'Amazon Resource Name (ARN) della chiave gestita dal cliente AWS KMS per la crittografia dei log audio distribuiti a un bucket S3. La chiave non si applica ai CloudWatch log ed è facoltativa per i bucket S3.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_LogSettingsRequest_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsRequest) 

# LogSettingsResponse
<a name="API_LogSettingsResponse"></a>

Le impostazioni per i registri delle conversazioni.

## Indice
<a name="API_LogSettingsResponse_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsResponse-destination"></a>
La destinazione in cui vengono consegnati i log.  
Tipo: stringa  
Valori validi: `CLOUDWATCH_LOGS | S3`   
Campo obbligatorio: no

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsResponse-kmsKeyArn"></a>
L'Amazon Resource Name (ARN) della chiave utilizzata per crittografare i log audio in un bucket S3.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Campo obbligatorio: no

 ** logType **   <a name="lex-Type-LogSettingsResponse-logType"></a>
Il tipo di registrazione abilitato.  
Tipo: stringa  
Valori validi: `AUDIO | TEXT`   
Campo obbligatorio: no

 ** resourceArn **   <a name="lex-Type-LogSettingsResponse-resourceArn"></a>
L'Amazon Resource Name (ARN) del gruppo di log CloudWatch Logs o del bucket S3 in cui vengono consegnati i log.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Modello: `^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])$`   
Campo obbligatorio: no

 ** resourcePrefix **   <a name="lex-Type-LogSettingsResponse-resourcePrefix"></a>
Il prefisso della risorsa è la prima parte della chiave dell'oggetto S3 all'interno del bucket S3 che hai specificato per contenere i log audio. Per CloudWatch Logs è il prefisso del nome del flusso di log all'interno del gruppo di log specificato.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza massima di 1024.  
Campo obbligatorio: no

## Vedi anche
<a name="API_LogSettingsResponse_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsResponse) 

# Message
<a name="API_Message"></a>

L'oggetto del messaggio che fornisce il testo del messaggio e il relativo tipo.

## Indice
<a name="API_Message_Contents"></a>

 ** content **   <a name="lex-Type-Message-content"></a>
Il testo del messaggio.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.  
Campo obbligatorio: sì

 ** contentType **   <a name="lex-Type-Message-contentType"></a>
Il tipo di contenuto della stringa del messaggio.  
Tipo: stringa  
Valori validi: `PlainText | SSML | CustomPayload`   
Campo obbligatorio: sì

 ** groupNumber **   <a name="lex-Type-Message-groupNumber"></a>
Identifica il gruppo di messaggi a cui appartiene il messaggio. Quando un gruppo viene assegnato a un messaggio, Amazon Lex restituisce un messaggio per ogni gruppo nella risposta.  
Tipo: integer  
Intervallo valido: valore minimo di 1. Valore massimo di 5.  
Campo obbligatorio: no

## Vedi anche
<a name="API_Message_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Message) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Message) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Message) 

# MigrationAlert
<a name="API_MigrationAlert"></a>

Fornisce informazioni sugli avvisi e gli avvisi che Amazon Lex invia durante una migrazione. Gli avvisi includono informazioni su come risolvere il problema.

## Indice
<a name="API_MigrationAlert_Contents"></a>

 ** details **   <a name="lex-Type-MigrationAlert-details"></a>
Dettagli aggiuntivi sull'avviso.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** message **   <a name="lex-Type-MigrationAlert-message"></a>
Un messaggio che descrive il motivo per cui è stato emesso l'avviso.  
Tipo: string  
Campo obbligatorio: no

 ** referenceURLs **   <a name="lex-Type-MigrationAlert-referenceURLs"></a>
Un link alla documentazione di Amazon Lex che descrive come risolvere l'avviso.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** type **   <a name="lex-Type-MigrationAlert-type"></a>
Il tipo di avviso. Esistono due tipi di avvisi:  
+  `ERROR`- Si è verificato un problema con la migrazione che non può essere risolto. La migrazione si interrompe.
+  `WARN`- Si è verificato un problema con la migrazione che richiede modifiche manuali al nuovo bot Amazon Lex V2. La migrazione continua.
Tipo: stringa  
Valori validi: `ERROR | WARN`   
Campo obbligatorio: no

## Vedi anche
<a name="API_MigrationAlert_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationAlert) 

# MigrationSummary
<a name="API_MigrationSummary"></a>

Fornisce informazioni sulla migrazione di un bot da Amazon Lex V1 ad Amazon Lex V2.

## Indice
<a name="API_MigrationSummary_Contents"></a>

 ** migrationId **   <a name="lex-Type-MigrationSummary-migrationId"></a>
L'identificatore univoco assegnato da Amazon Lex alla migrazione.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$`   
Campo obbligatorio: no

 ** migrationStatus **   <a name="lex-Type-MigrationSummary-migrationStatus"></a>
Stato dell'operazione. Quando lo stato è, `COMPLETE` il bot è disponibile in Amazon Lex V2. Potrebbero esserci avvisi e avvisi che devono essere risolti per completare la migrazione.  
Tipo: stringa  
Valori validi: `IN_PROGRESS | COMPLETED | FAILED`   
Campo obbligatorio: no

 ** migrationStrategy **   <a name="lex-Type-MigrationSummary-migrationStrategy"></a>
La strategia utilizzata per condurre la migrazione.  
Tipo: stringa  
Valori validi: `CREATE_NEW | UPDATE_EXISTING`   
Campo obbligatorio: no

 ** migrationTimestamp **   <a name="lex-Type-MigrationSummary-migrationTimestamp"></a>
La data e l'ora di inizio della migrazione.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** v1BotLocale **   <a name="lex-Type-MigrationSummary-v1BotLocale"></a>
La lingua del bot Amazon Lex V1 che è l'origine della migrazione.  
Tipo: stringa  
Valori validi: `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`   
Campo obbligatorio: no

 ** v1BotName **   <a name="lex-Type-MigrationSummary-v1BotName"></a>
Il nome del bot Amazon Lex V1 che è l'origine della migrazione.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** v1BotVersion **   <a name="lex-Type-MigrationSummary-v1BotVersion"></a>
La versione del bot Amazon Lex V1 che è l'origine della migrazione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

 ** v2BotId **   <a name="lex-Type-MigrationSummary-v2BotId"></a>
L'identificatore univoco di Amazon Lex V2 che è la destinazione della migrazione.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 10.  
Modello: `^[0-9a-zA-Z]+$`   
Campo obbligatorio: no

 ** v2BotRole **   <a name="lex-Type-MigrationSummary-v2BotRole"></a>
Il ruolo IAM utilizzato da Amazon Lex per eseguire il bot Amazon Lex V2.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.  
Modello: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Campo obbligatorio: no

## Vedi anche
<a name="API_MigrationSummary_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationSummary) 

# OutputContext
<a name="API_OutputContext"></a>

La specifica di un contesto di output che viene impostato quando viene soddisfatto un intento.

## Indice
<a name="API_OutputContext_Contents"></a>

 ** name **   <a name="lex-Type-OutputContext-name"></a>
Il nome del contesto.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: sì

 ** timeToLiveInSeconds **   <a name="lex-Type-OutputContext-timeToLiveInSeconds"></a>
Il numero di secondi in cui il contesto deve essere attivo dopo il primo invio in una risposta `PostContent` or`PostText`. È possibile impostare il valore tra 5 e 86.400 secondi (24 ore).  
Tipo: integer  
Intervallo valido: valore minimo di 5. Valore massimo pari a 86400.  
Campo obbligatorio: sì

 ** turnsToLive **   <a name="lex-Type-OutputContext-turnsToLive"></a>
Il numero di conversazioni richiede che il contesto sia attivo. Un turno di conversazione è uno `PostContent` o una `PostText` richiesta e la risposta corrispondente di Amazon Lex.  
Tipo: integer  
Intervallo valido: valore minimo di 1. Valore massimo di 20.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_OutputContext_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/OutputContext) 

# Prompt
<a name="API_Prompt"></a>

Ottiene informazioni dall'utente. Per definire un prompt, fornite uno o più messaggi e specificate il numero di tentativi di ottenere informazioni dall'utente. Se fornisci più di un messaggio, Amazon Lex sceglie uno dei messaggi da utilizzare per richiedere conferma all'utente. Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md).

## Indice
<a name="API_Prompt_Contents"></a>

 ** maxAttempts **   <a name="lex-Type-Prompt-maxAttempts"></a>
Il numero di volte in cui vengono richieste informazioni all'utente.  
Tipo: integer  
Intervallo valido: valore minimo di 1. Valore massimo di 5.  
Campo obbligatorio: sì

 ** messages **   <a name="lex-Type-Prompt-messages"></a>
Una matrice di oggetti, ognuno dei quali fornisce una stringa di messaggio e il relativo tipo. È possibile specificare la stringa del messaggio in testo semplice o in Speech Synthesis Markup Language (SSML).  
Tipo: matrice di oggetti [Message](API_Message.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 15 articoli.  
Campo obbligatorio: sì

 ** responseCard **   <a name="lex-Type-Prompt-responseCard"></a>
Una scheda di risposta. Amazon Lex utilizza questo prompt in fase di esecuzione, nella risposta dell'`PostText`API. Sostituisce gli attributi di sessione e i valori degli slot con i segnaposto nella scheda di risposta. Per ulteriori informazioni, consulta [Utilizzo di una scheda di risposta](ex-resp-card.md).   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 50000.  
Campo obbligatorio: no

## Vedi anche
<a name="API_Prompt_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Prompt) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Prompt) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Prompt) 

# ResourceReference
<a name="API_ResourceReference"></a>

Descrive la risorsa che si riferisce alla risorsa che si sta tentando di eliminare. Questo oggetto viene restituito come parte dell'`ResourceInUseException`eccezione. 

## Indice
<a name="API_ResourceReference_Contents"></a>

 ** name **   <a name="lex-Type-ResourceReference-name"></a>
Il nome della risorsa che sta utilizzando la risorsa che si sta tentando di eliminare.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z_]+`   
Campo obbligatorio: no

 ** version **   <a name="lex-Type-ResourceReference-version"></a>
La versione della risorsa che utilizza la risorsa che si sta tentando di eliminare.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

## Vedi anche
<a name="API_ResourceReference_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ResourceReference) 

# Slot
<a name="API_Slot"></a>

Identifica la versione di uno slot specifico.

## Indice
<a name="API_Slot_Contents"></a>

 ** name **   <a name="lex-Type-Slot-name"></a>
Il nome dello slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z](-|_|.)?)+$`   
Campo obbligatorio: sì

 ** slotConstraint **   <a name="lex-Type-Slot-slotConstraint"></a>
Specifica se lo slot è obbligatorio o facoltativo.   
Tipo: stringa  
Valori validi: `Required | Optional`   
Campo obbligatorio: sì

 ** defaultValueSpec **   <a name="lex-Type-Slot-defaultValueSpec"></a>
Un elenco di valori predefiniti per lo slot. I valori predefiniti vengono utilizzati quando Amazon Lex non ha determinato un valore per uno slot. Puoi specificare valori predefiniti da variabili di contesto, attributi di sessione e valori definiti.  
Tipo: oggetto [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md)  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-Slot-description"></a>
Una descrizione dello slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** obfuscationSetting **   <a name="lex-Type-Slot-obfuscationSetting"></a>
Determina se uno slot è offuscato nei registri delle conversazioni e negli enunciati memorizzati. Quando offuscate uno slot, il valore viene sostituito dal nome dello slot tra parentesi graffe (\$1\$1). Ad esempio, se il nome dello slot è «full\$1name», i valori offuscati vengono sostituiti con «\$1full\$1name\$1». [Per ulteriori informazioni, consulta Slot Obfuscation.](https://docs.aws.amazon.com/lex/latest/dg/how-obfuscate.html)   
Tipo: stringa  
Valori validi: `NONE | DEFAULT_OBFUSCATION`   
Campo obbligatorio: no

 ** priority **   <a name="lex-Type-Slot-priority"></a>
 Indica ad Amazon Lex l'ordine in cui ottenere questo valore di slot dall'utente. Ad esempio, se l'intento ha due slot con priorità 1 e 2, AWS Amazon Lex richiama innanzitutto un valore per lo slot con priorità 1.  
Se più slot condividono la stessa priorità, l'ordine in cui Amazon Lex ottiene i valori è arbitrario.  
Tipo: integer  
Intervallo valido: valore minimo di 0. valore massimo pari a 100.  
Campo obbligatorio: no

 ** responseCard **   <a name="lex-Type-Slot-responseCard"></a>
 Un insieme di possibili risposte per il tipo di slot utilizzato dai client basati su testo. Un utente sceglie un'opzione dalla scheda di risposta, invece di utilizzare il testo per rispondere.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 50000.  
Campo obbligatorio: no

 ** sampleUtterances **   <a name="lex-Type-Slot-sampleUtterances"></a>
 Se conosci uno schema specifico con cui gli utenti potrebbero rispondere a una richiesta Amazon Lex per il valore di uno slot, puoi fornire tali enunciati per migliorare la precisione. Si tratta di un'opzione facoltativa. Nella maggior parte dei casi, Amazon Lex è in grado di comprendere le espressioni degli utenti.   
Tipo: matrice di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** slotType **   <a name="lex-Type-Slot-slotType"></a>
Il tipo di slot, un tipo di slot personalizzato definito dall'utente o uno dei tipi di slot incorporati.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Campo obbligatorio: no

 ** slotTypeVersion **   <a name="lex-Type-Slot-slotTypeVersion"></a>
La versione del tipo di slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

 ** valueElicitationPrompt **   <a name="lex-Type-Slot-valueElicitationPrompt"></a>
Il prompt utilizzato da Amazon Lex per ottenere il valore dello slot dall'utente.  
Tipo: oggetto [Prompt](API_Prompt.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_Slot_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Slot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Slot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Slot) 

# SlotDefaultValue
<a name="API_SlotDefaultValue"></a>

Un valore predefinito per uno slot.

## Indice
<a name="API_SlotDefaultValue_Contents"></a>

 ** defaultValue **   <a name="lex-Type-SlotDefaultValue-defaultValue"></a>
Il valore predefinito per lo slot. È possibile specificare una delle seguenti opzioni:  
+  `#context-name.slot-name`- Il valore dello slot «slot-name» nel contesto «context-name».
+  `{attribute}`- Il valore dello slot dell'attributo di sessione «attribute».
+  `'value'`- Il valore discreto «value».
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 202.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_SlotDefaultValue_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValue) 

# SlotDefaultValueSpec
<a name="API_SlotDefaultValueSpec"></a>

Contiene i valori predefiniti per uno slot. I valori predefiniti vengono utilizzati quando Amazon Lex non ha determinato un valore per uno slot.

## Indice
<a name="API_SlotDefaultValueSpec_Contents"></a>

 ** defaultValueList **   <a name="lex-Type-SlotDefaultValueSpec-defaultValueList"></a>
I valori predefiniti per uno slot. È possibile specificare più di un valore predefinito. Ad esempio, è possibile specificare un valore predefinito da utilizzare da una variabile di contesto corrispondente, un attributo di sessione o un valore fisso.  
Il valore predefinito scelto viene selezionato in base all'ordine in cui vengono specificati nell'elenco. Ad esempio, se specifichi una variabile di contesto e un valore fisso in quell'ordine, Amazon Lex utilizza la variabile di contesto se è disponibile, altrimenti utilizza il valore fisso.  
Tipo: matrice di oggetti [SlotDefaultValue](API_SlotDefaultValue.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_SlotDefaultValueSpec_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValueSpec) 

# SlotTypeConfiguration
<a name="API_SlotTypeConfiguration"></a>

Fornisce informazioni di configurazione per un tipo di slot.

## Indice
<a name="API_SlotTypeConfiguration_Contents"></a>

 ** regexConfiguration **   <a name="lex-Type-SlotTypeConfiguration-regexConfiguration"></a>
Un'espressione regolare utilizzata per convalidare il valore di uno slot.  
Tipo: oggetto [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_SlotTypeConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeConfiguration) 

# SlotTypeMetadata
<a name="API_SlotTypeMetadata"></a>

Fornisce informazioni su un tipo di slot.

## Indice
<a name="API_SlotTypeMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-SlotTypeMetadata-createdDate"></a>
La data di creazione del tipo di slot.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** description **   <a name="lex-Type-SlotTypeMetadata-description"></a>
Una descrizione del tipo di slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.  
Campo obbligatorio: no

 ** lastUpdatedDate **   <a name="lex-Type-SlotTypeMetadata-lastUpdatedDate"></a>
La data in cui il tipo di slot è stato aggiornato. Quando si crea una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.   
Tipo: Timestamp  
Campo obbligatorio: no

 ** name **   <a name="lex-Type-SlotTypeMetadata-name"></a>
Il nome del tipo di slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: no

 ** version **   <a name="lex-Type-SlotTypeMetadata-version"></a>
La versione del tipo di slot.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

## Vedi anche
<a name="API_SlotTypeMetadata_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeMetadata) 

# SlotTypeRegexConfiguration
<a name="API_SlotTypeRegexConfiguration"></a>

Fornisce un'espressione regolare utilizzata per convalidare il valore di uno slot.

## Indice
<a name="API_SlotTypeRegexConfiguration_Contents"></a>

 ** pattern **   <a name="lex-Type-SlotTypeRegexConfiguration-pattern"></a>
Un'espressione regolare utilizzata per convalidare il valore di uno slot.   
Usa un'espressione regolare standard. Amazon Lex supporta i seguenti caratteri nell'espressione regolare:  
+ A-Z, a-z
+ 0-9
+ Caratteri Unicode («\$1 u <Unicode>«)
Rappresenta caratteri Unicode con quattro cifre, ad esempio «\$1 u0041" o «\$1 u005A».  
I seguenti operatori di espressioni regolari non sono supportati:  
+ Ripetitori infiniti: \$1, \$1 o \$1x,\$1 senza limite superiore.
+ Wild card (.)
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_SlotTypeRegexConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue: AWS SDKs
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeRegexConfiguration) 

# Statement
<a name="API_Statement"></a>

Una raccolta di messaggi che trasmettono informazioni all'utente. In fase di esecuzione, Amazon Lex seleziona il messaggio da trasmettere. 

## Indice
<a name="API_Statement_Contents"></a>

 ** messages **   <a name="lex-Type-Statement-messages"></a>
Una raccolta di oggetti di messaggio.  
Tipo: matrice di oggetti [Message](API_Message.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 15 elementi.  
Campo obbligatorio: sì

 ** responseCard **   <a name="lex-Type-Statement-responseCard"></a>
 In fase di esecuzione, se il client utilizza l'[PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)API, Amazon Lex include la scheda di risposta nella risposta. Sostituisce tutti gli attributi di sessione e i valori degli slot con i segnaposto nella scheda di risposta.   
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 50000.  
Campo obbligatorio: no

## Vedi anche
<a name="API_Statement_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Statement) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Statement) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Statement) 

# Tag
<a name="API_Tag"></a>

Un elenco di coppie chiave/valore che identificano un bot, un alias di bot o un canale bot. Le chiavi e i valori dei tag possono essere costituiti da lettere Unicode, cifre, spazi bianchi e uno dei seguenti simboli: \$1.:/= \$1 - @. 

## Indice
<a name="API_Tag_Contents"></a>

 ** key **   <a name="lex-Type-Tag-key"></a>
La chiave per il tag. Le chiavi non fanno distinzione tra maiuscole e minuscole e devono essere uniche.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Campo obbligatorio: sì

 ** value **   <a name="lex-Type-Tag-value"></a>
Il valore associato a una chiave. Il valore può essere una stringa vuota ma non può essere nullo.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_Tag_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Tag) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Tag) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Tag) 

# UtteranceData
<a name="API_UtteranceData"></a>

Fornisce informazioni su una singola espressione che è stata fatta al tuo bot. 

## Indice
<a name="API_UtteranceData_Contents"></a>

 ** count **   <a name="lex-Type-UtteranceData-count"></a>
Il numero di volte in cui l'enunciato è stato elaborato.  
Tipo: integer  
Campo obbligatorio: no

 ** distinctUsers **   <a name="lex-Type-UtteranceData-distinctUsers"></a>
Il numero totale di individui che hanno usato l'enunciato.  
Tipo: integer  
Campo obbligatorio: no

 ** firstUtteredDate **   <a name="lex-Type-UtteranceData-firstUtteredDate"></a>
Data in cui l'enunciato è stato registrato per la prima volta.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** lastUtteredDate **   <a name="lex-Type-UtteranceData-lastUtteredDate"></a>
Data dell'ultima registrazione dell'enunciato.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** utteranceString **   <a name="lex-Type-UtteranceData-utteranceString"></a>
Il testo inserito dall'utente o la rappresentazione testuale di una clip audio.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 2000.  
Campo obbligatorio: no

## Vedi anche
<a name="API_UtteranceData_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceData) 

# UtteranceList
<a name="API_UtteranceList"></a>

Fornisce un elenco di espressioni che sono state fatte a una versione specifica del bot. L'elenco contiene un massimo di 100 enunciati.

## Indice
<a name="API_UtteranceList_Contents"></a>

 ** botVersion **   <a name="lex-Type-UtteranceList-botVersion"></a>
La versione del bot che ha elaborato l'elenco.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+`   
Campo obbligatorio: no

 ** utterances **   <a name="lex-Type-UtteranceList-utterances"></a>
Uno o più [UtteranceData](API_UtteranceData.md) oggetti che contengono informazioni sugli enunciati che sono stati fatti a un bot. Il numero massimo di oggetti è 100.  
Tipo: matrice di oggetti [UtteranceData](API_UtteranceData.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_UtteranceList_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceList) 

# Servizio Amazon Lex Runtime
<a name="API_Types_Amazon_Lex_Runtime_Service"></a>

I seguenti tipi di dati sono supportati da Amazon Lex Runtime Service:
+  [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>

Un contesto è una variabile che contiene informazioni sullo stato corrente della conversazione tra un utente e Amazon Lex. Il contesto può essere impostato automaticamente da Amazon Lex quando un intento viene soddisfatto oppure può essere impostato in fase di esecuzione utilizzando l'operazione `PutContent``PutText`, o`PutSession`.

## Indice
<a name="API_runtime_ActiveContext_Contents"></a>

 ** name **   <a name="lex-Type-runtime_ActiveContext-name"></a>
Il nome del contesto.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Campo obbligatorio: sì

 ** parameters **   <a name="lex-Type-runtime_ActiveContext-parameters"></a>
Variabili di stato per il contesto corrente. È possibile utilizzare questi valori come valori predefiniti per gli slot negli eventi successivi.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. Lunghezza massima di 100.  
Valore dei vincoli di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.  
Campo obbligatorio: sì

 ** timeToLive **   <a name="lex-Type-runtime_ActiveContext-timeToLive"></a>
Il periodo di tempo o il numero di turni in cui un contesto rimane attivo.  
Tipo: oggetto [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md)  
Campo obbligatorio: sì

## Vedi anche
<a name="API_runtime_ActiveContext_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContext) 

# ActiveContextTimeToLive
<a name="API_runtime_ActiveContextTimeToLive"></a>

La durata o il numero di turni in cui un contesto rimane attivo.

## Indice
<a name="API_runtime_ActiveContextTimeToLive_Contents"></a>

 ** timeToLiveInSeconds **   <a name="lex-Type-runtime_ActiveContextTimeToLive-timeToLiveInSeconds"></a>
Il numero di secondi in cui il contesto deve essere attivo dopo il primo invio in una `PostText` risposta `PostContent` or. È possibile impostare il valore tra 5 e 86.400 secondi (24 ore).  
Tipo: integer  
Intervallo valido: valore minimo di 5. Valore massimo pari a 86400.  
Campo obbligatorio: no

 ** turnsToLive **   <a name="lex-Type-runtime_ActiveContextTimeToLive-turnsToLive"></a>
Il numero di conversazioni richiede che il contesto sia attivo. Un turno di conversazione è uno `PostContent` o una `PostText` richiesta e la risposta corrispondente di Amazon Lex.  
Tipo: integer  
Intervallo valido: valore minimo di 1. Valore massimo di 20.  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_ActiveContextTimeToLive_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContextTimeToLive) 

# Button
<a name="API_runtime_Button"></a>

Rappresenta un'opzione da mostrare sulla piattaforma client (Facebook, Slack, ecc.)

## Indice
<a name="API_runtime_Button_Contents"></a>

 ** text **   <a name="lex-Type-runtime_Button-text"></a>
Testo visibile all'utente sul pulsante.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 15 caratteri.  
Campo obbligatorio: sì

 ** value **   <a name="lex-Type-runtime_Button-value"></a>
Il valore inviato ad Amazon Lex quando un utente sceglie il pulsante. Ad esempio, considera il testo del pulsante «NYC». Quando l'utente sceglie il pulsante, il valore inviato può essere «New York City».  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.  
Campo obbligatorio: sì

## Vedi anche
<a name="API_runtime_Button_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/Button) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/Button) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/Button) 

# DialogAction
<a name="API_runtime_DialogAction"></a>

Descrive l'azione successiva che il bot deve intraprendere nella sua interazione con l'utente e fornisce informazioni sul contesto in cui avviene l'azione. Utilizzate il tipo di `DialogAction` dati per impostare l'interazione su uno stato specifico o per riportare l'interazione a uno stato precedente.

## Indice
<a name="API_runtime_DialogAction_Contents"></a>

 ** type **   <a name="lex-Type-runtime_DialogAction-type"></a>
L'azione successiva che il bot deve intraprendere nella sua interazione con l'utente. I valori possibili sono:  
+  `ConfirmIntent`- L'azione successiva è chiedere all'utente se l'intento è completo e pronto per essere realizzato. Questa è una domanda sì/no, ad esempio «Effettua l'ordine?»
+  `Close`- Indica che non ci sarà alcuna risposta da parte dell'utente. Ad esempio, l'affermazione «Il tuo ordine è stato effettuato» non richiede una risposta.
+  `Delegate`- L'azione successiva è determinata da Amazon Lex.
+  `ElicitIntent`- L'azione successiva consiste nel determinare l'intento che l'utente desidera soddisfare.
+  `ElicitSlot`- L'azione successiva consiste nel richiedere all'utente un valore di slot.
Tipo: stringa  
Valori validi: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Campo obbligatorio: sì

 ** fulfillmentState **   <a name="lex-Type-runtime_DialogAction-fulfillmentState"></a>
Lo stato di adempimento dell'intento. I valori possibili sono:  
+  `Failed`- La funzione Lambda associata all'intento non è riuscita a soddisfare l'intento.
+  `Fulfilled`- L'intento è stato raggiunto dalla funzione Lambda associata all'intento. 
+  `ReadyForFulfillment`- Tutte le informazioni necessarie per l'intento sono presenti e l'intento è pronto per essere soddisfatto dall'applicazione client.
Tipo: stringa  
Valori validi: `Fulfilled | Failed | ReadyForFulfillment`   
Campo obbligatorio: no

 ** intentName **   <a name="lex-Type-runtime_DialogAction-intentName"></a>
Il nome dell'intento.  
Tipo: string  
Campo obbligatorio: no

 ** message **   <a name="lex-Type-runtime_DialogAction-message"></a>
Il messaggio che deve essere mostrato all'utente. Se non specifichi un messaggio, Amazon Lex utilizzerà il messaggio configurato per l'intento.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Campo obbligatorio: no

 ** messageFormat **   <a name="lex-Type-runtime_DialogAction-messageFormat"></a>
+  `PlainText`- Il messaggio contiene testo UTF-8 semplice.
+  `CustomPayload`- Il messaggio è un formato personalizzato per il cliente.
+  `SSML`- Il messaggio contiene testo formattato per l'output vocale.
+  `Composite`- Il messaggio contiene un oggetto JSON in escape contenente uno o più messaggi. Per ulteriori informazioni, consulta Gruppi di [messaggi](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html). 
Tipo: stringa  
Valori validi: `PlainText | CustomPayload | SSML | Composite`   
Campo obbligatorio: no

 ** slots **   <a name="lex-Type-runtime_DialogAction-slots"></a>
Mappa degli slot che sono stati raccolti e dei relativi valori.   
Tipo: mappatura stringa a stringa  
Campo obbligatorio: no

 ** slotToElicit **   <a name="lex-Type-runtime_DialogAction-slotToElicit"></a>
Il nome dello slot che deve essere richiesto all'utente.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_DialogAction_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DialogAction) 

# GenericAttachment
<a name="API_runtime_GenericAttachment"></a>

Rappresenta un'opzione resa all'utente quando viene visualizzato un prompt. Potrebbe essere un'immagine, un pulsante, un link o un testo. 

## Indice
<a name="API_runtime_GenericAttachment_Contents"></a>

 ** attachmentLinkUrl **   <a name="lex-Type-runtime_GenericAttachment-attachmentLinkUrl"></a>
L'URL di un allegato alla scheda di risposta.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** buttons **   <a name="lex-Type-runtime_GenericAttachment-buttons"></a>
L'elenco delle opzioni da mostrare all'utente.  
Tipo: matrice di oggetti [Button](API_runtime_Button.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.  
Campo obbligatorio: no

 ** imageUrl **   <a name="lex-Type-runtime_GenericAttachment-imageUrl"></a>
L'URL di un'immagine che viene mostrata all'utente.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: no

 ** subTitle **   <a name="lex-Type-runtime_GenericAttachment-subTitle"></a>
Il sottotitolo visualizzato sotto il titolo.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.  
Campo obbligatorio: no

 ** title **   <a name="lex-Type-runtime_GenericAttachment-title"></a>
Il titolo dell'opzione.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_GenericAttachment_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GenericAttachment) 

# IntentConfidence
<a name="API_runtime_IntentConfidence"></a>

Fornisce un punteggio che indica la fiducia di Amazon Lex nel fatto che l'intento sia quello che soddisfa l'intento dell'utente.

## Indice
<a name="API_runtime_IntentConfidence_Contents"></a>

 ** score **   <a name="lex-Type-runtime_IntentConfidence-score"></a>
Un punteggio che indica quanto Amazon Lex sia sicuro che un intento soddisfi l'intento dell'utente. Intervalli compresi tra 0,00 e 1,00. I punteggi più alti indicano una maggiore confidenza.  
Tipo: double  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_IntentConfidence_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentConfidence) 

# IntentSummary
<a name="API_runtime_IntentSummary"></a>

Fornisce informazioni sullo stato di un intento. È possibile utilizzare queste informazioni per ottenere lo stato corrente di un intento in modo da poterlo elaborare o per riportare l'intento allo stato precedente.

## Indice
<a name="API_runtime_IntentSummary_Contents"></a>

 ** dialogActionType **   <a name="lex-Type-runtime_IntentSummary-dialogActionType"></a>
L'azione successiva che il bot deve intraprendere nell'interazione con l'utente. I valori possibili sono:  
+  `ConfirmIntent`- L'azione successiva è chiedere all'utente se l'intento è completo e pronto per essere realizzato. Questa è una domanda sì/no, ad esempio «Effettua l'ordine?»
+  `Close`- Indica che non ci sarà alcuna risposta da parte dell'utente. Ad esempio, l'affermazione «Il tuo ordine è stato effettuato» non richiede una risposta.
+  `ElicitIntent`- L'azione successiva consiste nel determinare l'intento che l'utente desidera soddisfare.
+  `ElicitSlot`- L'azione successiva consiste nel richiedere all'utente un valore di slot.
Tipo: stringa  
Valori validi: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Campo obbligatorio: sì

 ** checkpointLabel **   <a name="lex-Type-runtime_IntentSummary-checkpointLabel"></a>
Un'etichetta definita dall'utente che identifica un intento particolare. È possibile utilizzare questa etichetta per tornare a un intento precedente.   
Utilizzate il `checkpointLabelFilter` parametro dell'`GetSessionRequest`operazione per filtrare gli intenti restituiti dall'operazione in base a quelli con solo l'etichetta specificata.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[a-zA-Z0-9-]+`   
Campo obbligatorio: no

 ** confirmationStatus **   <a name="lex-Type-runtime_IntentSummary-confirmationStatus"></a>
Lo stato dell'intento dopo che l'utente ha risposto alla richiesta di conferma. Se l'utente conferma l'intento, Amazon Lex imposta questo campo su. `Confirmed` Se l'utente nega l'intenzione, Amazon Lex imposta questo valore su. `Denied` I valori possibili sono:  
+  `Confirmed`- L'utente ha risposto «Sì» alla richiesta di conferma, confermando che l'intento è completo e che è pronto per essere soddisfatto.
+  `Denied`- L'utente ha risposto «No» alla richiesta di conferma.
+  `None`- All'utente non è mai stata richiesta la conferma; oppure all'utente è stata richiesta ma non ha confermato o negato la richiesta.
Tipo: stringa  
Valori validi: `None | Confirmed | Denied`   
Campo obbligatorio: no

 ** fulfillmentState **   <a name="lex-Type-runtime_IntentSummary-fulfillmentState"></a>
Lo stato di adempimento dell'intento. I valori possibili sono:  
+  `Failed`- La funzione Lambda associata all'intento non è riuscita a soddisfare l'intento.
+  `Fulfilled`- L'intento è stato raggiunto dalla funzione Lambda associata all'intento. 
+  `ReadyForFulfillment`- Tutte le informazioni necessarie per l'intento sono presenti e l'intento è pronto per essere soddisfatto dall'applicazione client.
Tipo: stringa  
Valori validi: `Fulfilled | Failed | ReadyForFulfillment`   
Campo obbligatorio: no

 ** intentName **   <a name="lex-Type-runtime_IntentSummary-intentName"></a>
Il nome dell'intento.  
Tipo: string  
Campo obbligatorio: no

 ** slots **   <a name="lex-Type-runtime_IntentSummary-slots"></a>
Mappa degli slot che sono stati raccolti e dei relativi valori.   
Tipo: mappatura stringa a stringa  
Campo obbligatorio: no

 ** slotToElicit **   <a name="lex-Type-runtime_IntentSummary-slotToElicit"></a>
Lo slot successivo da richiedere all'utente. Se non c'è uno slot da ricercare, il campo è vuoto.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_IntentSummary_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentSummary) 

# PredictedIntent
<a name="API_runtime_PredictedIntent"></a>

Un intento suggerito da Amazon Lex soddisfa l'intento dell'utente. Include il nome dell'intento, la fiducia che Amazon Lex ha nel fatto che l'intento dell'utente sia soddisfatto e gli slot definiti per l'intento.

## Indice
<a name="API_runtime_PredictedIntent_Contents"></a>

 ** intentName **   <a name="lex-Type-runtime_PredictedIntent-intentName"></a>
Il nome dell'intento suggerito da Amazon Lex soddisfa l'intento dell'utente.  
Tipo: string  
Campo obbligatorio: no

 ** nluIntentConfidence **   <a name="lex-Type-runtime_PredictedIntent-nluIntentConfidence"></a>
Indica quanto Amazon Lex sia sicuro che un intento soddisfi l'intento dell'utente.  
Tipo: oggetto [IntentConfidence](API_runtime_IntentConfidence.md)  
Campo obbligatorio: no

 ** slots **   <a name="lex-Type-runtime_PredictedIntent-slots"></a>
Lo slot e i valori degli slot associati all'intento previsto.  
Tipo: mappatura stringa a stringa  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_PredictedIntent_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PredictedIntent) 

# ResponseCard
<a name="API_runtime_ResponseCard"></a>

Se configuri una scheda di risposta durante la creazione dei bot, Amazon Lex sostituisce gli attributi di sessione e i valori degli slot disponibili, quindi li restituisce. La scheda di risposta può anche provenire da una funzione Lambda (`dialogCodeHook`e `fulfillmentActivity` da un intento).

## Indice
<a name="API_runtime_ResponseCard_Contents"></a>

 ** contentType **   <a name="lex-Type-runtime_ResponseCard-contentType"></a>
Il tipo di contenuto della risposta.  
Tipo: stringa  
Valori validi: `application/vnd.amazonaws.card.generic`   
Campo obbligatorio: no

 ** genericAttachments **   <a name="lex-Type-runtime_ResponseCard-genericAttachments"></a>
Una serie di oggetti allegati che rappresentano opzioni.  
Tipo: matrice di oggetti [GenericAttachment](API_runtime_GenericAttachment.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.  
Campo obbligatorio: no

 ** version **   <a name="lex-Type-runtime_ResponseCard-version"></a>
La versione del formato della scheda di risposta.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_ResponseCard_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ResponseCard) 

# SentimentResponse
<a name="API_runtime_SentimentResponse"></a>

Il sentimento espresso in un enunciato.

Quando il bot è configurato per inviare enunciati ad Amazon Comprehend per l'analisi del sentiment, questa struttura di campo contiene il risultato dell'analisi.

## Indice
<a name="API_runtime_SentimentResponse_Contents"></a>

 ** sentimentLabel **   <a name="lex-Type-runtime_SentimentResponse-sentimentLabel"></a>
La valutazione dedotta in cui Amazon Comprehend ha la massima affidabilità.  
Tipo: string  
Campo obbligatorio: no

 ** sentimentScore **   <a name="lex-Type-runtime_SentimentResponse-sentimentScore"></a>
La probabilità che la valutazione sia stata dedotta correttamente.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_runtime_SentimentResponse_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/SentimentResponse)