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à.

# 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)