지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단할 예정입니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 [Amazon Lex V2 가이드를](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

지정된 봇, 별칭 및 사용자 ID에 대한 세션 정보를 반환합니다.

## Request Syntax
<a name="API_runtime_GetSession_RequestSyntax"></a>

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

## URI 요청 파라미터
<a name="API_runtime_GetSession_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
세션 데이터를 포함하는 봇에 사용되는 별칭입니다.  
필수 항목 여부: 예

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
세션 데이터가 들어있는 봇의 명칭.  
필수 항목 여부: 예

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
`recentIntentSummaryView` 구조에서 반환된 의도를 필터링하는 데 사용되는 문자열입니다.  
필터를 지정하면 `checkpointLabel` 필드가 해당 문자열로 설정된 의도만 반환됩니다.  
길이 제약: 최소 길이는 1. 최대 길이는 255.  
패턴: `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
클라이언트 애플리케이션 사용자의 ID입니다. Amazon Lex는 이를 사용하여 사용자와 봇의 대화를 식별합니다.  
길이 제약: 최소 길이는 2. 최대 길이는 100.  
패턴: `[0-9a-zA-Z._:-]+`   
필수 여부: 예

## Request Body
<a name="API_runtime_GetSession_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<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"
}
```

## 응답 요소
<a name="API_runtime_GetSession_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
세션에 대해 활성화된 컨텍스트 목록. 의도가 이행될 때 또는 `PostContent`, `PostText`, 또는 `PutSession` 작업을 호출하여 컨텍스트를 설정할 수 있습니다.  
컨텍스트를 사용하여 의도를 추적할 수 있는 의도를 제어하거나 애플리케이션 작업을 수정할 수 있습니다.  
타입: [ActiveContext](API_runtime_ActiveContext.md)객체 배열  
배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
봇의 현재 상태를 설명합니다.  
유형: [DialogAction](API_runtime_DialogAction.md)객체

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
세션에서 사용된 의도에 대한 정보 배열. 배열에는 최대 세 개의 요약이 포함될 수 있습니다. 세션에서 세 개 이상의 의도를 사용하는 경우 `recentIntentSummaryView` 작업에는 마지막으로 사용한 세 개의 의도에 대한 정보가 포함됩니다.  
요청에서 `checkpointLabelFilter` 파라미터를 설정하는 경우 배열에는 지정된 레이블의 의도만 포함됩니다.  
타입: [IntentSummary](API_runtime_IntentSummary.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수는 3개.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
세션별 컨텍스트 정보를 나타내는 키/값 페어의 맵입니다. Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보를 포함합니다.  
유형: 문자열 간 맵

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
세션에 대한 고유 식별자입니다.  
유형: 문자열

## 오류
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 요청 검증이 실패했거나, 컨텍스트에 사용 가능한 메시지가 없거나, 봇 빌드가 실패했거나, 아직 진행 중이거나, 빌드되지 않은 변경 사항이 포함되어 있습니다.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 서비스 오류. 호출을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
제한 초과함.  
HTTP 상태 코드: 429

 ** NotFoundException **   
참조된 리소스(예: Amazon Lex 봇 또는 별칭)를 찾을 수 없습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_runtime_GetSession_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/GetSession) 
+  [AWS .NET V4용 SDK](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 Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS Python용 SDK](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)