Pemberitahuan akhir dukungan: Pada 15 September 2025, AWS akan menghentikan dukungan untuk Amazon Lex V1. Setelah 15 September 2025, Anda tidak lagi dapat mengakses konsol Amazon Lex V1 atau sumber daya Amazon Lex V1. Jika Anda menggunakan Amazon Lex V2, lihat [panduan Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) sebagai gantinya. 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# GetSession
<a name="API_runtime_GetSession"></a>

Mengembalikan informasi sesi untuk bot tertentu, alias, dan ID pengguna.

## Minta Sintaks
<a name="API_runtime_GetSession_RequestSyntax"></a>

```
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
```

## Parameter Permintaan URI
<a name="API_runtime_GetSession_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
Alias yang digunakan untuk bot yang berisi data sesi.  
Wajib: Ya

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
Nama bot yang berisi data sesi.  
Wajib: Ya

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
String yang digunakan untuk memfilter maksud yang dikembalikan dalam `recentIntentSummaryView` struktur.   
Saat Anda menentukan filter, hanya maksud dengan `checkpointLabel` bidangnya disetel ke string itu yang dikembalikan.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
ID pengguna aplikasi klien. Amazon Lex menggunakan ini untuk mengidentifikasi percakapan pengguna dengan bot Anda.   
Kendala Panjang: Panjang minimum 2. Panjang maksimum 100.  
Pola: `[0-9a-zA-Z._:-]+`   
Wajib: Ya

## Isi Permintaan
<a name="API_runtime_GetSession_RequestBody"></a>

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<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"
}
```

## Elemen Respons
<a name="API_runtime_GetSession_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
Daftar konteks aktif untuk sesi tersebut. Konteks dapat diatur ketika maksud terpenuhi atau dengan memanggil`PostContent`,`PostText`, atau `PutSession` operasi.  
Anda dapat menggunakan konteks untuk mengontrol maksud yang dapat menindaklanjuti intent, atau untuk memodifikasi operasi aplikasi Anda.  
Tipe: Array objek [ActiveContext](API_runtime_ActiveContext.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 20 item.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
Menjelaskan keadaan bot saat ini.  
Tipe: Objek [DialogAction](API_runtime_DialogAction.md)

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
Array informasi tentang maksud yang digunakan dalam sesi. Array dapat berisi maksimal tiga ringkasan. Jika lebih dari tiga maksud digunakan dalam sesi, `recentIntentSummaryView` operasi berisi informasi tentang tiga maksud terakhir yang digunakan.  
Jika Anda mengatur `checkpointLabelFilter` parameter dalam permintaan, array hanya berisi maksud dengan label yang ditentukan.  
Tipe: Array objek [IntentSummary](API_runtime_IntentSummary.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 3 item.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
Peta key/value pasangan yang mewakili informasi konteks khusus sesi. Ini berisi informasi aplikasi yang diteruskan antara Amazon Lex dan aplikasi klien.  
Tipe: Peta string ke string

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
Pengenal unik untuk sesi tersebut.  
Tipe: String

## Kesalahan
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 Validasi permintaan gagal, tidak ada pesan yang dapat digunakan dalam konteks, atau pembuatan bot gagal, masih dalam proses, atau berisi perubahan yang belum dibangun.   
Kode Status HTTP: 400

 ** InternalFailureException **   
Kesalahan layanan internal. Coba lagi panggilannya.  
Kode Status HTTP: 500

 ** LimitExceededException **   
Melebihi batas.  
Kode Status HTTP: 429

 ** NotFoundException **   
Sumber daya (seperti bot Amazon Lex atau alias) yang disebut tidak ditemukan.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_runtime_GetSession_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GetSession)