지원 종료 공지: 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) 참조하세요.

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

# API 참조
<a name="API_Reference"></a>

이 단원에서는 Amazon Lex API 작업에 대한 설명서를 제공합니다. 현재 Amazon Lex 사용 가능한 모든 AWS 리전 목록은 *Amazon Web Services 일반 참조*의 [AWS 리전 및 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html#lex_region)를 참조하세요.

**주제**
+ [작업](API_Operations.md)
+ [데이터 타입](API_Types.md)

# 작업
<a name="API_Operations"></a>

다음 작업이 Amazon Lex 모델 구축 서비스에서 지원됩니다.
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

다음 작업이 Amazon Lex 런타임 서비스에서 지원됩니다.
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# Amazon Lex 모델 구축 서비스
<a name="API_Operations_Amazon_Lex_Model_Building_Service"></a>

다음 작업이 Amazon Lex 모델 구축 서비스에서 지원됩니다.
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

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

`$LATEST` 버전에 따라 새 버전의 봇을 생성합니다. 이 리소스의 `$LATEST` 버전이 마지막 버전 생성 후 변경되지 않은 경우 Amazon Lex는 새 버전을 생성하지 않고 마지막으로 생성된 버전을 반환합니다. 마지막으로 생성된 버전을 반환합니다.

**참고**  
`$LATEST` 버전의 봇만 업데이트할 수 있습니다. `CreateBotVersion` 작업을 통해 만든 번호가 매겨진 버전은 업데이트할 수 없습니다.

 봇의 첫 번째 버전을 지정할 때 Amazon Lex는 버전을 1로 설정합니다. 후속 버전은 1씩 증가합니다. 자세한 내용은 [버전 관리](versioning-aliases.md#versioning-intro)을 참조하세요.

 이 작업에는 `lex:CreateBotVersion` 작업에 대한 권한이 필요합니다.

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

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

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

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

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

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
새 버전을 생성하려는 봇의 이름. 이름은 대/소문자를 구분합니다.  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_CreateBotVersion_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
봇 `$LATEST` 버전의 특정 개정 버전을 식별합니다. 체크섬을 지정하였는데 봇 `$LATEST` 버전의 체크섬이 다른 경우 `PreconditionFailedException` 예외가 반환되고 Amazon Lex는 새 버전을 게시하지 않습니다. 체크섬을 지정하지 않으면 Amazon Lex에서 `$LATEST` 버전을 게시합니다.   
유형: 문자열  
필수사항: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
Amazon Lex에서 대화를 취소하는 데 사용하는 메시지입니다. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [Statement](API_Statement.md) 객체

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
생성된 봇의 버전을 식별하는 체크섬입니다.  
유형: 문자열

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Amazon Lex Model Building Service로 만든 각 Amazon Lex 봇에 대해, Amazon Lex 사용이, 전체 또는 일부가, 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부 및 어린이 온라인 개인정보 보호 법률(COPPA)을 준수하는지를 `childDirected` 필드의 `true` 또는 `false`를 지정하여 지정해야 합니다. `childDirected` 필드에 `true`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **있음**을 확인합니다. `childDirected` 필드에 `false`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **없음**을 확인합니다. 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부를 정확하게 반영하지 않는 `childDirected` 필드에 대한 기본값을 지정할 수 없습니다.  
Amazon Lex의 사용이 전체 또는 부분적으로 13세 미만 어린이를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 경우 COPPA에 따라 검증 가능한 필수 부모 동의를 얻어야 합니다. 전체 또는 일부를 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 Amazon Lex 사용에 관한 정보는 [Amazon Lex FAQ](https://aws.amazon.com/lex/faqs#data-security)를 참조하십시오.  
유형: Boolean

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
Amazon Lex가 사용자의 요청을 이해하지 못할 때 사용하는 메시지입니다. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [Prompt](API_Prompt.md) 객체

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
봇 버전이 생성된 날짜입니다.  
유형: 타임스탬프

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
봇에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
감정 분석을 위해 사용자가 입력한 표현을 Amazon Comprehend 로 전송해야 하는지 여부를 나타냅니다.  
유형: Boolean

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
봇이 정확도 개선을 사용하는지 여부를 나타냅니다. `true`은 봇이 개선 사항을 사용하고 있음을 나타내며, 그렇지 않으면, `false`입니다.  
유형: Boolean

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
만약 `status`이 `FAILED`라면, Amazon Lex는 봇 구축에 실패한 이유를 제공합니다.  
유형: 문자열

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
Amazon Lex가 대화에서 수집된 데이터를 유지하는 최대 시간(초) 입니다. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: 정수  
유효한 범위: 최소값은 60. 최대값은 86,400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
`Intent` 객체 어레이. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [Intent](API_Intent.md) 객체 배열

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
이 봇의 `$LATEST` 버전이 업데이트된 날짜.  
유형: 타임스탬프

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 봇의 타겟 로캘을 지정합니다.  
타입: 문자열  
유효 값: `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>
봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 봇을 만들거나 업데이트하라는 요청을 보내면 Amazon Lex는 `status` 응답 요소를 `BUILDING`로 설정합니다. Amazon Lex가 봇을 빌드한 후에는 `status`을 `READY`로 설정합니다. Amazon Lex가 봇을 빌드하지 못하는 경우에는 `status`을 `FAILED`로 설정합니다. Amazon Lex는 `failureReason` 응답 요소에 실패 이유를 반환합니다.  
타입: 문자열  
유효 값: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion) 

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

의도의 `$LATEST` 버전을 기반으로 의도의 새 버전을 생성합니다. 이 의도의 `$LATEST` 버전이 마지막 업데이트 이후 변경되지 않은 경우 Amazon Lex는 새 버전을 생성하지 않습니다. 마지막으로 생성된 버전을 반환합니다.

**참고**  
`$LATEST` 버전의 의도만 업데이트할 수 있습니다. `CreateIntentVersion` 작업을 통해 만든 번호가 매겨진 버전은 업데이트할 수 없습니다.

 의도 버전을 생성하면 Amazon Lex는 버전을 1로 설정합니다. 후속 버전은 1씩 증가합니다. 자세한 내용은 [버전 관리](versioning-aliases.md#versioning-intro)을 참조하세요.

이 작업에는 `lex:CreateIntentVersion` 조치를 수행할 권한이 요구됩니다.

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

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

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

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

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

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
새 버전을 생성하려는 봇의 버전. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_CreateIntentVersion_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
새 버전을 생성하는 데 사용해야 하는 의도 `$LATEST` 버전의 체크섬. 체크섬을 지정했는데 의도 `$LATEST` 버전의 체크섬이 다른 경우 Amazon Lex는 `PreconditionFailedException` 예외를 반환하고 새 버전을 게시하지 않습니다. 체크섬을 지정하지 않으면 Amazon Lex 에서 `$LATEST` 버전을 게시합니다.   
유형: 문자열  
필수사항: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
의도 버전의 체크섬 생성.  
유형: 문자열

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
`fulfillmentActivity` 필드에 지정된 Lambda 함수가 의도를 이행한 후 Amazon Lex는 이 명령문을 사용자에게 전달합니다.  
유형: [Statement](API_Statement.md)객체

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
의도에 정의된 경우 Amazon Lex는 사용자에게 의도를 이행하기 전에 의도를 확인하라는 메시지를 표시합니다.  
유형: [Prompt](API_Prompt.md)객체

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
의도가 생성된 날짜입니다.  
유형: 타임스탬프

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
의도에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
정의된 경우 Amazon Lex는 각 사용자 입력에 대해 이 Lambda 함수를 호출합니다.  
유형: [CodeHook](API_CodeHook.md)객체

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
정의된 경우 Amazon Lex는 이 프롬프트를 사용하여 의도가 이행된 후 추가 사용자 활동을 요청합니다.  
유형: [FollowUpPrompt](API_FollowUpPrompt.md)객체

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 의도가 이행되는 방법을 설명합니다.  
유형: [FulfillmentActivity](API_FulfillmentActivity.md)객체

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는 `InputContext` 객체 배열입니다.  
타입: [InputContext](API_InputContext.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 5개.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Amazon Kendra 인덱스를 `AMAZON.KendraSearchIntent` 의도와 연결하기 위한 구성 정보(있는 경우)입니다.  
유형: [KendraConfiguration](API_KendraConfiguration.md)객체

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
의도가 업데이트된 날짜.  
유형: 타임스탬프

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
의도의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
의도가 이행될 때 의도가 활성화하는 컨텍스트를 목록화하는 `OutputContext` 객체의 배열입니다.  
타입: [OutputContext](API_OutputContext.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
기본 제공 의도의 고유 식별자입니다.  
유형: 문자열

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
사용자가 `confirmationPrompt`에 정의된 질문에 "아니요"라고 답하면 Amazon Lex는 의도가 취소되었음을 확인하기 위해 이 문장으로 답합니다.  
유형: [Statement](API_Statement.md)객체

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
의도에 대해 구성된 샘플 표현 배열.  
유형: 문자열 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 1,500개.  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200입니다.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
의도를 충족하는 데 필요한 정보를 정의하는 다양한 슬롯 유형.  
타입: [Slot](API_Slot.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수는 100개.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
새 버전의 의도에 할당된 버전 번호입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion) 

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

지정된 슬롯 유형의 `$LATEST` 버전을 기반으로 새 버전을 생성합니다. 이 리소스의 `$LATEST` 버전이 생성된 마지막 버전 이후 변경되지 않은 경우 Amazon Lex는 새 버전을 생성하지 않습니다. 마지막으로 생성된 버전을 반환합니다.

**참고**  
슬롯 유형의 `$LATEST` 버전만 업데이트할 수 있습니다. `CreateSlotTypeVersion` 작업을 통해 만든 번호가 매겨진 버전은 업데이트할 수 없습니다.

의도 버전을 생성하면 Amazon Lex는 버전을 1로 설정합니다. 후속 버전은 1씩 증가합니다. 자세한 내용은 [버전 관리](versioning-aliases.md#versioning-intro)을 참조하세요.

이 작업에는 `lex:CreateSlotTypeVersion` 액션에 대한 권한이 필요합니다.

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

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

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

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

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

 ** [name](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-uri-name"></a>
새 버전을 생성하려는 슬롯 유형의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_CreateSlotTypeVersion_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [checksum](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-checksum"></a>
게시하려는 슬롯 유형 `$LATEST` 버전의 체크섬. 체크섬을 지정했는데 슬롯 유형 `$LATEST` 버전의 체크섬이 다른 경우 Amazon Lex는 `PreconditionFailedException` 예외를 반환하고 새 버전을 게시하지 않습니다. 체크섬을 지정하지 않으면 Amazon Lex 에서 `$LATEST` 버전을 게시합니다.   
유형: 문자열  
필수사항: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [checksum](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-checksum"></a>
슬롯 유형의 `$LATEST` 버전의 체크섬.  
유형: 문자열

 ** [createdDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-createdDate"></a>
슬롯 유형이 생성된 날짜.  
유형: 타임스탬프

 ** [description](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [enumerationValues](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-enumerationValues"></a>
슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록.  
타입: [EnumerationValue](API_EnumerationValue.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개.

 ** [lastUpdatedDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-lastUpdatedDate"></a>
슬롯 유형이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-name"></a>
슬롯 유형의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-parentSlotTypeSignature"></a>
기본 제공 슬롯 유형은 슬롯 유형의 상위 유형을 사용했습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-slotTypeConfigurations"></a>
상위 기본 제공 슬롯 유형을 확장하는 구성 정보.  
타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [valueSelectionStrategy](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-valueSelectionStrategy"></a>
Amazon Lex가 슬롯 값을 결정하는 데 사용하는 전략입니다. 자세한 내용은 [PutSlotType](API_PutSlotType.md)을 참조하세요.  
타입: 문자열  
유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-version"></a>
새 슬롯 유형 버전에 할당된 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateSlotTypeVersion) 

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

`$LATEST` 버전을 포함한 모든 버전의 봇을 삭제합니다. 특정 버전의 봇을 삭제하려면 [DeleteBotVersion](API_DeleteBotVersion.md) 작업을 사용하세요. `DeleteBot` 작업을 수행해도 봇 스키마가 즉시 제거되지는 않습니다. 대신 삭제 표시되고 나중에 제거됩니다.

Amazon Lex는 사용자 입력에 응답하는 봇의 능력을 향상시키기 위해 표현을 무기한 저장합니다. 봇이 삭제되어도 이러한 표현은 제거되지 않습니다. 표현을 삭제하려면 [DeleteUtterances](API_DeleteUtterances.md) 작업을 사용하십시오.

봇에 별칭이 있으면 삭제할 수 없습니다. 대신 `DeleteBot` 작업은 봇을 참조하는 별칭에 대한 참조가 포함된 `ResourceInUseException` 예외를 반환합니다. 봇에 대한 참조를 제거하려면 별칭을 삭제하십시오. 동일한 예외가 다시 발생하는 경우 `DeleteBot` 작업이 성공할 때까지 참조 별칭을 삭제하십시오.

이 작업에는 `lex:DeleteBot` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [name](#API_DeleteBot_RequestSyntax) **   <a name="lex-DeleteBot-request-uri-name"></a>
봇의 이름. 이름은 대/소문자를 구분합니다.  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteBot_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteBot_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBot) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBot) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBot) 

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

지정된 봇의 별칭을 삭제합니다.

봇과 메시징 채널 간의 연결에 사용되는 별칭은 삭제할 수 없습니다. 별칭이 채널 연결에 사용되는 경우 `DeleteBot` 작업은 봇을 참조하는 채널 연결에 대한 참조를 포함하는 `ResourceInUseException` 예외를 반환합니다. 채널 연결을 삭제하여 별칭에 대한 참조를 제거할 수 있습니다. 동일한 예외가 다시 발생하면 `DeleteBotAlias` 작업이 성공할 때까지 참조 연결을 삭제하세요.

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

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

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

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

 ** [botName](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-botName"></a>
별칭이 가리키는 봇의 이름.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [name](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-name"></a>
삭제할 별칭의 이름 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteBotAlias_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotAlias) 

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

Amazon Lex 봇과 메시징 플랫폼 간의 연결을 삭제합니다.

이 작업에는 `lex:DeleteBotChannelAssociation` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [aliasName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botAlias"></a>
이 연결이 이루어지는 Amazon Lex 봇의 특정 버전을 가리키는 별칭입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [botName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botName"></a>
Amazon Lex 봇의 이름.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [name](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-name"></a>
연결의 이름입니다. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteBotChannelAssociation_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 

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

봇의 특정 버전을 삭제합니다. 봇의 모든 버전을 삭제하려면 [DeleteBot](API_DeleteBot.md) 작업을 사용하세요.

이 작업에는 `lex:DeleteBotVersion` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [name](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-name"></a>
봇의 이름.  
길이 제약: 최소 길이 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [version](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-version"></a>
삭제할 봇의 버전. 슬롯 유형의 `$LATEST` 버전은 삭제할 수 없습니다. `$LATEST` 버전을 삭제하려면 [DeleteBot](API_DeleteBot.md) 작업을 사용하십시오.  
길이 제약: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteBotVersion_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotVersion) 

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

`$LATEST` 버전을 포함한 모든 버전의 의도를 삭제합니다. 특정 버전의 의도를 삭제하려면 [DeleteIntentVersion](API_DeleteIntentVersion.md) 작업을 사용하세요.

 참조하지 않는 의도 버전을 삭제할 수 있습니다. 하나 이상의 봇에서 참조되는 의도를 삭제하려면([Amazon Lex: 작동 방식](how-it-works.md) 참조) 먼저 해당 참조를 제거해야 합니다.

**참고**  
 `ResourceInUseException` 예외가 발생하면 의도가 참조된 위치를 보여주는 예제 참조가 제공됩니다. 의도에 대한 참조를 제거하려면 봇을 업데이트하거나 삭제하세요. 의도를 다시 삭제하려고 시도했을 때 같은 예외가 발생하는 경우, 의도에 참조가 없어지고 `DeleteIntent` 호출이 성공할 때까지 반복하세요.

 이 작업에는 `lex:DeleteIntent` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [name](#API_DeleteIntent_RequestSyntax) **   <a name="lex-DeleteIntent-request-uri-name"></a>
의도의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteIntent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteIntent_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntent) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntent) 

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

의도의 특정 버전을 삭제합니다. 의도의 모든 버전을 삭제하려면 [DeleteIntent](API_DeleteIntent.md) 작업을 사용하세요.

이 작업에는 `lex:DeleteIntentVersion` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [name](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-name"></a>
의도의 이름.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [version](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-version"></a>
삭제할 의도의 버전. 슬롯 유형의 `$LATEST` 버전은 삭제할 수 없습니다. `$LATEST` 버전을 삭제하려면 [DeleteIntent](API_DeleteIntent.md) 작업을 사용하십시오.  
길이 제약: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteIntentVersion_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntentVersion) 

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

`$LATEST` 버전을 포함한 모든 버전의 슬롯을 삭제합니다. 특정 버전의 봇을 삭제하려면 [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 작업을 사용하세요.

 참조하지 않는 슬롯 유형 버전을 삭제할 수 있습니다. 하나 이상의 의도에서 참조되는 슬롯 유형을 삭제하려면 먼저 해당 참조를 제거해야 합니다.

**참고**  
 `ResourceInUseException` 예외가 발생하면 슬롯 유형이 참조된 위치를 보여주는 예제 참조가 제공됩니다. 슬롯 유형에 대한 참조를 제거하려면 의도를 업데이트하거나 삭제하세요. 슬롯 유형을 다시 삭제하려고 할 때 동일한 예외가 발생하면 슬롯 유형에 참조가 없어 `DeleteSlotType` 호출이 성공할 때까지 반복하십시오.

이 작업에는 `lex:DeleteSlotType` 작업에 대한 권한이 필요합니다.

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

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

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

다음의 URI 파라미터를 사용하여 요청합니다.

 ** [name](#API_DeleteSlotType_RequestSyntax) **   <a name="lex-DeleteSlotType-request-uri-name"></a>
슬롯 유형의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteSlotType_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteSlotType_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotType) 

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

슬롯 유형의 특정 버전을 삭제합니다. 슬롯 유형의 모든 버전을 삭제하려면 [DeleteSlotType](API_DeleteSlotType.md) 작업을 사용하세요.

이 작업에는 `lex:DeleteSlotTypeVersion` 액션에 대한 권한이 필요합니다.

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

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

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

다음의 URI 파라미터를 사용하여 요청합니다.

 ** [name](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-name"></a>
슬롯 유형의 이름입니다.  
길이 제한: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [version](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-version"></a>
삭제할 슬롯 유형의 버전입니다. 슬롯 유형의 `$LATEST` 버전은 삭제할 수 없습니다. `$LATEST`버전을 삭제하려면 [DeleteSlotType](API_DeleteSlotType.md) 작업을 사용하십시오.  
길이 제약: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_DeleteSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteSlotTypeVersion_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

 ** ResourceInUseException **   
삭제하려는 리소스가 다른 리소스에서 참조되고 있습니다. 이 정보를 사용하여 삭제하려는 리소스에 대한 참조를 제거할 수 있습니다.  
예외 본문은 리소스를 설명하는 JSON 객체를 포함하고 있습니다.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 

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

저장된 표현을 삭제합니다.

Amazon Lex는 사용자가 봇에 보내는 표현을 저장합니다. 표현은 [GetUtterancesView](API_GetUtterancesView.md) 작업에 사용하기 위해 15일 동안 저장되며, 이후에는 봇이 사용자 입력에 응답하는 기능을 개선하는 데 사용하기 위해 무기한 저장됩니다.

특정 사용자의 저장된 표현을 삭제하려면 `DeleteUtterances` 작업을 사용하십시오. `DeleteUtterances` 작업을 사용하면 봇이 사용자 입력에 응답하는 능력을 향상시키기 위해 저장된 표현은 즉시 삭제됩니다. `GetUtterancesView` 작업에 사용하기 위해 저장된 표현은 15일 후에 삭제됩니다.

이 작업에는 `lex:DeleteUtterances` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
표현을 저장한 봇의 이름입니다.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 표현을 수행한 사용자의 고유 식별자입니다. 표현이 포함된 [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) 또는 [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) 작업 요청에서 전송된 사용자 ID입니다.  
길이 제약: 최소 길이는 2. 최대 길이는 100.  
필수 항목 여부: 예

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

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

## Response Syntax
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteUtterances_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances) 

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

특정 봇에 대한 메타데이터를 반환합니다. 봇 이름 및 봇 버전 또는 별칭도 제공해야 합니다.

 이 작업에는 `lex:GetBot` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
봇의 이름. 이름은 대/소문자를 구분합니다.  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [versionoralias](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
봇의 버전 또는 별칭입니다.  
필수 항목 여부: 예

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

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

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

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

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

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

 ** [abortStatement](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-abortStatement"></a>
사용자가 대화를 완료하지 않고 종료하기로 선택할 때 Amazon Lex가 반환하는 메시지입니다. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [Statement](API_Statement.md)객체

 ** [checksum](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-checksum"></a>
봇의 `$LATEST` 버전의 특정 버전을 식별하는 데 사용되는 봇의 체크섬입니다.  
유형: 문자열

 ** [childDirected](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-childDirected"></a>
Amazon Lex Model Building Service로 만든 각 Amazon Lex 봇에 대해, Amazon Lex 사용이, 전체 또는 일부가, 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부 및 어린이 온라인 개인정보 보호 법률(COPPA)을 준수하는지를 `childDirected` 필드의 `true` 또는 `false`를 지정하여 지정해야 합니다. `childDirected` 필드에 `true`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **있음**을 확인합니다. `childDirected` 필드에 `false`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **없음**을 확인합니다. 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부를 정확하게 반영하지 않는 `childDirected` 필드에 대한 기본값을 지정할 수 없습니다.  
Amazon Lex의 사용이 전체 또는 부분적으로 13세 미만 어린이를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 경우 COPPA에 따라 검증 가능한 필수 부모 동의를 얻어야 합니다. 전체 또는 일부를 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 Amazon Lex 사용에 관한 정보는 [Amazon Lex FAQ](https://aws.amazon.com/lex/faqs#data-security)를 참조하십시오.  
유형: Boolean

 ** [clarificationPrompt](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
Amazon Lex가 사용자의 요청을 이해하지 못할 때 사용하는 메시지입니다. 자세한 내용은 [PutBot](API_PutBot.md) 단원을 참조하십시오.  
유형: [Prompt](API_Prompt.md)객체

 ** [createdDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-createdDate"></a>
봇이 생성된 날짜.  
유형: 타임스탬프

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
봇에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
감정 분석을 위해 사용자가 입력한 표현을 Amazon Comprehend로 전송해야 하는지 여부를 나타냅니다.  
유형: Boolean

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
봇이 정확도 개선을 사용하는지 여부를 나타냅니다. `true`은 봇이 개선 사항을 사용하고 있음을 나타내며, 그렇지 않으면, `false`입니다.  
유형: Boolean

 ** [failureReason](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-failureReason"></a>
`status`이 `FAILED`인 경우, Amazon Lex가 봇 구축에 실패한 이유를 설명합니다.  
유형: 문자열

 ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
Amazon Lex가 대화에서 수집된 데이터를 유지하는 최대 시간(초) 입니다. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: 정수  
유효한 범위: 최소값은 60. 최대값은 86,400.

 ** [intents](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-intents"></a>
`intent` 객체 어레이. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [Intent](API_Intent.md) 객체 배열

 ** [lastUpdatedDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-lastUpdatedDate"></a>
봇이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [locale](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-locale"></a>
 봇의 타겟 로캘입니다.  
타입: 문자열  
유효 값: `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>
봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
[PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) 또는 [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) 응답에서 대체 의도를 반환할 때 Amazon Lex가 `AMAZON.FallbackIntent`, `AMAZON.KendraSearchIntent` 또는 둘 다를 삽입하는 위치를 결정하는 점수입니다. `AMAZON.FallbackIntent`는 모든 의도에 대한 신뢰도 점수가 이 값보다 낮은 경우 삽입됩니다. `AMAZON.KendraSearchIntent`은 봇에 대해 구성된 경우에만 삽입됩니다.  
유형: 더블  
유효한 범위: 최소값 0. 최댓값은 1.

 ** [status](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-status"></a>
봇의 상태.  
상태가 `BUILDING`인 경우 Amazon Lex는 테스트 및 사용을 위해 봇을 구축하고 있습니다.  
봇 상태가 `READY_BASIC_TESTING`인 경우 봇의 의도에 지정된 정확한 표현을 사용하여 봇을 테스트할 수 있습니다. 봇을 완전히 테스트하거나 실행할 준비가 되면 상태는 `READY`입니다.  
봇을 구축하는 데 문제가 있는 경우 상태는 `FAILED`이며 `failureReason` 필드에는 봇이 빌드되지 않은 이유가 설명되어 있습니다.  
봇이 저장되었지만 빌드되지 않은 경우 상태는 `NOT_BUILT`입니다.  
타입: 문자열  
유효 값: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-version"></a>
봇의 버전. 새 봇의 경우 버전은 항상 `$LATEST`입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-voiceId"></a>
Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다. 자세한 내용은 [PutBot](API_PutBot.md) 단원을 참조하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBot) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot) 

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

Amazon Lex 봇 별칭에 대한 정보를 반환합니다. 별칭에 대한 자세한 내용은 [버전 관리 및 별칭](versioning-aliases.md)을 참조하십시오.

이 작업에는 `lex:GetBotAlias` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [botName](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-botName"></a>
봇의 이름.  
길이 제약: 최소 길이 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [name](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-name"></a>
봇 별칭의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

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

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

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

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

 ** [botName](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botName"></a>
별칭이 가리키는 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botVersion"></a>
별칭이 가리키는 봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [checksum](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-checksum"></a>
봇 별칭의 체크섬입니다.  
유형: 문자열

 ** [conversationLogs](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-conversationLogs"></a>
Amazon Lex가 별칭에 대한 대화 로그를 사용하는 방법을 결정하는 설정입니다.  
유형: [ConversationLogsResponse](API_ConversationLogsResponse.md)객체

 ** [createdDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-createdDate"></a>
봇이 별칭이 생성된 날짜.  
유형: 타임스탬프

 ** [description](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-description"></a>
별칭에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [lastUpdatedDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-lastUpdatedDate"></a>
봇 별칭이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-name"></a>
봇 별칭의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAlias) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAlias) 

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

지정된 Amazon Lex 봇에 대한 별칭 목록을 반환합니다.

이 작업에는 `lex:GetBotAliases` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [botName](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-botName"></a>
봇의 이름.  
길이 제약: 최소 길이 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [maxResults](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-maxResults"></a>
응답에 반환될 최대 별칭 수입니다. 기본 값은 50.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nameContains](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nameContains"></a>
봇 별칭 이름에서 일치시킬 하위 문자열. 이름 중 일부가 하위 문자열과 일치하면 별칭이 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nextToken"></a>
별칭의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 별칭의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [BotAliases](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-BotAliases"></a>
각각 봇 별칭을 설명하는 `BotAliasMetadata` 객체 배열.  
타입: [BotAliasMetadata](API_BotAliasMetadata.md)객체 배열

 ** [nextToken](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-nextToken"></a>
별칭의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 별칭의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetBotAliases_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAliases) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAliases) 

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

Amazon Lex 봇과 메시징 플랫폼 간의 연결에 대한 정보를 반환합니다.

이 작업에는 `lex:GetBotChannelAssociation` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
이 연결이 이루어지는 Amazon Lex 봇의 특정 버전을 가리키는 별칭입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
Amazon Lex 봇의 이름.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
봇과 채널 간의 연결 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

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

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

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

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

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

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
이 연결이 이루어지는 Amazon Lex 봇의 특정 버전을 가리키는 별칭입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
메시징 플랫폼이 Amazon Lex 봇과 통신하는 데 필요한 정보를 제공합니다.  
유형: 문자열 간 맵  
맵 항목: 최대 항목 수는 10개.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
Amazon Lex 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
봇과 채널 간의 연결이 생성된 날짜입니다.  
유형: 타임스탬프

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
봇과 채널 간의 연결에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
만약 `status`이 `FAILED`라면, Amazon Lex는 봇 구축에 실패한 이유를 제공합니다.  
유형: 문자열

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
봇과 채널 간의 연결 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
봇 채널의 상태입니다.  
+  `CREATED` - 채널이 생성되어 사용할 준비가 되었습니다.
+  `IN_PROGRESS` - 채널 생성이 진행 중입니다.
+  `FAILED` - 채널을 만드는 중 오류가 발생했습니다. 필드에 대한 자세한 내용은 `failureReason` 필드를 참조하세요.
타입: 문자열  
유효 값: `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
메시징 플랫폼 유형.  
타입: 문자열  
유효 값: `Facebook | Slack | Twilio-Sms | Kik` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation) 

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

 지정된 봇과 연결된 모든 채널의 목록을 반환합니다.

`GetBotChannelAssociations` 작업에는 `lex:GetBotChannelAssociations` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
이 연결이 이루어지는 Amazon Lex 봇의 특정 버전을 가리키는 별칭입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^(-|^([A-Za-z]_?)+$)$`   
필수 여부: 예

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
연결에 있는 Amazon Lex 봇의 이름.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
응답에 반환될 최대 연결 수입니다. 기본값은 50.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
채널 연결 이름과 일치하는 하위 문자열. 이름 중 일부가 하위 문자열과 일치하면 별칭이 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다. 모든 봇 채널 연결을 반환하려면 하이픈("-")을 `nameContains` 파라미터로 사용하십시오.  
길이 제약: 최소 길이 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
연결의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 연결의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Amazon Lex 봇 및 채널과의 연결에 대한 정보를 제공하는 객체 배열(각 연결마다 하나씩)입니다.  
타입: [BotChannelAssociation](API_BotChannelAssociation.md)객체 배열

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
연결의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 연결의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations) 

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

다음과 같이 봇 정보를 반환합니다.
+ `nameContains` 필드를 제공하는 경우 응답에는 이름에 지정된 문자열이 포함된 모든 봇의 `$LATEST` 버전에 대한 정보가 포함됩니다.
+ `nameContains` 필드를 지정하지 않으면 작업은 모든 봇의 `$LATEST` 버전에 대한 정보를 반환합니다.

이 작업에는 `lex:GetBots` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
요청이 반환할 응답으로 반환할 최대 봇 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nameContains](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
봇 이름에서 일치하는 하위 문자열. 이름 중 일부가 하위 문자열과 일치하면 별칭이 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
봇의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 봇의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
각 봇에 한 개의 항목이 있는 `botMetadata` 객체 배열.  
타입: [BotMetadata](API_BotMetadata.md)객체 배열

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
응답이 잘린 경우 다음 요청 시 봇의 다음 페이지를 가져오도록 지정할 수 있는 페이지 매김 토큰이 포함됩니다.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBots) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots) 

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

봇의 모든 버전에 대한 정보를 가져옵니다.

이 `GetBotVersions` 작업은 봇의 각 버전에 대한 `BotMetadata` 객체를 반환합니다. 예를 들어 봇에 번호가 매겨진 버전이 3개 있는 경우, `GetBotVersions` 작업은 번호가 매겨진 버전마다 하나씩 및 `$LATEST` 버전에 한 개, 총 4개의 `BotMetadata` 객체를 응답으로 반환합니다.

`GetBotVersions` 작업은 항상 하나 이상의 버전, 즉 `$LATEST` 버전을 반환합니다.

이 작업에는 `lex:GetBotVersions` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-maxResults"></a>
응답으로 반환할 최대 봇 버전 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [name](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-name"></a>
버전을 반환해야 할 봇의 이름  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [nextToken](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-nextToken"></a>
봇 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [bots](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-bots"></a>
번호가 매겨진 각 버전의 봇에 대해 하나씩 및 `$LATEST` 버전에 대한 하나에 해당하는 `BotMetadata` 객체 배열입니다.  
타입: [BotMetadata](API_BotMetadata.md)객체 배열

 ** [nextToken](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-nextToken"></a>
봇 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotVersions) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotVersions) 

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

기본 제공 의도에 관한 정보를 반환합니다.

이 작업에는 `lex:GetBuiltinIntent` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [signature](#API_GetBuiltinIntent_RequestSyntax) **   <a name="lex-GetBuiltinIntent-request-uri-signature"></a>
기본 제공 의도의 고유 식별자입니다. 의도의 서명을 찾으려면 *Alexa Skills Kit*의 [표준 기본 제공 의도](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents)를 참조하십시오.  
필수 항목 여부: 예

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

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

## Response Syntax
<a name="API_GetBuiltinIntent_ResponseSyntax"></a>

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

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

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

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

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

 ** [signature](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-signature"></a>
기본 제공 의도의 고유 식별자입니다.  
유형: 문자열

 ** [slots](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-slots"></a>
의도의 각 슬롯 유형당 하나의 항목으로 구성된 `BuiltinIntentSlot` 객체 배열.  
타입: [BuiltinIntentSlot](API_BuiltinIntentSlot.md)객체 배열

 ** [supportedLocales](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-supportedLocales"></a>
의도가 지원하는 로캘의 목록입니다.  
유형: 문자열 배열  
유효한 값: `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` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntent) 

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

지정된 기준에 맞는 기본 제공 의도의 목록을 가져옵니다.

이 작업에는 `lex:GetBuiltinIntents` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [locale](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-locale"></a>
의도가 지원하는 로캘의 목록입니다.  
유효한 값: `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>
응답에 반환되는 최대 의도 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nextToken](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-nextToken"></a>
의도의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

 ** [signatureContains](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-signatureContains"></a>
기본 제공 의도 서명과 일치하는 하위 문자열. 서명의 일부가 하위 문자열과 일치하면 의도가 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다. 의도의 서명을 찾으려면 *Alexa Skills Ki*t의 [표준 기본 제공 의도](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents)를 참조하십시오.

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

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

## Response Syntax
<a name="API_GetBuiltinIntents_ResponseSyntax"></a>

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

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

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

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

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

 ** [intents](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-intents"></a>
응답의 각 의도에 대해 하나씩 있는 `builtinIntentMetadata` 객체의 배열입니다.  
타입: [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md)객체 배열

 ** [nextToken](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-nextToken"></a>
의도의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetBuiltinIntents_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntents) 

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

지정된 기준에 맞는 기본 제공 슬롯 유형을 가져옵니다.

사용 가능한 기본 제공 슬롯 유형의 목록은 *Alexa Skills Kit*의 [슬롯 유형 참고 자료](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)를 참조하십시오.

이 작업에는 `lex:GetBuiltInSlotTypes` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [locale](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-locale"></a>
슬롯 유형이 지원하는 로캘의 목록입니다.  
유효한 값: `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>
응답에 반환되는 최대 슬롯 유형 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nextToken](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-nextToken"></a>
슬롯 유형의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

 ** [signatureContains](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-signatureContains"></a>
기본 제공 슬롯 유형 서명과 일치하는 하위 문자열. 서명의 일부가 하위 문자열과 일치하면 슬롯 유형이 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다.

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

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

## Response Syntax
<a name="API_GetBuiltinSlotTypes_ResponseSyntax"></a>

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

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

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

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

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

 ** [nextToken](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-nextToken"></a>
응답이 잘린 경우 다음 요청에서 슬롯 유형의 다음 페이지를 가져오는 데 사용할 수 있는 페이지 매김 토큰이 응답에 포함됩니다.  
유형: 문자열

 ** [slotTypes](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-slotTypes"></a>
의도의 각 슬롯 유형당 하나의 항목으로 구성된 `BuiltInSlotTypeMetadata` 객체 배열.  
타입: [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 객체 배열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetBuiltinSlotTypes_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 

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

Amazon Lex 리소스의 콘텐츠를 지정된 형식으로 내보냅니다.

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

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

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

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

 ** [exportType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-exportType"></a>
내보내진 데이터의 형식입니다.  
유효한 값: `ALEXA_SKILLS_KIT | LEX`   
필수 사항 여부: 예

 ** [name](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-name"></a>
내보낼 봇의 이름.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z_]+`   
필수 여부: 예

 ** [resourceType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-resourceType"></a>
내보내기 할 리소스의 유형.  
유효한 값: `BOT | INTENT | SLOT_TYPE`   
필수 사항 여부: 예

 ** [version](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-version"></a>
내보낼 봇의 버전.  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+`   
필수 여부: 예

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

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

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

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

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

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

 ** [exportStatus](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportStatus"></a>
내보내기 작업 상태를 가져옵니다.  
+  `IN_PROGRESS` - 내보내기가 진행 중입니다.
+  `READY` - 내보내기가 완료되었습니다.
+  `FAILED` - 내보내기를 완료할 수 없습니다.
타입: 문자열  
유효 값: `IN_PROGRESS | READY | FAILED` 

 ** [exportType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportType"></a>
내보내진 데이터의 형식입니다.  
타입: 문자열  
유효 값: `ALEXA_SKILLS_KIT | LEX` 

 ** [failureReason](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-failureReason"></a>
만약 `status`이 `FAILED`라면, Amazon Lex는 리소스 내보내기에 실패한 이유를 제공합니다.  
유형: 문자열

 ** [name](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-name"></a>
내보내진 봇의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-resourceType"></a>
내보내진 리소스의 유형.  
타입: 문자열  
유효 값: `BOT | INTENT | SLOT_TYPE` 

 ** [url](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-url"></a>
내보낸 리소스의 위치를 제공하는 S3 미리 서명된 URL입니다. 내보내기의 리소스는 내보내진 리소스가 JSON 형식으로 포함된 ZIP 아카이브 파일입니다. 아카이브 구조는 변경될 수 있습니다. 코드는 아카이브 구조에 의존해서는 안 됩니다.  
유형: 문자열

 ** [version](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-version"></a>
내보내진 봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetExport) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetExport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetExport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetExport) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetExport) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetExport) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetExport) 

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

`StartImport` 작업으로 시작된 가져오기 작업에 대한 정보를 가져옵니다.

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

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

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

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

 ** [importId](#API_GetImport_RequestSyntax) **   <a name="lex-GetImport-request-uri-importId"></a>
반환할 가져오기 작업 정보의 식별자입니다.  
필수 항목 여부: 예

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

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

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

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

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

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

 ** [createdDate](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-createdDate"></a>
가져오기 작업이 생성된 날짜와 시간에 대한 타임스탬프입니다.  
유형: 타임스탬프

 ** [failureReason](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-failureReason"></a>
가져오기 작업이 완료되지 못한 이유를 설명하는 문자열입니다.  
유형: 문자열 배열

 ** [importId](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importId"></a>
특정 가져오기 작업의 식별자입니다.  
유형: 문자열

 ** [importStatus](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importStatus"></a>
가져오기 작업의 상태입니다. 상태가 `FAILED` 인 경우, `failureReason` 필드로부터 실패 원인을 얻을 수 있습니다.  
타입: 문자열  
유효 값: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-mergeStrategy"></a>
기존 리소스와 가져오기 파일의 리소스 간에 충돌이 있을 때 취해진 작업입니다.  
타입: 문자열  
유효 값: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-name"></a>
가져오기 작업의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-resourceType"></a>
가져올 리소스의 유형.  
타입: 문자열  
유효 값: `BOT | INTENT | SLOT_TYPE` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetImport) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetImport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetImport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetImport) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetImport) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetImport) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetImport) 

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

 의도에 대한 정보를 반환합니다. 의도 이름 뿐만 아니라 의도 버전 또한 지정해야 합니다.

 이 작업에는 `lex:GetIntent` 조치를 수행할 권한이 요구됩니다.

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

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

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

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

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
의도의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
의도의 버전.  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 예

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

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

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

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

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

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

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
의도의 체크섬입니다.  
유형: 문자열

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
`fulfillmentActivity` 요소에 지정된 Lambda 함수가 의도를 이행한 후, Amazon Lex는 이 명령문을 사용자에게 전달합니다.  
유형: [Statement](API_Statement.md)객체

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
봇에 정의된 경우 Amazon Lex는 사용자의 요청을 이행하기 전에 의도를 확인하기 위해 프롬프르틑 사용합니다. 자세한 내용은 [PutIntent](API_PutIntent.md)을 참조하세요.  
유형: [Prompt](API_Prompt.md)객체

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
의도가 생성된 날짜입니다.  
유형: 타임스탬프

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
의도에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
봇이 정의된 경우 Amazon Lex는 각 사용자 입력에 대해 이 Lambda 함수를 호출합니다. 자세한 내용은 [PutIntent](API_PutIntent.md) 단원을 참조하십시오.  
유형: [CodeHook](API_CodeHook.md)객체

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
의도에 정의된 경우 Amazon Lex는 이 프롬프트를 사용하여 의도가 충족된 후 추가 사용자 활동을 요청합니다. 자세한 내용은 [PutIntent](API_PutIntent.md) 단원을 참조하십시오.  
유형: [FollowUpPrompt](API_FollowUpPrompt.md)객체

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
의도가 이행되는 방식을 설명합니다. 자세한 내용은 [PutIntent](API_PutIntent.md) 단원을 참조하십시오.  
유형: [FulfillmentActivity](API_FulfillmentActivity.md)객체

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는 `InputContext` 객체 배열입니다.  
타입: [InputContext](API_InputContext.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 5개.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Amazon Kendra 인덱스를 `AMAZON.KendraSearchIntent` 의도와 연결하기 위한 구성 정보(있는 경우)입니다.  
유형: [KendraConfiguration](API_KendraConfiguration.md)객체

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
의도가 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
의도의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
의도가 이행될 때 의도가 활성화하는 컨텍스트를 목록화하는 `OutputContext` 객체의 배열입니다.  
타입: [OutputContext](API_OutputContext.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
기본 제공 의도의 고유 식별자입니다.  
유형: 문자열

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
사용자가 `confirmationPrompt`에 정의된 질문에 "아니요"라고 답하면 Amazon Lex는 의도가 취소되었음을 확인하기 위해 이 문장으로 답합니다.  
유형: [Statement](API_Statement.md)객체

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
의도에 대해 구성된 샘플 표현 배열.  
유형: 문자열 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 1,500개.  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200입니다.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
의도에 대해 구성된 의도 슬롯 배열.  
타입: [Slot](API_Slot.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 100개.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
의도의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntent) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent) 

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

다음과 같이 의도 정보를 반환합니다.
+ `nameContains` 필드를 지정하는 경우, 지정된 문자열이 포함된 모든 의도의 `$LATEST` 버전을 반환합니다.
+  `nameContains` 필드를 지정하지 않으면 모든 의도의 `$LATEST` 버전에 대한 정보가 반환됩니다.

 이 작업에는 `lex:GetIntents` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-maxResults"></a>
응답에 반환되는 최대 의도 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nameContains](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nameContains"></a>
의도 이름과 일치하는 하위 문자열. 의도 이름의 일부가 하위 문자열과 일치하면 의도가 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nextToken"></a>
의도의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [intents](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-intents"></a>
`Intent` 객체 어레이. 자세한 내용은 [PutBot](API_PutBot.md)을 참조하세요.  
유형: [IntentMetadata](API_IntentMetadata.md) 객체 배열

 ** [nextToken](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-nextToken"></a>
응답이 잘린 경우 응답에는 의도의 다음 페이지를 가져오기 위해 다음 요청에서 지정할 수 있는 페이지 매김 토큰이 포함됩니다.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntents) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntents) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntents) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntents) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntents) 

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

의도의 모든 버전에 대한 정보를 반환합니다.

이 `GetIntentVersions` 작업은 의도의 각 버전에 대한 `IntentMetadata` 객체를 반환합니다. 예를 들어 의도에 번호가 매겨진 버전이 3개 있는 경우, `GetIntentVersions` 작업은 번호가 매겨진 버전마다 하나씩 및 `$LATEST` 버전에 한 개, 총 4개의 `IntentMetadata` 객체를 응답으로 반환합니다.

`GetIntentVersions` 작업은 항상 하나 이상의 버전, 즉 `$LATEST` 버전을 반환합니다.

이 작업에는 `lex:GetIntentVersions` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-maxResults"></a>
응답으로 반환할 최대 의도 버전 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [name](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-name"></a>
버전을 반환해야 할 의도의 이름.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [nextToken](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-nextToken"></a>
의도 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [intents](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-intents"></a>
번호가 매겨진 각 버전의 의도에 대해 하나씩 및 `$LATEST` 버전에 대한 하나에 해당하는 `IntentMetadata` 객체 배열입니다.  
타입: [IntentMetadata](API_IntentMetadata.md)객체 배열

 ** [nextToken](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-nextToken"></a>
의도 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntentVersions) 

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

Amazon Lex V1 봇에서 Amazon Lex V2 봇으로의 진행 중인 또는 전체 마이그레이션에 대한 세부 정보를 제공합니다. 이 작업을 사용하면 마이그레이션과 관련된 마이그레이션 알림 및 경고를 볼 수 있습니다.

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

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

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

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

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
조회할 마이그레이션의 고유 식별자입니다. [StartMigration](API_StartMigration.md) 작업에서 `migrationID`가 반환됩니다.  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$`   
필수 여부: 예

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

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

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

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

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

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

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Amazon Lex V1 봇을 Amazon Lex V2로 마이그레이션할 때 발생하는 문제를 나타내는 경고 및 경고 목록입니다. Amazon Lex V2에서 Amazon Lex V1 기능이 다르게 구현되면 경고 메시지가 표시됩니다.  
자세한 내용은 *Amazon Lex V2 개발자 가이드*의 [봇 마이그레이션](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html)을 참조하십시오.  
타입: [MigrationAlert](API_MigrationAlert.md)객체 배열

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
마이그레이션의 고유 식별자입니다. `GetMigration` 작업을 호출할 때 사용되는 식별자와 동일합니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
마이그레이션 상태를 나타냅니다. 상태 `COMPLETE`이 되면 마이그레이션이 완료되고 Amazon Lex V2에서 봇을 사용할 수 있게 됩니다. 마이그레이션을 완료하기 위해 해결해야 하는 알림 및 경고가 있을 수 있습니다.  
타입: 문자열  
유효 값: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
마이그레이션을 수행하는 데 사용된 전략.  
+  `CREATE_NEW` - 새 Amazon Lex V2 봇을 만들고 Amazon Lex V1 봇을 새 봇으로 마이그레이션합니다.
+  `UPDATE_EXISTING` - 기존 Amazon Lex V2 봇 메타데이터와 마이그레이션 중인 로캘을 덮어씁니다. Amazon Lex V2 봇의 다른 로캘은 변경되지 않습니다. 로캘이 존재하지 않는 경우 Amazon Lex V2 봇에 새 로캘이 생성됩니다.
타입: 문자열  
유효 값: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
마이그레이션이 시작된 날짜와 시간.  
유형: 타임스탬프

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1 로캘의 이름.  
타입: 문자열  
유효 값: `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>
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
Amazon Lex V2로 마이그레이션하려는 Amazon Lex V1 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
Amazon Lex V1이 마이그레이션되는 대상 Amazon Lex V2 봇의 고유 식별자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
Amazon Lex가 Amazon Lex V2 봇을 실행하는 데 사용하는 IAM 역할.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration) 

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

아마존 Lex V1과 아마존 Lex V2 간의 마이그레이션 목록을 가져옵니다.

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

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

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

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

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
응답에 반환되는 최대 마이그레이션 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
지정된 상태의 마이그레이션만 포함하도록 목록을 필터링합니다.  
유효한 값: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
마이그레이션의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 작업에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 마이그레이션의 다음 페이지를 가져오려면 요청에서 페이지 매김 토큰을 지정하십시오.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
마이그레이션 목록을 정렬하는 데 사용할 필드입니다. Amazon Lex V1 봇 이름 또는 마이그레이션이 시작된 날짜 및 시간을 기준으로 정렬할 수 있습니다.  
유효한 값: `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
순서에 따라 목록이 정렬됩니다.  
유효한 값: `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
이름에 지정된 문자열이 포함된 봇만 포함하도록 목록을 필터링합니다. 문자열은 봇 이름의 모든 위치와 일치합니다.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

## 요청 본문
<a name="API_GetMigrations_RequestBody"></a>

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

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

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

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

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

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Amazon Lex V1에서 Amazon Lex V2로의 마이그레이션에 대한 요약의 배열입니다. 마이그레이션의 세부 정보를 보려면 [GetMigration](API_GetMigration.md) 작업에 대한 호출 내 요약의 `migrationId`을 사용하십시오.  
타입: [MigrationSummary](API_MigrationSummary.md)객체 배열

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
응답이 잘린 경우 다음 요청 시 마이그레이션의 다음 페이지를 가져오도록 지정할 수 있는 페이지 매김 토큰이 포함됩니다.  
유형: 문자열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetMigrations_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigrations) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations) 

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

슬롯 유형의 특정 버전에 대한 정보를 반환합니다. 슬롯 유형 이름을 지정할 뿐만 아니라 슬롯 유형 버전 또한 지정해야 합니다.

이 작업에는 `lex:GetSlotType` 액션에 대한 권한이 필요합니다.

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

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

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

다음의 URI 파라미터를 사용하여 요청합니다.

 ** [name](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-name"></a>
슬롯 유형의 이름. 이름은 대/소문자를 구분합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [version](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-version"></a>
슬롯 유형의 버전.  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 예

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

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

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

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

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

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

 ** [checksum](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-checksum"></a>
슬롯 유형의 `$LATEST` 버전의 체크섬.  
유형: 문자열

 ** [createdDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-createdDate"></a>
슬롯 유형이 생성된 날짜.  
유형: 타임스탬프

 ** [description](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [enumerationValues](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-enumerationValues"></a>
슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록.  
타입: [EnumerationValue](API_EnumerationValue.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개.

 ** [lastUpdatedDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-lastUpdatedDate"></a>
슬롯 유형이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-name"></a>
슬롯 유형의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-parentSlotTypeSignature"></a>
슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-slotTypeConfigurations"></a>
상위 기본 제공 슬롯 유형을 확장하는 구성 정보.  
타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [valueSelectionStrategy](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-valueSelectionStrategy"></a>
Amazon Lex가 슬롯 값을 결정하는 데 사용하는 전략입니다. 자세한 내용은 [PutSlotType](API_PutSlotType.md)을 참조하세요.  
타입: 문자열  
유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-version"></a>
슬롯 유형의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotType) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotType) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotType) 

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

다음과 같이 슬롯 유형 정보를 반환합니다.
+ `nameContains` 필드를 지정하는 경우, 지정된 문자열이 포함된 모든 슬롯 유형의 `$LATEST` 버전을 반환합니다.
+  `nameContains` 필드를 지정하지 않으면 모든 슬롯 유형의 `$LATEST` 버전에 대한 정보가 반환됩니다.

 이 작업에는 `lex:GetSlotTypes` 작업에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-maxResults"></a>
응답에 반환되는 최대 슬롯 유형 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [nameContains](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nameContains"></a>
슬롯 유형 이름에서 일치하는 하위 문자열. 이름 중 일부가 하위 문자열과 일치하면 슬롯 유형이 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nextToken"></a>
슬롯 유형의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [nextToken](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-nextToken"></a>
응답이 잘린 경우 다음 요청 시 슬롯 유형의 다음 페이지를 가져오도록 지정할 수 있는 페이지 매김 토큰이 포함됩니다.  
유형: 문자열

 ** [slotTypes](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-slotTypes"></a>
슬롯 유형 이름, 버전, 설명 등의 정보를 제공하는 객체 배열(각 슬롯 유형당 하나씩).  
타입: [SlotTypeMetadata](API_SlotTypeMetadata.md) 객체 배열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypes) 

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

슬롯 유형의 모든 버전에 대한 정보를 얻습니다.

이 `GetSlotTypeVersions` 작업은 슬롯 유형의 각 버전에 대한 `SlotTypeMetadata` 객체를 반환합니다. 예를 들어 슬롯 유형에 번호가 매겨진 버전이 3개 있는 경우, `GetSlotTypeVersions` 작업은 번호가 매겨진 버전마다 하나씩 및 `$LATEST` 버전에 한 개, 총 4개의 `SlotTypeMetadata` 객체를 응답으로 반환합니다.

`GetSlotTypeVersions` 작업은 항상 하나 이상의 버전, 즉 `$LATEST` 버전을 반환합니다.

이 작업에는 `lex:GetSlotTypeVersions` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [maxResults](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-maxResults"></a>
응답에 반환되는 최대 슬롯 유형 버전 수입니다. 기본값은 10.  
유효한 범위: 최소값은 1. 최대값은 50.

 ** [name](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-name"></a>
버전을 반환해야 할 슬롯 유형의 이름.  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [nextToken](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-nextToken"></a>
슬롯 유형 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

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

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

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

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

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

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

 ** [nextToken](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-nextToken"></a>
슬롯 유형 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.  
유형: 문자열

 ** [slotTypes](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-slotTypes"></a>
번호가 매겨진 각 버전의 봇에 대해 하나씩 및 `$LATEST` 버전에 대한 하나에 해당하는 `SlotTypeMetadata` 객체 배열입니다.  
타입: [SlotTypeMetadata](API_SlotTypeMetadata.md) 객체 배열

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

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypeVersions) 

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

`GetUtterancesView` 작업을 사용하여 사용자가 봇에 대해 한 표현 정보를 가져옵니다. 이 목록을 사용하여 봇이 반응하는 표현을 조정할 수 있습니다.

예를 들어 꽃을 주문하는 봇을 만들었다고 가정합니다. 사용자가 한동안 봇을 사용한 후 `GetUtterancesView` 작업을 사용하여 요청한 내용과 성공 여부를 확인하세요. “꽃을 원해요”라는 표현이 인식되지 않을 수도 있습니다. 이 표현을 `OrderFlowers` 의도에 추가하여 봇이 해당 표현을 인식하도록 할 수 있습니다.

새 버전의 봇을 게시한 후에는 이전 버전과 새 버전에 대한 정보를 얻을 수 있으므로 두 버전의 성능을 비교할 수 있습니다.

표현 통계는 매일 한 번 생성됩니다. 데이터는 지난 15일 동안 사용할 수 있습니다. 각 요청에서 최대 5개 버전의 봇에 대한 정보를 요청할 수 있습니다. Amazon Lex는 봇이 지난 15일 동안 가장 자주 받은 표현을 반환합니다. 응답에는 각 버전에 대한 최대 100개의 표현에 대한 정보가 포함됩니다.

다음 조건에서는 표현 통계가 생성되지 않습니다.
+ 봇이 생성될 때 `childDirected` 필드는 참으로 설정되었습니다.
+ 하나 이상의 슬롯에서 슬롯 난독화 기능을 사용하고 있습니다.
+ Amazon Lex 개선에 참여하지 않기로 선택했습니다.

이 작업에는 `lex:GetUtterancesView` 액션에 대한 권한이 필요합니다.

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

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

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

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

 ** [botname](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botName"></a>
표현 정보를 반환해야 하는 봇의 이름.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [botVersions](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botVersions"></a>
표현 정보를 반환해야 하는 봇 버전의 배열. 요청당 5개 버전으로 제한됩니다.  
배열 멤버: 최소 항목 수는 1개. 최대 항목 수는 5개.  
길이 제약: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 예

 ** [statusType](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-statusType"></a>
인식되고 처리된 표현을 반환하려면 `Detected`을 사용하십시오. 인식되지 않은 표현을 반환하려면 `Missed`을 사용하십시오.  
유효한 값: `Detected | Missed`   
필수 사항 여부: 예

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

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

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

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

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

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

 ** [botName](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-botName"></a>
표현 정보를 반환해야 하는 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [utterances](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-utterances"></a>
각 [UtteranceList](API_UtteranceList.md) 객체에는 봇이 처리한 표현을 설명하는 [UtteranceData](API_UtteranceData.md) 객체 목록이 들어 있는 객체 배열입니다. 응답에는 각 버전당 최대 100개의 `UtteranceData` 객체가 포함됩니다. Amazon Lex는 봇이 지난 15일 동안 가장 자주 받은 표현을 반환합니다.  
타입: [UtteranceList](API_UtteranceList.md) 객체 배열

## Errors
<a name="API_GetUtterancesView_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_GetUtterancesView_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

지정된 리소스와 연결된 태그를 가져옵니다. 봇, 봇 별칭, 봇 채널에만 태그를 연결할 수 있습니다.

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

```
GET /tags/resourceArn HTTP/1.1
```

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

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

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="lex-ListTagsForResource-request-uri-resourceArn"></a>
태그 목록을 가져올 리소스의 Amazon 리소스 이름(ARN)입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1011입니다.  
필수 항목 여부: 예

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

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

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

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

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

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

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="lex-ListTagsForResource-response-tags"></a>
리소스와 연결된 태그를 봅니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

## Errors
<a name="API_ListTagsForResource_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ListTagsForResource) 

# PutBot
<a name="API_PutBot"></a>

Amazon Lex 대화형 봇을 생성하거나 기존 봇을 교체합니다. 봇을 생성하거나 업데이트할 때는 이름, 로캘, 봇이 13세 미만의 어린이를 대상으로 하는지 여부만 지정하면 됩니다. 이를 사용하여 나중에 의도를 추가하거나 기존 봇에서 의도를 제거할 수 있습니다. 최소 정보로 봇을 생성하면 봇이 생성되거나 업데이트되지만 Amazon Lex는 `` 응답을 반환합니다`FAILED`. 하나 이상의 의도를 추가한 후 봇을 구축할 수 있습니다. Amazon Lex에 대한 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md)를 참조하십시오.

기존 봇의 이름을 지정하는 경우, 요청의 필드가 봇 `$LATEST` 버전의 기존 값을 대체합니다. Amazon Lex는 요청에서 값을 제공하지 않은 모든 필드를 제거합니다. 단, 기본값으로 설정된 `idleTTLInSeconds` 및 `privacySettings` 필드는 예외입니다. 필수 필드 값을 지정하지 않으면 Amazon Lex에서 예외가 발생합니다.

이 작업에는 `lex:PutBot` 액션에 대한 권한이 필요합니다. 자세한 내용은 [Amazon Lex의 Identity and Access Management](security-iam.md)을 참조하세요.

## 요청 구문
<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"
}
```

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

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

 ** [name](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-uri-name"></a>
봇의 이름. 이름은 대/소문자를 구분하지 *않습니다*.  
길이 제약: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_PutBot_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [abortStatement](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-abortStatement"></a>
Amazon Lex는 컨텍스트에서 사용자의 입력을 이해할 수 없는 경우 정보를 추출하려고 몇 번 시도합니다. 그런 다음 Amazon Lex는 `abortStatement`에서 정의한 메시지를 사용자에게 보낸 다음 대화를 취소합니다. 재시도 횟수를 설정하려면 슬롯 유형의 `valueElicitationPrompt` 필드를 사용하십시오.  
예를 들어 피자 주문 봇에서 Amazon Lex는 사용자에게 "어떤 종류의 크러스트를 원하시나요?"라고 물을 수 있습니다. 사용자의 응답이 예상 응답 중 하나가 아닌 경우(예: "얇은 크러스트", "딥 디쉬" 등), Amazon Lex는 올바른 응답을 몇 번 더 유도하려고 합니다.  
예를 들어 피자 주문 애플리케이션에서는, `OrderPizza`은 이러한 의도 중 하나일 수 있습니다. 이 의도에는 `CrustType` 슬롯이 필요할 수 있습니다. `CrustType` 슬롯을 생성할 때 `valueElicitationPrompt` 필드를 지정합니다.  
폴백 의도를 정의한 경우 취소 명령문이 사용자에게 전송되지 않고 대신 폴백 의도가 사용됩니다. 자세한 내용은 [ AMAZON.FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html)를 참조하십시오.  
유형: [Statement](API_Statement.md)객체  
필수 여부: 아니요

 ** [checksum](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-checksum"></a>
`$LATEST` 버전의 특정 개정 버전을 식별합니다.  
새 봇을 만들 때는 `checksum` 필드를 비워 두십시오. 체크섬을 지정하면 `BadRequestException` 예외가 발생합니다.  
봇을 업데이트하려면 `checksum` 필드를 해당 버전의 최신 수정 `$LATEST` 버전의 체크섬으로 설정하십시오. ` checksum` 필드를 지정하지 않거나 체크섬이 `$LATEST` 버전과 일치하지 않으면 `PreconditionFailedException` 예외가 발생합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [childDirected](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-childDirected"></a>
Amazon Lex Model Building Service로 만든 각 Amazon Lex 봇에 대해, Amazon Lex 사용이, 전체 또는 일부가, 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부 및 어린이 온라인 개인정보 보호 법률(COPPA)을 준수하는지를 `childDirected` 필드의 `true` 또는 `false`를 지정하여 지정해야 합니다. `childDirected` 필드에 `true`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **있음**을 확인합니다. `childDirected` 필드에 `false`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **없음**을 확인합니다. 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부를 정확하게 반영하지 않는 `childDirected` 필드에 대한 기본값을 지정할 수 없습니다.  
Amazon Lex의 사용이 전체 또는 부분적으로 13세 미만 어린이를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 경우 COPPA에 따라 검증 가능한 필수 부모 동의를 얻어야 합니다. 전체 또는 일부를 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 Amazon Lex 사용에 관한 정보는 [Amazon Lex FAQ](https://aws.amazon.com/lex/faqs#data-security)를 참조하십시오.  
유형: Boolean  
필수 항목 여부: 예

 ** [clarificationPrompt](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-clarificationPrompt"></a>
Amazon Lex는 사용자의 의도를 이해하지 못할 경우 이 메시지를 사용하여 확인을 구합니다. Amazon Lex가 설명 프롬프트를 반복해야 하는 횟수를 지정하려면 `maxAttempts` 필드를 사용하십시오. Amazon Lex가 여전히 이해하지 못하면 `abortStatement` 필드로 메시지를 보냅니다.  
설명 프롬프트를 생성할 때는 사용자의 올바른 응답을 제안하는지 확인하십시오. 예를 들어 피자와 음료를 주문하는 봇의 경우 다음과 같은 설명 프롬프트를 생성할 수 있습니다. "어떻게 하시겠습니까? '음로 주문' 또는 '피자 주문'라고 말할 수 있습니다.  
폴백 의도를 정의한 경우 `maxAttempts` 필드에 정의된 횟수만큼 설명 프롬프트가 반복되면 해당 의도가 호출됩니다. 자세한 내용은 [ AMAZON.FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html)를 참조하십시오.  
확인 프롬프트를 정의하지 않으면 Amazon Lex는 런타임 시 다음과 같은 세 가지 경우에 400 잘못된 요청 예외를 반환합니다.  
+ 후속 프롬프트 - 사용자가 후속 프롬프트에 응답하지만, 의도를 제공하지 않는 경우. 예를 들어, "오늘 다른 것을 원하시나요?"라는 후속 프롬프트에 대한 응답으로 사용자가 "예"라고 한 경우 Amazon Lex에 사용자의 의도를 파악하기 위한 확인 프롬프트가 없기 때문에 400 잘못된 요청 예외가 반환됩니다.
+ Lambda 함수 - Lambda 함수를 사용하는 경우 `ElicitIntent` 대화 상자 유형을 반환합니다. Amazon Lex에 사용자의 의도를 파악하기 위한 확인 프롬프트가 없기 때문에 400 잘못된 요청 예외가 반환됩니다.
+ PutSession 작업 - `PutSession` 작업을 사용 중인 경우 `ElicitIntent` 대화 유형을 전송합니다. Amazon Lex에 사용자의 의도를 파악하기 위한 확인 프롬프트가 없기 때문에 400 잘못된 요청 예외가 반환됩니다.
유형: [Prompt](API_Prompt.md)객체  
필수 여부: 아니요

 ** [createVersion](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-createVersion"></a>
`true`로 설정하면 번호가 매겨진 새 버전의 봇이 생성됩니다. 이는 `CreateBotVersion` 오퍼레이션을 호출하는 것과 같습니다. `createVersion`를 지정하지 않으면 기본값은 `false`입니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [description](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-description"></a>
봇에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** [detectSentiment](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-detectSentiment"></a>
`true`로 설정하면 감정 분석을 위해 사용자 표현이 Amazon Comprehend로 전송됩니다. `detectSentiment`를 지정하지 않으면 기본값은 `false`입니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [enableModelImprovements](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-enableModelImprovements"></a>
자연어 이해 개선에 대한 액세스를 가능하게 `true`로 설정합니다.  
`enableModelImprovements` 매개변수를 `true`로 설정하면 `nluIntentConfidenceThreshold` 매개변수를 사용하여 신뢰도 점수를 구성할 수 있습니다. 자세한 내용은 [신뢰도 점수](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html)를 참조하세요.  
특정 지역에서만 `enableModelImprovements` 매개변수를 설정할 수 있습니다. 매개변수를 `true`로 설정하면 봇이 정확도 개선에 액세스합니다.  
en-US 로캘에 `enableModelImprovements` 매개변수를 `false`로 설정할 수 있는 지역은 다음과 같습니다.  
+ 미국 동부(버지니아 북부)(us-east-1)
+ 미국 서부(오레곤)(us-west-2)
+ 아시아 태평양(시드니)(ap-southeast-2)
+ EU(아일랜드)(eu-west-1)
다른 지역 및 로캘에서는 `enableModelImprovements` 매개변수가 기본적으로 `true`로 설정됩니다. 이러한 지역 및 로캘에서 매개변수를 `false`로 설정하면 `ValidationException` 예외가 발생합니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [idleSessionTTLInSeconds](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-idleSessionTTLInSeconds"></a>
Amazon Lex가 대화에서 수집된 데이터를 유지하는 최대 시간(초) 입니다.  
사용자 상호 작용 세션은 지정된 시간 동안 활성 상태로 유지됩니다. 이 시간 동안 대화가 발생하지 않으면 세션이 만료되고 Amazon Lex는 제한 시간 전에 제공된 모든 데이터를 삭제합니다.  
예를 들어, 사용자가 OrderPizza 의도를 선택했지만 주문을 하는 도중에 다른 곳으로 이동했다고 가정하겠습니다. 사용자가 지정된 시간 내에 주문을 완료하지 않으면 Amazon Lex는 수집한 슬롯 정보를 삭제하므로 사용자는 처음부터 다시 시작해야 합니다.  
`PutBot` 작업 요청에 `idleSessionTTLInSeconds` 요소를 포함하지 않는 경우 Amazon Lex는 기본값을 사용합니다. 요청이 기존 봇을 대체하는 경우에도 마찬가지입니다.  
기본값은 300초(5분)입니다.  
유형: 정수  
유효한 범위: 최소값은 60. 최대값은 86,400.  
필수 여부: 아니요

 ** [intents](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-intents"></a>
`Intent` 객체 어레이. 각 의도는 사용자가 표현할 수 있는 명령을 나타냅니다. 예를 들어 피자 주문 봇은 OrderPizza 의도를 지원할 수 있습니다. 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md) 단원을 참조하십시오.  
유형: [Intent](API_Intent.md) 객체 배열  
필수: 아니요

 ** [locale](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-locale"></a>
 봇의 타겟 로캘을 지정합니다. 봇에서 사용되는 모든 의도는 봇의 로캘과 호환되어야 합니다.  
기본값은 `en-US`입니다.  
타입: 문자열  
유효 값: `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`   
필수 사항 여부: 예

 ** [nluIntentConfidenceThreshold](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-nluIntentConfidenceThreshold"></a>
[PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) 또는 [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) 응답에서 대체 의도를 반환할 때 Amazon Lex가 `AMAZON.FallbackIntent`, `AMAZON.KendraSearchIntent`, 또는 둘 다를 삽입할 임계값을 결정합니다. `AMAZON.FallbackIntent` 및 `AMAZON.KendraSearchIntent`은 봇에 대해 구성된 경우만 삽입됩니다.  
다음 지역의 신뢰도 점수를 사용하려면 `enableModelImprovements` 매개변수를 `true`로 설정해야 합니다.  
+ 미국 동부(버지니아 북부)(us-east-1)
+ 미국 서부(오레곤)(us-west-2)
+ 아시아 태평양(시드니)(ap-southeast-2)
+ EU(아일랜드)(eu-west-1)
다른 지역 및 로캘에서는 `enableModelImprovements` 매개변수가 기본적으로 `true`로 설정됩니다.  
예를 들어, 봇이 신뢰 임계값 0.80 및 `AMAZON.FallbackIntent`으로 구성되어 있다고 가정하겠습니다. Amazon Lex는 IntentA(0.70), IntentB(0.60), IntentC(0.50) 라는 신뢰도 점수를 가진 세 가지 대체 의도를 반환합니다. `PostText` 작업에 대한 응답은 다음과 같습니다.  
+ AMAZON.FallbackIntent
+ IntentA
+ IntentB
+ IntentC
유형: Double  
유효한 범위: 최소값 0. 최댓값은 1.  
필수 여부: 아니요

 ** [processBehavior](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-processBehavior"></a>
`processBehavior` 요소를 `BUILD`로 설정하면 Amazon Lex는 봇이 실행될 수 있도록 봇을 빌드합니다. 요소를 `SAVE`로 설정하면, Amazon Lex는 봇을 저장하지만 빌드하지는 않습니다.  
값을 지정하지 않을 경우 기본값은 `BUILD`입니다.  
타입: 문자열  
유효 값: `SAVE | BUILD`   
필수 여부: 아니요

 ** [tags](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-tags"></a>
봇에 추가할 태그의 목록입니다. 봇을 생성할 때만 태그를 추가할 수 있으며 봇에서 태그를 업데이트하는 `PutBot` 작업을 사용할 수는 없습니다. 태그를 업데이트하려면 `TagResource` 작업을 사용합니다.  
유형: [Tag](API_Tag.md) 객체의 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [voiceId](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-voiceId"></a>
Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다. 음성에 구성된 로캘은 봇의 로캘과 일치해야 합니다. 자세한 내용은 *Amazon Polly 개발자 안내서*의 [Amazon Polly 음성](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)을 참조하세요.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [abortStatement](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-abortStatement"></a>
Amazon Lex에서 대화를 취소하는 데 사용하는 메시지입니다. 자세한 내용은 [PutBot](#API_PutBot)을 참조하세요.  
유형: [Statement](API_Statement.md)객체

 ** [checksum](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-checksum"></a>
생성한 봇의 체크섬.  
유형: 문자열

 ** [childDirected](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-childDirected"></a>
Amazon Lex Model Building Service로 만든 각 Amazon Lex 봇에 대해, Amazon Lex 사용이, 전체 또는 일부가, 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부 및 어린이 온라인 개인정보 보호 법률(COPPA)을 준수하는지를 `childDirected` 필드의 `true` 또는 `false`를 지정하여 지정해야 합니다. `childDirected` 필드에 `true`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **있음**을 확인합니다. `childDirected` 필드에 `false`을 지정함으로써 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 **없음**을 확인합니다. 사용자는 Amazon Lex 사용이 13세 미만 및 COPPA 적용 대상 아동 전체 또는 일부를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련이 있는지 여부를 정확하게 반영하지 않는 `childDirected` 필드에 대한 기본값을 지정할 수 없습니다.  
Amazon Lex의 사용이 전체 또는 부분적으로 13세 미만 어린이를 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 경우 COPPA에 따라 검증 가능한 필수 부모 동의를 얻어야 합니다. 전체 또는 일부를 13세 미만 어린이를 대상으로 하거나 대상으로 하는 웹 사이트, 프로그램 또는 기타 애플리케이션과 관련된 Amazon Lex 사용에 관한 정보는 [Amazon Lex FAQ](https://aws.amazon.com/lex/faqs#data-security)를 참조하십시오.  
유형: Boolean

 ** [clarificationPrompt](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-clarificationPrompt"></a>
 Amazon Lex 가 사용자의 의도를 이해하지 못할 때 사용하는 프롬프트입니다. 자세한 내용은 [PutBot](#API_PutBot) 단원을 참조하십시오.  
유형: [Prompt](API_Prompt.md)객체

 ** [createdDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createdDate"></a>
봇이 생성된 날짜.  
유형: 타임스탬프

 ** [createVersion](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createVersion"></a>
 봇의 새 버전이 생성된 경우 `True`. 요청에서 `createVersion` 필드를 지정하지 않은 경우 응답에서 `createVersion` 필드는 거짓으로 설정됩니다.  
유형: Boolean

 ** [description](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-description"></a>
봇에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [detectSentiment](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-detectSentiment"></a>
 봇이 감정 분석을 위해 사용자 발언을 Amazon Comprehend로 보내도록 구성된 경우 `true`. 요청에서 `detectSentiment` 필드를 지정하지 않은 경우 응답에서 `detectSentiment` 필드는 `false`입니다.  
유형: Boolean

 ** [enableModelImprovements](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-enableModelImprovements"></a>
봇이 정확도 개선을 사용하는지 여부를 나타냅니다. `true`은 봇이 개선 사항을 사용하고 있음을 나타내며, 그렇지 않으면, `false`입니다.  
유형: Boolean

 ** [failureReason](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-failureReason"></a>
만약 `status`이 `FAILED`라면, Amazon Lex는 봇 구축에 실패한 이유를 제공합니다.  
유형: 문자열

 ** [idleSessionTTLInSeconds](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-idleSessionTTLInSeconds"></a>
Amazon Lex가 대화에서 수집된 데이터를 유지하는 최대 시간입니다. 자세한 내용은 [PutBot](#API_PutBot) 단원을 참조하십시오.  
유형: 정수  
유효한 범위: 최소값은 60. 최대값은 86,400.

 ** [intents](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-intents"></a>
`Intent` 객체 어레이. 자세한 내용은 [PutBot](#API_PutBot)을 참조하세요.  
유형: [Intent](API_Intent.md) 객체 배열

 ** [lastUpdatedDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-lastUpdatedDate"></a>
봇이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [locale](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-locale"></a>
 봇의 타겟 로캘입니다.  
타입: 문자열  
유효 값: `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>
봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-nluIntentConfidenceThreshold"></a>
[PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) 또는 [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) 응답에서 대체 의도를 반환할 때 Amazon Lex가 `AMAZON.FallbackIntent`, `AMAZON.KendraSearchIntent` 또는 둘 다를 삽입하는 위치를 결정하는 점수입니다. `AMAZON.FallbackIntent`는 모든 의도에 대한 신뢰도 점수가 이 값보다 낮은 경우 삽입됩니다. `AMAZON.KendraSearchIntent`은 봇에 대해 구성된 경우에만 삽입됩니다.  
유형: 더블  
유효한 범위: 최소값 0. 최댓값은 1.

 ** [status](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-status"></a>
 `processBehavior`이 `BUILD`로 설정된 봇 생성 요청을 보내면 Amazon Lex는 `status` 응답 요소를 `BUILDING`로 설정합니다.  
`READY_BASIC_TESTING` 상태에서는 슬롯 유형에서 봇의 의도와 값에 대해 구성된 표현과 정확히 일치하는 사용자 입력으로 봇을 테스트할 수 있습니다.  
Amazon Lex가 봇을 빌드하지 못하는 경우에는 `status`을 `FAILED`로 설정합니다. Amazon Lex 는 `failureReason` 응답 요소에 실패 이유를 반환합니다.  
`processBehavior`을 `SAVE`로 설정하면 Amazon Lex에서 상태 코드를 `NOT BUILT`로 설정합니다.  
봇이 `READY` 상태가 되면 봇을 테스트하고 게시할 수 있습니다.  
타입: 문자열  
유효 값: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [tags](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-tags"></a>
봇과 연결된 태그 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

 ** [version](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-version"></a>
봇의 버전. 새 봇의 경우 버전은 항상 `$LATEST`입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-voiceId"></a>
Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다. 자세한 내용은 [PutBot](#API_PutBot) 단원을 참조하십시오.  
유형: 문자열

## Errors
<a name="API_PutBot_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBot) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBot) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBot) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBot) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBot) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBot) 

# PutBotAlias
<a name="API_PutBotAlias"></a>

지정된 버전의 봇에 대한 별칭을 만들거나 지정된 버전의 봇에 대한 별칭을 대체합니다. 별칭이 가리키는 봇 버전을 변경하려면 별칭을 바꾸십시오. 별칭에 대한 자세한 내용은 [버전 관리 및 별칭](versioning-aliases.md)을 참조하십시오.

이 작업에는 `lex:PutBotAlias` 액션에 대한 권한이 필요합니다.

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

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

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

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
봇의 이름.  
길이 제약: 최소 길이 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
별칭의 이름. 이름은 대/소문자를 구분하지 *않습니다*.  
길이 제약: 최소 길이 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_PutBotAlias_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></a>
봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 예

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
`$LATEST` 버전의 특정 개정 버전을 식별합니다.  
새 봇을 만들 때는 `checksum` 필드를 비워 두십시오. 체크섬을 지정하면 `BadRequestException` 예외가 발생합니다.  
봇을 업데이트하려면 `checksum` 필드를 해당 버전의 최신 수정 `$LATEST` 버전의 체크섬으로 설정하십시오. ` checksum` 필드를 지정하지 않거나 체크섬이 `$LATEST` 버전과 일치하지 않으면 `PreconditionFailedException` 예외가 발생합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
별칭의 대화 로그 설정.  
유형: [ConversationLogsRequest](API_ConversationLogsRequest.md)객체  
필수 여부: 아니요

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
별칭에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
봇에 추가할 태그의 목록입니다. 봇을 생성할 때만 태그를 추가할 수 있으며, 봇 별칭에서 태그를 업데이트하기 위해 `PutBotAlias` 작업을 사용할 수 없습니다. 태그를 업데이트하려면 `TagResource` 작업을 사용합니다.  
유형: [Tag](API_Tag.md) 객체의 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<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"
      }
   ]
}
```

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

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

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

 ** [botName](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
별칭이 가리키는 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
별칭이 가리키는 봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
별칭의 현재 버전에 대한 체크섬.  
유형: 문자열

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
Amazon Lex가 별칭에 대한 대화 로그를 사용하는 방법을 결정하는 설정입니다.  
유형: [ConversationLogsResponse](API_ConversationLogsResponse.md)객체

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
봇이 별칭이 생성된 날짜.  
유형: 타임스탬프

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
별칭에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
봇 별칭이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-name"></a>
별칭의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
봇과 연결된 태그 목록.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

## Errors
<a name="API_PutBotAlias_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias) 

# PutIntent
<a name="API_PutIntent"></a>

의도를 생성하거나 기존 의도를 대체합니다.

사용자와 봇 간의 상호작용을 정의하려면 하나 이상의 의도를 사용합니다. 예를 들어 피자 주문 봇의 경우 `OrderPizza` 의도를 생성할 수 있습니다.

의도를 생성하거나 기존 의도를 대체하려면 다음을 제공해야 합니다.
+ 의도 이름. 예를 들어 `OrderPizza`입니다.
+ 샘플 표현. 예를 들어, "피자 하나 주문할 수 있을까요?" 및 "피자를 주문하고 싶어요."
+ 수집해야 할 정보. 봇이 사용자에게 요청할 정보의 슬롯 유형을 지정합니다. 날짜 또는 시간과 같은 표준 슬롯 유형을 지정하거나 피자의 크기 및 크러스트와 같은 사용자 지정 슬롯 유형을 지정할 수 있습니다.
+ 의도가 이행되는 방식. Lambda 함수를 제공하거나 의도 정보를 클라이언트 애플리케이션에 반환하도록 의도를 구성할 수 있습니다. Lambda 함수를 사용하는 경우 모든 의도 정보를 사용할 수 있게 되면 Amazon Lex는 Lambda 함수를 간접적으로 호출합니다. 의도 정보를 클라이언트 애플리케이션에 반환하도록 의도를 구성하는 경우.

요청에 다음과 같은 기타 선택적 정보를 지정할 수 있습니다.
+ 사용자에게 의도를 확인하도록 요청하는 확인 프롬프트입니다. 예를 들어, "피자 주문할까요?"
+ 의도가 이행된 후 사용자에게 보낼 결론 설명. 예를 들어, "피자를 주문했습니다."
+ 사용자에게 추가 활동을 요청하는 후속 프롬프트. 예를 들어 "피자와 함께 음료를 주문하시겠습니까?"

의도를 업데이트하기 위해 기존 의도 이름을 지정하는 경우 Amazon Lex는 의도 `$LATEST` 버전의 값을 요청의 값으로 대체합니다. Amazon Lex는 요청에서 제공하지 않은 필드를 제거합니다. 필수 필드 값을 지정하지 않으면 Amazon Lex에서 예외가 발생합니다. 의도의 `$LATEST` 버전을 업데이트하면 해당 의도 `$LATEST` 버전을 사용하는 모든 봇의 `status` 필드는 `NOT_BUILT`로 설정됩니다.

자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md)을 참조하세요.

이 작업에는 `lex:PutIntent` 액션에 대한 권한이 필요합니다.

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

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

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

 ** [name](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-uri-name"></a>
의도의 이름. 이름은 대/소문자를 구분하지 *않습니다*.  
이름은 기본 제공 의도 이름 또는 "AMAZON"이라고 표시된 기본 제공 의도 이름과 일치할 수 없습니다. 제거됨. 예를 들어 `AMAZON.HelpIntent`라는 기본 제공 의도가 있기 때문에 `HelpIntent` 라는 사용자 지정 의도를 생성할 수 없습니다.  
기본 제공 의도 목록은 [Alexa Skills Kit](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents)의 *표준 기본 제공 의도*를 참조하십시오.  
길이 제약: 최소 길이 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_PutIntent_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [checksum](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-checksum"></a>
`$LATEST` 버전의 특정 개정 버전을 식별합니다.  
새 의도를 만들 때는 `checksum` 필드를 비워 두십시오. 체크섬을 지정하면 `BadRequestException` 예외가 발생합니다.  
의도를 업데이트하려면 `checksum` 필드를 해당 버전의 가장 최신 수정 `$LATEST` 버전의 체크섬으로 설정합니다. ` checksum` 필드를 지정하지 않거나 체크섬이 `$LATEST` 버전과 일치하지 않으면 `PreconditionFailedException` 예외가 발생합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [conclusionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-conclusionStatement"></a>
 Lambda 함수가 의도를 성공적으로 이행한 후 Amazon Lex가 사용자에게 전달하기를 원하는 설명.  
이 요소는 `fulfillmentActivity`에서 Lambda 함수를 제공하는 경우에만 관련이 있습니다. 의도를 클라이언트 애플리케이션에 반환하는 경우 이 요소를 지정할 수 없습니다.  
`followUpPrompt` 및 `conclusionStatement`는 함께 사용할 수 없습니다. 하나만 지정할 수 있습니다.
유형: [Statement](API_Statement.md)객체  
필수 여부: 아니요

 ** [confirmationPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-confirmationPrompt"></a>
사용자에게 의도를 확인하라는 프롬프트를 표시합니다. 이 질문에 예 또는 아니요로 답해야 합니다.  
Amazon Lex는 의도가 이행될 준비가 되었음을 사용자가 인지하도록 하기 위해 이 메시지를 사용합니다. 예를 들어 `OrderPizza` 의도가 있는 경우 주문을 하기 전에 올바른지 확인해야 할 수 있습니다. 사용자 질문에 간단히 응답하는 의도와 같은 다른 의도의 경우 정보를 제공하기 전에 사용자에게 확인을 요청하지 않아도 될 수 있습니다.  
`rejectionStatement`와 `confirmationPrompt`를 모두 입력하거나 둘 다 입력하지 않아야 합니다.
유형: [Prompt](API_Prompt.md)객체  
필수 여부: 아니요

 ** [createVersion](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-createVersion"></a>
`true`로 설정하면 번호가 매겨진 새 버전의 의도가 생성됩니다. 이는 `CreateIntentVersion` 작업을 호출하는 것과 같습니다. `createVersion`를 지정하지 않으면 기본값은 `false`입니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [description](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-description"></a>
의도에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** [dialogCodeHook](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-dialogCodeHook"></a>
 각 사용자 입력에 대해 간접 호출하도록 Lambda 함수를 지정합니다. 이 Lambda 함수를 간접 호출하여 사용자 상호 작용을 개인화할 수 있습니다.  
예를 들어, 봇이 사용자를 John이라고 판단한다고 가정해 보겠습니다. Lambda 함수는 백엔드 데이터베이스에서 John의 정보를 검색하고 일부 값을 미리 채울 수 있습니다. 예를 들어, John이 글루텐 불내증이 있는 것으로 확인되면 해당하는 `GlutenIntolerant` 의도 슬롯을 참으로 설정할 수 있습니다. John의 전화번호를 찾아 해당 세션 속성을 설정할 수 있습니다.  
유형: [CodeHook](API_CodeHook.md)객체  
필수 여부: 아니요

 ** [followUpPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-followUpPrompt"></a>
Amazon Lex는 이 프롬프트를 사용하여 의도를 이행한 후 추가 활동을 요청합니다. 예를 들어 `OrderPizza` 의도가 이행된 후 사용자에게 음료를 주문하라는 프롬프트를 표시할 수 있습니다.  
Amazon Lex가 취하는 조치는 다음과 같이 사용자의 응답에 따라 달라집니다.  
+ 사용자가 "예"라고 대답하면 봇에 대해 구성된 설명 프롬프트로 응답합니다.
+ 사용자가 "예"라고 답하고 의도를 트리거하는 표현을 계속하면 해당 의도에 대한 대화가 시작됩니다.
+ 사용자가 "아니요"라고 말하면 후속 조치 프롬프트에 대해 구성된 거부 문구로 응답합니다.
+ 표현을 인식하지 못하면 후속 조치 프롬프트가 다시 반복됩니다.
`followUpPrompt` 필드와 `conclusionStatement` 필드는 상호 배타적입니다. 하나만 지정할 수 있습니다.  
유형: [FollowUpPrompt](API_FollowUpPrompt.md)객체  
필수 여부: 아니요

 ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-fulfillmentActivity"></a>
필수 사항입니다. 의도가 이행되는 방식을 설명합니다. 예를 들어, 사용자가 피자 주문에 필요한 모든 정보를 제공한 후 `fulfillmentActivity`이 봇이 현지 피자 가게에 주문하는 방법을 정의합니다.  
 모든 의도 정보를 클라이언트 애플리케이션에 반환하거나, 의도(예: 피자 가게에서 주문)를 처리할 수 있는 Lambda 함수를 간접 호출하도록 Amazon Lex를 구성할 수 있습니다 .  
유형: [FulfillmentActivity](API_FulfillmentActivity.md)객체  
필수 여부: 아니요

 ** [inputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-inputContexts"></a>
Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는 `InputContext` 객체 배열입니다.  
타입: [InputContext](API_InputContext.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 5개.  
필수 여부: 아니요

 ** [kendraConfiguration](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-kendraConfiguration"></a>
`AMAZON.KendraSearchIntent` 의도를 사용하여 Amazon Kendra 인덱스에 연결하는 데 필요한 구성 정보입니다. 자세한 내용은 [AMAZON.KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html)를 참조하세요.  
유형: [KendraConfiguration](API_KendraConfiguration.md)객체  
필수 여부: 아니요

 ** [outputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-outputContexts"></a>
의도가 이행될 때 의도가 활성화하는 컨텍스트를 목록화하는 `OutputContext` 객체의 배열입니다.  
타입: [OutputContext](API_OutputContext.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수 10개.  
필수 여부: 아니요

 ** [parentIntentSignature](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-parentIntentSignature"></a>
이 의도의 기반이 되는 기본 제공 의도의 고유 식별자입니다. 의도의 서명을 찾으려면 *Alexa Skills Kit*의 [표준 기본 제공 의도](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents)를 참조하십시오.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [rejectionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-rejectionStatement"></a>
사용자가 `confirmationPrompt`에 정의된 질문에 "아니요"라고 답하면 Amazon Lex는 의도가 취소되었음을 확인하기 위해 이 문장으로 답합니다.  
`rejectionStatement`와 `confirmationPrompt`를 모두 입력하거나 둘 다 입력하지 않아야 합니다.
유형: [Statement](API_Statement.md)객체  
필수 여부: 아니요

 ** [sampleUtterances](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-sampleUtterances"></a>
사용자가 의도를 알리기 위해 말할 수 있는 표현(문자열)의 목록입니다. 예: "\$1PizzaSize\$1 피자를 원해요", "\$1수량\$1 \$1PizzaSize\$1 피자를 주문하세요."  
각 표현에서 슬롯 이름은 중괄호로 묶여 있습니다.  
유형: 문자열 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 1,500개.  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200.  
필수 여부: 아니요

 ** [slots](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-slots"></a>
의도 슬롯 배열. Amazon Lex는 런타임 시 슬롯에 정의된 프롬프트를 사용하여 사용자로부터 필요한 슬롯 값을 끌어냅니다. 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md) 단원을 참조하십시오.  
타입: [Slot](API_Slot.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 100개.  
필수 항목 여부: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [checksum](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-checksum"></a>
생성 또는 업데이트된 `$LATEST` 버전의 의도 체크섬.  
유형: 문자열

 ** [conclusionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-conclusionStatement"></a>
`fulfillmentActivity` 의도에 지정된 Lambda 함수가 의도를 이행하면 Amazon Lex는 이 설명을 사용자에게 전달합니다.  
유형: [Statement](API_Statement.md)객체

 ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-confirmationPrompt"></a>
의도에 정의된 경우 Amazon Lex는 사용자에게 의도를 이행하기 전에 의도를 확인하라는 메시지를 표시합니다.  
유형: [Prompt](API_Prompt.md)객체

 ** [createdDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createdDate"></a>
의도가 생성된 날짜입니다.  
유형: 타임스탬프

 ** [createVersion](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createVersion"></a>
 의도의 새 버전이 생성된 경우 `True`. 요청에서 `createVersion` 필드를 지정하지 않은 경우 응답에서 `createVersion` 필드는 거짓으로 설정됩니다.  
유형: Boolean

 ** [description](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-description"></a>
의도에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-dialogCodeHook"></a>
의도가 정의된 경우 Amazon Lex는 각 사용자 입력에 대해 이 Lambda 함수를 간접 호출합니다.  
유형: [CodeHook](API_CodeHook.md)객체

 ** [followUpPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-followUpPrompt"></a>
의도에 정의된 경우 Amazon Lex는 이 프롬프트를 사용하여 의도가 충족된 후 추가 사용자 활동을 요청합니다.  
유형: [FollowUpPrompt](API_FollowUpPrompt.md)객체

 ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-fulfillmentActivity"></a>
의도에 정의된 경우 Amazon Lex는 사용자가 의도에 필요한 모든 정보를 제공한 후 이 Lambda 함수를 간접 호출하여 의도를 수행합니다.  
유형: [FulfillmentActivity](API_FulfillmentActivity.md)객체

 ** [inputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-inputContexts"></a>
Amazon Lex가 사용자와의 대화에서 의도를 선택하기 위해 활성화되어야 하는 컨텍스트를 목록화하는 `InputContext` 객체 배열입니다.  
타입: [InputContext](API_InputContext.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 5개.

 ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-kendraConfiguration"></a>
Amazon Kendra 인덱스에 연결하고 `AMAZON.KendraSearchIntent` 의도를 사용하는 데 필요한 구성 정보입니다.  
유형: [KendraConfiguration](API_KendraConfiguration.md)객체

 ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-lastUpdatedDate"></a>
의도가 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-name"></a>
의도의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-outputContexts"></a>
의도가 이행될 때 의도가 활성화하는 컨텍스트를 목록화하는 `OutputContext` 객체의 배열입니다.  
타입: [OutputContext](API_OutputContext.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-parentIntentSignature"></a>
이 의도의 기반이 되는 기본 제공 의도의 고유 식별자입니다.  
유형: 문자열

 ** [rejectionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-rejectionStatement"></a>
사용자가 `confirmationPrompt`에 정의된 질문에 "아니요"라고 답하면 Amazon Lex는 의도가 취소되었음을 확인하기 위해 이 문장으로 답합니다.  
유형: [Statement](API_Statement.md)객체

 ** [sampleUtterances](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-sampleUtterances"></a>
 의도에 맞게 구성된 샘플 표현 배열.  
유형: 문자열 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 1,500개.  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200입니다.

 ** [slots](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-slots"></a>
의도에 맞게 구성된 의도 슬롯 배열.  
타입: [Slot](API_Slot.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수 100개.

 ** [version](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-version"></a>
의도의 버전. 새 의도의 경우 버전은 항상 `$LATEST`입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

## Errors
<a name="API_PutIntent_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutIntent) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent) 

# PutSlotType
<a name="API_PutSlotType"></a>

사용자 지정 슬롯 유형을 생성하거나 기존 사용자 지정 슬롯 유형을 교체합니다.

사용자 정의 슬롯 유형을 생성하려면 슬롯 유형의 이름과 이 유형의 슬롯이 가정할 수 있는 값인 열거 값 세트를 지정합니다. 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md)을 참조하세요.

기존 슬롯 유형의 이름을 지정하는 경우, 요청의 필드가 슬롯 유형의 `$LATEST` 버전의 기존 값을 대체합니다. Amazon Lex는 요청에서 제공하지 않은 필드를 제거합니다. 필수 필드 값을 지정하지 않으면 Amazon Lex에서 예외가 발생합니다. 슬롯 유형의 `$LATEST` 버전을 업데이트할 때 봇이 슬롯 유형을 포함하는 의도 `$LATEST` 버전을 사용하는 경우 봇의 `status` 필드는 `NOT_BUILT`로 설정됩니다.

이 작업에는 `lex:PutSlotType` 액션에 대한 권한이 필요합니다.

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

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

다음의 URI 파라미터를 사용하여 요청합니다.

 ** [name](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-uri-name"></a>
슬롯 유형의 이름. 이름은 대/소문자를 구분하지 *않습니다*.  
이름은 기본 제공 의도 이름 또는 "AMAZON"이라고 표시된 기본 제공 의도 이름과 일치할 수 없습니다. 제거됨. 예를 들어 `AMAZON.DATE`라는 기본 제공 슬롯 유형이 있기 때문에 `DATE` 라는 사용자 지정 슬롯 유형을 생성할 수 없습니다.  
사용 가능한 기본 제공 슬롯 유형의 목록은 [Alexa Skills Kit](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)의 *슬롯 유형 참고 자료*를 참조하십시오.  
길이 제약: 최소 길이 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

## 요청 본문
<a name="API_PutSlotType_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [checksum](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-checksum"></a>
`$LATEST` 버전의 특정 개정 버전을 식별합니다.  
새 봇을 만들 때는 `checksum` 필드를 비워 두십시오. 체크섬을 지정하면 `BadRequestException` 예외가 발생합니다.  
봇을 업데이트하려면 `checksum` 필드를 해당 버전의 `$LATEST` 버전의 최신 개정의 체크섬으로 설정하십시오. ` checksum` 필드를 지정하지 않거나 체크섬이 `$LATEST` 버전과 일치하지 않으면 `PreconditionFailedException` 예외가 발생합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [createVersion](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-createVersion"></a>
`true`로 설정하면 번호가 매겨진 새 버전의 슬롯 유형이 생성됩니다. 이는 `CreateSlotTypeVersion` 작업을 호출하는 것과 같습니다. `createVersion`를 지정하지 않으면 기본값은 `false`입니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [description](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** [enumerationValues](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-enumerationValues"></a>
슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록. 각 값에는 슬롯에 대해 확인되는 값에 대해 기계 학습 모델을 훈련하는 데 도움이 되는 추가 값인 `synonyms` 목록이 있을 수 있습니다.  
정규 표현식 슬롯 유형에는 열거형 값이 필요하지 않습니다. 다른 모든 슬롯 유형에는 열거값 목록이 필요합니다.  
Amazon Lex는 슬롯 값을 확인할 때 슬롯에 사용할 수 있는 값을 최대 5개까지 포함하는 확인 목록을 생성합니다. Lambda 함수를 사용하는 경우 이 확인 목록이 함수에 전달됩니다. Lambda 함수를 사용하지 않는 경우 사용자가 입력한 값을 반환하거나 확인 목록의 첫 번째 값을 슬롯 값으로 반환하도록 선택할 수 있습니다. `valueSelectionStrategy` 필드는 사용할 옵션을 나타냅니다.  
타입: [EnumerationValue](API_EnumerationValue.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개.  
필수 여부: 아니요

 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-parentSlotTypeSignature"></a>
이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형. 상위 슬롯 유형을 정의하면 새 슬롯 유형은 상위 슬롯 유형과 구성이 모두 동일합니다.  
`AMAZON.AlphaNumeric`만 지원됩니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
필수 여부: 아니요

 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-slotTypeConfigurations"></a>
상위 기본 제공 슬롯 유형을 확장하는 구성 정보. 구성이 상위 슬롯 유형의 설정에 추가됩니다.  
타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수 10개.  
필수 여부: 아니요

 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-valueSelectionStrategy"></a>
Amazon Lex가 슬롯 유형 값을 반환하는 데 사용하는 슬롯 확인 전략을 결정합니다. 다음 값 중 하나로 필드를 설정할 수 있습니다.  
+  `ORIGINAL_VALUE` - 사용자 값이 슬롯 값과 유사한 경우 사용자가 입력한 값을 반환합니다.
+  `TOP_RESOLUTION` - 슬롯에 대한 확인 목록이 있는 경우 확인 목록의 첫 번째 값을 슬롯 유형 값으로 반환합니다. 확인 목록이 없으면 null이 반환됩니다.
`valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다.  
타입: 문자열  
유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION`   
필수 항목 여부: 아니요

## 응답 구문
<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"
}
```

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

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

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

 ** [checksum](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-checksum"></a>
슬롯 유형의 `$LATEST` 버전의 체크섬.  
유형: 문자열

 ** [createdDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createdDate"></a>
슬롯 유형이 생성된 날짜.  
유형: 타임스탬프

 ** [createVersion](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createVersion"></a>
 슬롯 유형의 새 버전이 생성된 경우 `True`. 요청에서 `createVersion` 필드를 지정하지 않은 경우 응답에서 `createVersion` 필드는 거짓으로 설정됩니다.  
유형: Boolean

 ** [description](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.

 ** [enumerationValues](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-enumerationValues"></a>
슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록.  
타입: [EnumerationValue](API_EnumerationValue.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개.

 ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-lastUpdatedDate"></a>
슬롯 유형이 업데이트된 날짜. 슬롯 유형을 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프

 ** [name](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-name"></a>
슬롯 유형의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-parentSlotTypeSignature"></a>
이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-slotTypeConfigurations"></a>
상위 기본 제공 슬롯 유형을 확장하는 구성 정보.  
타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.

 ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-valueSelectionStrategy"></a>
Amazon Lex가 슬롯 값을 결정하는 데 사용하는 슬롯 확인 전략입니다. 자세한 내용은 [PutSlotType](#API_PutSlotType) 단원을 참조하십시오.  
타입: 문자열  
유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-version"></a>
슬롯 유형의 버전. 새 슬롯 유형의 경우 버전은 항상 `$LATEST`입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

## Errors
<a name="API_PutSlotType_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** PreconditionFailedException **   
 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 412

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutSlotType) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType) 

# StartImport
<a name="API_StartImport"></a>

Amazon Lex로 리소스를 가져오는 작업을 시작합니다.

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

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartImport_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
이름이 같은 기존 리소스가 있는 경우 작업에서 수행해야 하는 `StartImport` 작업을 지정합니다.  
+ FAIL\$1ON\$1CONFLICT - 가져오기 파일의 리소스와 기존 리소스 간의 첫 번째 충돌 시 가져오기 작업이 중지됩니다. 충돌을 일으키는 리소스 이름은 `GetImport` 작업에 대한 응답 `failureReason` 필드에 있습니다.

  OVERWRITE\$1LATEST - 기존 리소스와 충돌이 있더라도 가져오기 작업이 진행됩니다. 기존 리소스의 \$1LASTEST 버전을 가져오기 파일의 데이터로 덮어씁니다.
타입: 문자열  
유효 값: `OVERWRITE_LATEST | FAIL_ON_CONFLICT`   
필수 사항 여부: 예

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
바이너리 포맷의 zip 아카이브입니다. 아카이브에는 가져올 리소스가 들어 있는 JSON 파일 한 개가 포함되어야 합니다. 리소스는 `resourceType` 필드에 지정된 유형과 일치해야 합니다.  
타입: Base64로 인코딩된 이진 데이터 객체  
필수 항목 여부: 예

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
내보내기 할 리소스 매핑의 유형을 지정합니다. 또한 각 리소스는 해당 리소스가 종속된 모든 리소스를 내보냅니다.  
+ 봇은 종속 의도를 내보냅니다.
+ 의도는 종속 슬롯 유형을 내보냅니다.
타입: 문자열  
유효 값: `BOT | INTENT | SLOT_TYPE`   
필수 사항 여부: 예

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
봇에 추가할 태그의 목록입니다. 봇을 가져올 때만 태그를 추가할 수 있으며 의도 또는 슬롯 유형에는 태그를 추가할 수 없습니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<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"
      }
   ]
}
```

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

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

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

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
가져오기 작업이 요청된 날짜와 시간에 대한 타임스탬프입니다.  
유형: 타임스탬프

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
특정 가져오기 작업의 식별자입니다.  
유형: 문자열

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
가져오기 작업의 상태입니다. 상태가 `FAILED` 인 경우 `GetImport` 작업을 사용하여 실패 원인을 확인할 수 있습니다.  
타입: 문자열  
유효 값: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
병합 충돌 발생 시 실행할 작업입니다.  
타입: 문자열  
유효 값: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
가져오기 작업의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
가져올 리소스의 유형.  
타입: 문자열  
유효 값: `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
가져온 봇에 추가된 태그의 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

## Errors
<a name="API_StartImport_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

## 참고 항목
<a name="API_StartImport_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport) 

# StartMigration
<a name="API_StartMigration"></a>

Amazon Lex V1에서 Amazon Lex V2로 봇을 마이그레이션하기 시작합니다. Amazon Lex V2의 새 기능을 활용하려고 할 때 봇을 마이그레이션하십시오.

자세한 내용은 *Amazon Lex 개발자 가이드*의 [봇 마이그레이션](https://docs.aws.amazon.com/lex/latest/dg/migrate.html)을 참조하십시오.

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

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartMigration_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
마이그레이션을 수행하는 데 사용된 전략.  
+  `CREATE_NEW` - 새 Amazon Lex V2 봇을 만들고 Amazon Lex V1 봇을 새 봇으로 마이그레이션합니다.
+  `UPDATE_EXISTING` - 기존 Amazon Lex V2 봇 메타데이터와 마이그레이션 중인 로캘을 덮어씁니다. Amazon Lex V2 봇의 다른 로캘은 변경되지 않습니다. 로캘이 존재하지 않는 경우 Amazon Lex V2 봇에 새 로캘이 생성됩니다.
타입: 문자열  
유효 값: `CREATE_NEW | UPDATE_EXISTING`   
필수 사항 여부: 예

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
Amazon Lex V2로 마이그레이션할 수 있는 봇의 버전입니다. 번호가 매겨진 모든 `$LATEST` 버전뿐만 아니라 버전도 마이그레이션할 수 있습니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 예

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1 봇의 이름.  
+ Amazon Lex V2 봇이 없는 경우 `CREATE_NEW` 마이그레이션 전략을 사용해야 합니다.
+ Amazon Lex V2 봇이 있는 경우 `UPDATE_EXISTING` 마이그레이션 전략을 사용하여 Amazon Lex V2 봇의 콘텐츠를 변경해야 합니다.
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([0-9a-zA-Z][_-]?)+$`   
필수 여부: 예

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
Amazon Lex가 Amazon Lex V2 봇을 실행하는 데 사용하는 IAM 역할.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
필수 여부: 예

## 응답 구문
<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"
}
```

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

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

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

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
Amazon Lex가 마이그레이션에 할당한 고유 식별자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
마이그레이션을 수행하는 데 사용된 전략.  
타입: 문자열  
유효 값: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
마이그레이션이 시작된 날짜와 시간.  
유형: 타임스탬프

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
Amazon Lex V1 봇에 사용되는 로캘입니다.  
타입: 문자열  
유효 값: `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>
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
Amazon Lex V2로 마이그레이션할 수 있는 봇의 버전입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
Amazon Lex V2 봇의 고유 식별자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
Amazon Lex가 Amazon Lex V2 봇을 실행하는 데 사용하는 IAM 역할.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

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

 ** AccessDeniedException **   
IAM 사용자 또는 역할에는 봇을 마이그레이션하는 데 필요한 Amazon Lex V2 API를 호출할 권한이 없습니다.  
HTTP 상태 코드: 403

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration) 

# TagResource
<a name="API_TagResource"></a>

지정된 태그를 지정된 리소스에 추가합니다. 태그 키가 이미 존재하는 경우 기존 값이 새 값으로 대체됩니다.

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

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

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

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

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-uri-resourceArn"></a>
태그할 봇, 봇 별칭 또는 봇 채널의 Amazon 리소스 이름(ARN) 입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1011입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_TagResource_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-tags"></a>
리소스에 추가할 태그 키 목록입니다. 태그 키가 이미 존재하는 경우 기존 값이 새 값으로 대체됩니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 항목 여부: 예

## 응답 구문
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

## Errors
<a name="API_TagResource_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/TagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

봇, 봇 별칭 또는 봇 채널에서 태그를 제거합니다.

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

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

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

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

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-resourceArn"></a>
태그를 제거할 리소스의 Amazon 리소스 이름(ARN)입니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1011입니다.  
필수 항목 여부: 예

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-tagKeys"></a>
리소스에서 제거할 태그 키의 목록입니다. 리소스에 태그 키가 없으면 무시됩니다.  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수 200개.  
길이 제약: 최소 길이 1. 최대 길이는 128.  
필수 여부: 예

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

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

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

## Errors
<a name="API_UntagResource_Errors"></a>

 ** BadRequestException **   
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ConflictException **   
 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 409

 ** InternalFailureException **   
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청이 한도를 초과했습니다. 다시 요청해 보세요.  
HTTP 상태 코드: 429

 ** NotFoundException **   
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.  
HTTP 상태 코드: 404

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/UntagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UntagResource) 

# Amazon Lex 런타임 서비스
<a name="API_Operations_Amazon_Lex_Runtime_Service"></a>

다음 작업이 Amazon Lex 런타임 서비스에서 지원됩니다.
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# DeleteSession
<a name="API_runtime_DeleteSession"></a>

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

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

```
DELETE /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
```

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

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

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

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

 ** [userId](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-userId"></a>
세션 데이터와 연결된 사용자의 식별자입니다.  
길이 제약: 최소 길이는 2. 최대 길이는 100.  
패턴: `[0-9a-zA-Z._:-]+`   
필수 여부: 예

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

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

## Response Syntax
<a name="API_runtime_DeleteSession_ResponseSyntax"></a>

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

{
   "botAlias": "string",
   "botName": "string",
   "sessionId": "string",
   "userId": "string"
}
```

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

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

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

 ** [botAlias](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botAlias"></a>
세션 데이터와 연결된 봇에 사용되는 별칭입니다.  
유형: 문자열

 ** [botName](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botName"></a>
세션 데이터와 연결된 봇 이름.  
유형: 문자열

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

 ** [userId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-userId"></a>
클라이언트 애플리케이션 사용자의 ID입니다.  
유형: 문자열  
길이 제약: 최소 길이는 2. 최대 길이는 100.  
패턴: `[0-9a-zA-Z._:-]+` 

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

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

 ** ConflictException **   
 두 클라이언트가 동일한 AWS 계정, Amazon Lex 봇 및 사용자 ID를 사용하고 있습니다.  
HTTP 상태 코드: 409

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

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

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

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DeleteSession) 

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

# PostContent
<a name="API_runtime_PostContent"></a>

 Amazon Lex에 사용자 입력(텍스트 또는 스피치)을 전송합니다. 클라이언트는 이 API를 사용하여 런타임에 Amazon Lex에 텍스트 및 오디오 요청을 보냅니다. Amazon Lex는 봇용으로 구축한 기계 학습 모델을 사용하여 사용자 입력을 해석합니다.

`PostContent` 작업은 8kHz 및 16kHz에서 오디오 입력을 지원합니다. 전화 오디오 애플리케이션에서 8kHz 오디오를 사용하여 음성 인식 정확도를 높일 수 있습니다.

 이에 대한 응답으로 Amazon Lex는 사용자에게 전달할 다음 메시지를 반환합니다. 다음 예제를 검토하십시오.
+  사용자가 "피자를 먹고 싶어요"라고 입력하면 Amazon Lex는 슬롯 데이터(예: `PizzaSize`: "어떤 피자 크기를 원하시나요?")를 유도하는 메시지가 포함된 응답을 반환할 수 있습니다.
+  사용자가 모든 피자 주문 정보를 제공한 후 Amazon Lex는 "피자를 주문하시겠습니까?"라는 사용자 확인 메시지가 포함된 응답을 반환할 수 있습니다.
+  사용자가 확인 메시지에 "예"라고 응답하면 Amazon Lex에서 "감사합니다. 치즈 피자를 주문했습니다."라는 결론을 반환할 수 있습니다.

 모든 Amazon Lex 메시지에 사용자의 응답이 필요한 것은 아닙니다. 예를 들어, 결론문에는 응답이 필요하지 않습니다. 일부 메시지에는 예 또는 아니오 응답만 필요합니다. Amazon Lex는 `message` 외에도 적절한 클라이언트 사용자 인터페이스를 표시하는 등 클라이언트 동작을 개선하는 데 사용할 수 있는 메시지에 대한 추가 컨텍스트를 제공합니다. 다음 예제를 살펴보세요.
+  메시지가 슬롯 데이터를 끌어내라는 것이면 Amazon Lex는 다음 컨텍스트 정보를 반환합니다.
  +  `x-amz-lex-dialog-state` 헤더는 `ElicitSlot`로 설정되었습니다.
  +  `x-amz-lex-intent-name` 현재 컨텍스트의 의도 이름으로 설정된 헤더 
  +  `x-amz-lex-slot-to-elicit` 헤더는 `message`가 정보를 이끌어내는 슬롯 이름으로 설정됩니다.
  +  `x-amz-lex-slots` 헤더는 현재 값을 사용하여 의도에 맞게 구성된 슬롯의 맵으로 설정됩니다.
+  메시지가 확인 프롬프트인 경우 `x-amz-lex-dialog-state` 헤더는 `Confirmation`로 설정되고 `x-amz-lex-slot-to-elicit` 헤더는 생략됩니다.
+  메시지가 의도에 맞게 구성된 설명 프롬프트로서 사용자 의도를 이해할 수 없음을 나타내는 경우 `x-amz-dialog-state`헤더는 `ElicitIntent`로 설정되고 `x-amz-slot-to-elicit` 헤더는 생략됩니다. 

 또한 Amazon Lex는 애플리케이션별 `sessionAttributes` 정보도 반환합니다. 자세한 내용은 [대화 컨텍스트 관리](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html)를 참조하십시오.

## Request Syntax
<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
```

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

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

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 이것은 `Accept` HTTP 헤더의 값으로 전달됩니다.  
 Amazon Lex가 응답에서 반환하는 메시지는 요청의 `Accept` HTTP 헤더 값을 기반으로 하는 텍스트 또는 음성일 수 있습니다.  
+  값이 `text/plain; charset=utf-8`인 경우 Amazon Lex는 응답에서 텍스트를 반환합니다.
+  값이 `audio/`로 시작하는 경우 Amazon Lex는 응답으로 음성을 반환합니다. Amazon Lex는 Amazon Polly를 사용하여 음성을 생성합니다 (`Accept` 헤더에 지정한 구성 사용). 예를 들어 값을 `audio/mpeg`로 지정하면 Amazon Lex는 음성을 MPEG 형식으로 반환합니다.
+ 값이 `audio/pcm`인 경우 반환되는 음성은 16비트 리틀 엔디안 형식의 `audio/pcm`입니다.
+ 허용되는 값은 다음과 같습니다.
  + 오디오/mpeg
  + 오디오/ogg
  + 오디오/pcm
  + 텍스트/플레인, 문자셋=utf-8
  + audio/\$1 (기본값은 mpeg)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
요청에 대해 활성화된 컨텍스트 목록. 이전 의도가 이행될 때 또는 요청에 컨텍스트를 포함시켜 컨텍스트를 활성화할 수 있습니다.  
컨텍스트 목록을 지정하지 않으면 Amazon Lex는 세션의 현재 컨텍스트 목록을 사용합니다. 빈 목록을 지정하면 세션의 모든 컨텍스트가 지워집니다.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
Amazon Lex 봇의 별칭  
필수 항목 여부: 예

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
Amazon Lex 봇의 이름.  
필수 항목 여부: 예

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 이것은 `Content-Type` HTTP 헤더의 값으로 전달됩니다.  
 오디오 형식 또는 텍스트를 나타냅니다. 헤더 값은 다음 접두사 중 하나로 시작해야 합니다.  
+ PCM 형식의 오디오 데이터는 리틀 엔디안 바이트 순서여야 합니다.
  + 오디오/l16, 속도=16000, 채널=1
  + 오디오/x-l16, 샘플-레이트=16000, 채널-수=1
  + 오디오/lpcm, 샘플-레이트=8000, 샘플-크기-비트=16, 채널-수=1, is-big-endian=거짓 
+ Opus 포맷
  + 오디오/x-cbr-opus-with 프리앰블, 프리앰블-크기=0, 비트-레이트=256000, 프레임-크기-밀리초=4
+ 날짜 형식
  + 텍스트/플레인, 문자셋=utf-8
필수 항목 여부: 예

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
이것은 `x-amz-lex-request-attributes` HTTP 헤더의 값으로 전달됩니다.  
Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보. 값은 문자열 키와 값이 있는 JSON으로 직렬화되고 base64로 인코딩된 맵이어야 합니다. `requestAttributes` 및 `sessionAttributes` 헤더의 총 크기는 12KB로 제한됩니다.  
네임스페이스 `x-amz-lex:`는 특수 속성용으로 남겨둡니다. 접두사 `x-amz-lex:`를 사용하여 요청 속성을 생성하지 마세요.  
요청 속성에 대한 자세한 내용은 [요청 속성 설정](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>
이것은 `x-amz-lex-session-attributes` HTTP 헤더의 값으로 전달됩니다.  
Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보. 값은 문자열 키와 값이 있는 JSON으로 직렬화되고 base64로 인코딩된 맵이어야 합니다. `sessionAttributes` 및 `requestAttributes` 헤더의 총 크기는 12KB로 제한됩니다.  
요청 속성에 대한 자세한 내용은 [요청 속성 설정](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>
클라이언트 애플리케이션 사용자의 ID입니다. Amazon Lex는 이를 사용하여 사용자와 봇의 대화를 식별합니다. 런타임 시 각 요청에는 `userID` 필드가 포함되어야 합니다.  
애플리케이션에 사용할 사용자 ID를 결정하려면 다음 요소를 고려하십시오.  
+ `userID` 필드에는 사용자의 개인 식별 정보 (예: 이름, 개인 식별 번호 또는 기타 최종 사용자 개인 정보)가 포함되어서는 안 됩니다.
+ 사용자가 한 기기에서 대화를 시작하고 다른 기기에서 계속하도록 하려면 사용자별 식별자를 사용하세요.
+ 동일한 사용자가 서로 다른 두 기기에서 독립적인 대화를 두 번 할 수 있게 하려면 기기별 식별자를 선택하세요.
+ 사용자는 같은 봇의 서로 다른 두 가지 버전과 독립적인 대화를 두 번 할 수 없습니다. 예를 들어 사용자는 동일한 봇의 PROD 및 BETA 버전과 대화할 수 없습니다. 예를 들어 테스트 중에 사용자가 서로 다른 두 버전과 대화해야 할 것으로 예상되는 경우 사용자 ID에 봇 별칭을 포함하여 두 대화를 구분하십시오.
길이 제약: 최소 길이는 2. 최대 길이는 100.  
패턴: `[0-9a-zA-Z._:-]+`   
필수 여부: 예

## 요청 본문
<a name="API_runtime_PostContent_RequestBody"></a>

요청은 다음의 이진 데이터를 허용합니다.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 `Content-Type` HTTP 헤더에 설명된 대로 PCM 또는 Opus 오디오 형식 또는 텍스트 형식의 사용자 입력입니다.  
오디오 데이터를 Amazon Lex로 스트리밍하거나 오디오 데이터를 전송하기 전에 모든 오디오 데이터를 캡처하는 로컬 버퍼를 생성할 수 있습니다. 일반적으로 로컬에서 데이터를 버퍼링하는 대신 오디오 데이터를 스트리밍하면 성능이 향상됩니다.  
필수 사항 여부: 예

## 응답 구문
<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
```

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

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

응답에 다음 HTTP 헤더가 반환됩니다.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
세션에 대해 활성화된 컨텍스트 목록. 의도가 이행될 때 또는 `PostContent`, `PostText`, 또는 `PutSession` 작업을 호출하여 컨텍스트를 설정할 수 있습니다.  
컨텍스트를 사용하여 의도를 추적할 수 있는 의도를 제어하거나 애플리케이션 작업을 수정할 수 있습니다.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
사용자의 의도에 적용할 수 있는 1\$14개의 대체 의도.  
각 대안에는 Amazon Lex가 의도가 사용자의 의도와 일치한다고 얼마나 확신하는 지를 나타내는 점수가 포함되어 있습니다. 의도는 신뢰도 점수를 기준으로 정렬됩니다.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
대화에 응답한 봇의 버전입니다. 이 정보를 사용하여 한 버전의 봇이 다른 버전보다 성능이 좋은지 확인할 수 있습니다.  
길이 제약: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
요청의 `Accept` HTTP 헤더에 지정된 콘텐츠 유형입니다.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
사용자 상호 작용의 현재 상태를 식별합니다. Amazon Lex는 다음 값 중 하나를 `dialogState`로 반환합니다. 클라이언트는 선택적으로 이 정보를 사용하여 사용자 인터페이스를 사용자 정의할 수 있습니다.  
+  `ElicitIntent` - Amazon Lex는 사용자의 의도를 이끌어내고자 합니다. 다음 예제를 살펴보세요.

   예를 들어, 사용자가 의도 ("피자를 주문하고 싶어요")를 말할 수 있습니다. Amazon Lex가 이 발언에서 사용자 의도를 유추할 수 없는 경우 이 대화상자 상태를 반환합니다.
+  `ConfirmIntent` - Amazon Lex는 "예" 또는 "아니요"라는 응답을 기대하고 있습니다.

  예를 들어 Amazon Lex는 의도를 이행하기 전에 사용자 확인을 원합니다. 사용자는 단순한 "예" 또는 "아니요" 응답 대신 추가 정보로 응답할 수 있습니다. 예를 들어 "네, 하지만 두꺼운 크러스트 피자로 만드세요" 또는 "아니요, 음료를 주문하고 싶어요." Amazon Lex는 이러한 추가 정보를 처리할 수 있습니다(이 예시에서는 크러스트 유형 슬롯을 업데이트하거나 의도를 OrderPizza에서 OrderDrink로 변경).
+  `ElicitSlot` - Amazon Lex는 현재 의도에 사용할 슬롯의 값을 예상하고 있습니다.

   예를 들어 Amazon Lex가 응답에서 "어떤 크기의 피자를 원하시나요?" 라는 메시지를 보낸다고 가정해 보겠습니다. 사용자가 슬롯 값(예: "중간")으로 응답할 수 있습니다. 사용자는 응답 시 추가 정보(예: "중간 두께의 크러스트 피자") 를 제공할 수도 있습니다. Amazon Lex는 이러한 추가 정보를 적절하게 처리할 수 있습니다.
+  `Fulfilled` - Lambda 함수가 의도를 성공적으로 수행했음을 전달합니다.
+  `ReadyForFulfillment` - 클라이언트가 요청을 이행해야 함을 전달합니다.
+  `Failed` - 사용자와의 대화가 실패했음을 전달합니다.

   이는 사용자가 서비스의 프롬프트에 적절한 응답을 제공하지 않는 경우(Amazon Lex가 사용자에게 특정 정보를 요청할 수 있는 횟수를 구성할 수 있음) 또는 Lambda 함수가 의도를 이행하지 못하는 경우를 포함하여 다양한 이유로 발생할 수 있습니다.
유효한 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
요청을 처리하는 데 사용되는 텍스트입니다.  
입력이 오디오 스트림인 경우 `encodedInputTranscript` 필드에는 오디오 스트림에서 추출한 텍스트가 포함됩니다. 이 텍스트는 의도 및 슬롯 값을 인식하기 위해 실제로 처리되는 텍스트입니다. 이 정보를 사용하여 Amazon Lex가 전송되는 오디오를 올바르게 처리하고 있는지 확인할 수 있습니다.  
`encodedInputTranscript` 필드는 base-64로 인코딩됩니다. 값을 사용하려면 먼저 필드를 디코딩해야 합니다.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
사용자에게 전달하는 메시지입니다. 메시지는 봇의 구성 또는 Lambda 함수에서 올 수 있습니다.  
의도가 Lambda 함수로 구성되지 않았거나 Lambda 함수가 응답으로 `Delegate`을 `dialogAction.type`로 반환하는 경우, Amazon Lex는 다음 액션 코스를 결정하고 현재 상호 작용 컨텍스트를 기반으로 봇의 구성에서 적절한 메시지를 선택합니다. 예를 들어 Amazon Lex가 사용자 입력을 이해할 수 없는 경우 설명 프롬프트 메시지를 사용합니다.  
의도를 생성하면 그룹에 메시지를 할당할 수 있습니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지를 하나씩 반환합니다. 메시지 필드는 메시지가 포함된 이스케이프된 JSON 문자열입니다. 반환된 JSON 문자열의 구조에 대한 자세한 내용은 [지원되는 메시지 형식](howitworks-manage-prompts.md#msg-prompts-formats)을 참조하세요.  
Lambda 함수가 메시지를 반환하면 Amazon Lex는 응답으로 이를 클라이언트에 전달합니다.  
`encodedMessage` 필드는 base-64로 인코딩됩니다. 값을 사용하려면 먼저 필드를 디코딩해야 합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1,366입니다.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *이 헤더는 더 이상 사용되지 않습니다.*  
요청을 처리하는 데 사용되는 텍스트입니다.  
이 필드는 de-de, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR 및 it-IT 로캘에서만 사용할 수 있습니다. 다른 모든 로캘에서는 이 `inputTranscript` 필드가 null입니다. 대신에 `encodedInputTranscript` 필드를 사용해야 합니다.  
입력이 오디오 스트림인 경우 `inputTranscript` 필드에는 오디오 스트림에서 추출한 텍스트가 포함됩니다. 이 텍스트는 의도 및 슬롯 값을 인식하기 위해 실제로 처리되는 텍스트입니다. 이 정보를 사용하여 Amazon Lex가 전송되는 오디오를 올바르게 처리하고 있는지 확인할 수 있습니다.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
Amazon Lex가 알고 있는 현재 사용자 의도를 나타냅니다.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *이 헤더는 더 이상 사용되지 않습니다.*  
이 필드는 de-de, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR 및 it-IT 로캘에서만 사용할 수 있습니다. 다른 모든 로캘에서는 이 `message` 필드가 null입니다. 대신에 `encodedMessage` 필드를 사용해야 합니다.  
사용자에게 전달하는 메시지입니다. 메시지는 봇의 구성 또는 Lambda 함수에서 올 수 있습니다.  
의도가 Lambda 함수로 구성되지 않았거나 Lambda 함수가 응답으로 `Delegate`을 `dialogAction.type`로 반환하는 경우, Amazon Lex는 다음 액션 코스를 결정하고 현재 상호 작용 컨텍스트를 기반으로 봇의 구성에서 적절한 메시지를 선택합니다. 예를 들어 Amazon Lex가 사용자 입력을 이해할 수 없는 경우 설명 프롬프트 메시지를 사용합니다.  
의도를 생성하면 그룹에 메시지를 할당할 수 있습니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지를 하나씩 반환합니다. 메시지 필드는 메시지가 포함된 이스케이프된 JSON 문자열입니다. 반환된 JSON 문자열의 구조에 대한 자세한 내용은 [지원되는 메시지 형식](howitworks-manage-prompts.md#msg-prompts-formats)을 참조하세요.  
Lambda 함수가 메시지를 반환하면 Amazon Lex는 응답으로 이를 클라이언트에 전달합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1,024.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
응답 메시지의 형식. 다음 값 중 하나입니다.  
+  `PlainText` - 메시지에 일반 UTF-8 텍스트가 포함됩니다.
+  `CustomPayload` - 메시지는 클라이언트의 사용자 지정 형식입니다.
+  `SSML` - 메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.
+  `Composite` - 메시지에는 의도 생성 시 메시지가 할당된 그룹의 메시지가 하나 이상 포함된 이스케이프된 JSON 개체가 포함되어 있습니다.
유효한 값: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Amazon Lex가 반환된 의도가 사용자의 의도와 일치한다고 얼마나 확신하는지 나타내는 점수를 제공합니다. 점수는 0.0\$11.0 사이입니다.  
점수는 상대 점수이며 절대 점수가 아닙니다. 점수는 Amazon Lex의 개선 사항에 따라 변경될 수 있습니다.

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
감정이 하나의 표현으로 표현되었습니다.  
봇이 감정 분석을 위해 Amazon Comprehend로 표현을 보내도록 구성된 경우 이 필드에 분석 결과가 포함됩니다.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 세션별 컨텍스트 정보를 나타내는 키/값 페어의 맵입니다.

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
세션의 고유 식별자입니다.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Amazon Lex가 대화 중 사용자 입력에서 감지한 0개 이상의 의도 슬롯(이름/값 페어) 맵입니다. 필드는 base-64로 인코딩됩니다.  
Amazon Lex는 슬롯에 대한 예상 값을 가진 해결 목록을 생성합니다. 반환되는 값은 슬롯 유형이 생성되거나 업데이트될 때 선택된 `valueSelectionStrategy`에 따라 결정됩니다. `valueSelectionStrategy`을 `ORIGINAL_VALUE`로 설정하면 사용자 값이 슬롯 값과 유사한 경우 사용자가 제공한 값이 반환됩니다. `valueSelectionStrategy`가 `TOP_RESOLUTION`로 설정된 경우, Amazon Lex는 해결 목록의 첫 번째 값을 반환하고, 해결 목록이 없는 경우 null을 반환합니다. `valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 `dialogState`값이 `ElicitSlot`인 경우 Amazon Lex가 값을 추출하는 슬롯의 이름을 반환합니다.

응답은 다음 내용을 HTTP 본문으로 반환합니다.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
사용자에게 전달할 프롬프트(또는 명령문). 이는 봇 구성 및 컨텍스트를 기반으로 합니다. 예를 들어 Amazon Lex가 사용자 의도를 이해하지 못한 경우 봇을 위해 구성된 `clarificationPrompt`을 보냅니다. 이행 작업을 수행하기 전에 의도에서 확인이 필요한 경우 `confirmationPrompt`를 보냅니다. 또 다른 예: Lambda 함수가 의도를 성공적으로 수행하고 사용자에게 전달할 메시지를 보냈다고 가정해 보겠습니다. 그러면 Amazon Lex가 응답으로 해당 메시지를 보냅니다.

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

 ** BadGatewayException **   
Amazon Lex 봇이 아직 구축 중이거나 종속 서비스 중 하나(Amazon Polly, AWS Lambda) 가 내부 서비스 오류로 인해 장애가 발생했습니다.  
HTTP 상태 코드: 502

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

 ** ConflictException **   
 두 클라이언트가 동일한 AWS 계정, Amazon Lex 봇 및 사용자 ID를 사용하고 있습니다.  
HTTP 상태 코드: 409

 ** DependencyFailedException **   
 AWS Lambda 또는 Amazon Polly와 같은 종속 서비스 중 하나에서 예외가 발생했습니다. 예를 들어,   
+ Amazon Lex에 Lambda 함수를 호출할 수 있는 충분한 권한이 없는 경우.
+ Lambda 함수를 실행하는 데 30초 이상 걸리는 경우.
+ 이행 Lambda 함수가 슬롯 값을 제거하지 않고 `Delegate` 대화 작업을 반환하는 경우.
HTTP 상태 코드: 424

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

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

 ** LoopDetectedException **   
이 예외는 사용되지 않습니다.  
HTTP 상태 코드: 508

 ** NotAcceptableException **   
요청의 수락 헤더에 유효한 값이 없습니다.  
HTTP 상태 코드: 406

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

 ** RequestTimeoutException **   
입력 음성이 너무 깁니다.  
HTTP 상태 코드: 408

 ** UnsupportedMediaTypeException **   
콘텐츠 유형 헤더(`PostContent`API)에 유효하지 않은 값이 있습니다.  
HTTP 상태 코드: 415

## 예제
<a name="API_runtime_PostContent_Examples"></a>

### 예제 1.
<a name="API_runtime_PostContent_Example_1"></a>

 이 요청에서 URI는 봇(트래픽), 봇 버전(\$1LATEST) 및 최종 사용자 이름(일부 사용자)을 식별합니다. `Content-Type` 헤더는 본문의 오디오 형식을 식별합니다. Amazon Lex는 다른 형식도 지원합니다. 필요한 경우 SoX 오픈 소스 소프트웨어를 사용하여 오디오를 한 형식에서 다른 형식으로 변환할 수 있습니다. `Accept` HTTP 헤더를 추가하여 응답을 받을 형식을 지정합니다.

 응답의 `x-amz-lex-message` 헤더에는 Amazon Lex가 반환한 응답이 표시됩니다. 그러면 클라이언트는 이 응답을 사용자에게 보낼 수 있습니다. 청크 인코딩을 통해 동일한 메시지가 오디오/MPEG 형식으로 전송됩니다(요청에 따라).

#### 샘플 요청
<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]"
…
```

#### 샘플 응답
<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
…
```

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 

# PostText
<a name="API_runtime_PostText"></a>

Amazon Lex에 사용자 입력을 전송합니다. 클라이언트 애플리케이션은 이 API를 사용하여 런타임에 Amazon Lex에 요청을 보낼 수 있습니다. Amazon Lex는 봇용으로 구축한 기계 학습 모델을 사용하여 사용자 입력을 해석합니다.

 이에 대한 응답으로 Amazon Lex는 다음 `message`을 반환하여 표시할 선택적 `responseCard`를 사용자에게 전달합니다. 다음 예제를 검토하십시오.
+  사용자가 "피자를 먹고 싶어요"라고 입력하면 Amazon Lex는 슬롯 데이터(예: PizzaSize: "어떤 피자 크기를 원하시나요?")를 유도하는 메시지가 포함된 응답을 반환할 수 있습니다.
+  사용자가 모든 피자 주문 정보를 제공한 후 Amazon Lex는 사용자 확인을 얻기 위해 "피자 주문을 진행하시겠습니까?"라는 메시지와 함께 응답을 반환할 수 있습니다.
+  사용자가 확인 프롬프트에 "예"라고 응답하면 Amazon Lex에서 "감사합니다. 치즈 피자가 주문되었습니다."라는 결론문을 반환할 수 있습니다.

 모든 Amazon Lex 메시지에 사용자의 응답이 필요한 것은 아닙니다. 예를 들어, 결론문에는 응답이 필요하지 않습니다. 일부 메시지에는 "예" 또는 "아니오" 응답만 필요합니다. Amazon Lex는 `message` 외에도, 예를 들어, 적절한 클라이언트 사용자 인터페이스를 표시하는 등 클라이언트 동작을 개선하는 데 사용할 수 있는 메시지에 대한 추가 컨텍스트를 제공합니다. 응답의`slotToElicit`, `dialogState`, `intentName`, 및 `slots` 필드는 다음과 같습니다. 다음 예제를 살펴보세요.
+ 메시지가 슬롯 데이터를 끌어내라는 것이면 Amazon Lex는 다음 컨텍스트 정보를 반환합니다.
  +  `dialogState`을 ElicitSlot으로 설정합니다.
  +  `intentName`을 현재 컨텍스트의 의도 이름으로 설정합니다.
  +  `slotToElicit`은 `message`가 정보를 이끌어내는 슬롯 이름으로 설정됩니다.
  +  `slots`은 현재 알려진 값을 사용하여 의도에 맞게 구성된 슬롯의 맵으로 설정됩니다.
+  메시지가 확인 프롬프트인 경우, `dialogState`는 ConfirmIntent로 설정되고 `SlotToElicit`는 null로 설정됩니다.
+ 메시지가 사용자 의도가 이해되지 않았음을 나타내는 설명 프롬프트(의도에 대해 구성됨)인 경우 `dialogState`은 ElicitIntent로 설정되고 `slotToElicit`는 null로 설정됩니다.

 또한 Amazon Lex는 애플리케이션별 `sessionAttributes` 정보도 반환합니다. 자세한 내용은 [대화 컨텍스트 관리](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html)를 참조하십시오.

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

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

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

 ** [botAlias](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botAlias"></a>
Amazon Lex 봇의 별칭.  
필수 항목 여부: 예

 ** [botName](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botName"></a>
Amazon Lex 봇의 이름.  
필수 항목 여부: 예

 ** [userId](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-userId"></a>
클라이언트 애플리케이션 사용자의 ID입니다. Amazon Lex는 이를 사용하여 사용자와 봇의 대화를 식별합니다. 런타임 시 각 요청에는 `userID` 필드가 포함되어야 합니다.  
애플리케이션에 사용할 사용자 ID를 결정하려면 다음 요소를 고려하십시오.  
+ `userID` 필드에는 사용자의 개인 식별 정보 (예: 이름, 개인 식별 번호 또는 기타 최종 사용자 개인 정보)가 포함되어서는 안 됩니다.
+ 사용자가 한 기기에서 대화를 시작하고 다른 기기에서 계속하도록 하려면 사용자별 식별자를 사용하세요.
+ 동일한 사용자가 서로 다른 두 기기에서 독립적인 대화를 두 번 할 수 있게 하려면 기기별 식별자를 선택하세요.
+ 사용자는 같은 봇의 서로 다른 두 가지 버전과 독립적인 대화를 두 번 할 수 없습니다. 예를 들어 사용자는 동일한 봇의 PROD 및 BETA 버전과 대화할 수 없습니다. 예를 들어 테스트 중에 사용자가 서로 다른 두 버전과 대화해야 할 것으로 예상되는 경우 사용자 ID에 봇 별칭을 포함하여 두 대화를 구분하십시오.
길이 제약: 최소 길이는 2. 최대 길이는 100.  
패턴: `[0-9a-zA-Z._:-]+`   
필수 여부: 예

## 요청 본문
<a name="API_runtime_PostText_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [activeContexts](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-activeContexts"></a>
요청에 대해 활성화된 컨텍스트 목록. 이전 의도가 이행될 때 또는 요청에 컨텍스트를 포함시켜 컨텍스트를 활성화할 수 있습니다.  
컨텍스트 목록을 지정하지 않으면 Amazon Lex는 세션의 현재 컨텍스트 목록을 사용합니다. 빈 목록을 지정하면 세션의 모든 컨텍스트가 지워집니다.  
타입: [ActiveContext](API_runtime_ActiveContext.md)객체 배열  
배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.  
필수 여부: 아니요

 ** [inputText](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-inputText"></a>
사용자가 입력한 텍스트(Amazon Lex는 이 텍스트를 해석함).  
AWS CLI를 사용하는 경우 `--input-text` 파라미터에 URL을 전달할 수 없습니다. 대신 `--cli-input-json` 파라미터를 사용하여 URL을 전달하십시오.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 1,024.  
필수 항목 여부: 예

 ** [requestAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-requestAttributes"></a>
Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보.  
네임스페이스 `x-amz-lex:`는 특수 속성용으로 남겨둡니다. 접두사 `x-amz-lex:`를 사용하여 요청 속성을 생성하지 마세요.  
요청 속성에 대한 자세한 내용은 [요청 속성 설정](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs)을 참조하십시오.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-sessionAttributes"></a>
Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보.  
요청 속성에 대한 자세한 내용은 [요청 속성 설정](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs)을 참조하십시오.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<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"
}
```

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

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

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

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

 ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-alternativeIntents"></a>
사용자의 의도에 적용할 수 있는 1\$14개의 대체 의도.  
각 대안에는 Amazon Lex가 의도가 사용자의 의도와 일치한다고 얼마나 확신하는 지를 나타내는 점수가 포함되어 있습니다. 의도는 신뢰도 점수를 기준으로 정렬됩니다.  
타입: [PredictedIntent](API_runtime_PredictedIntent.md)객체 배열  
배열 멤버: 최대 항목 수는 4개입니다.

 ** [botVersion](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-botVersion"></a>
대화에 응답한 봇의 버전입니다. 이 정보를 사용하여 한 버전의 봇이 다른 버전보다 성능이 좋은지 확인할 수 있습니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `[0-9]+|\$LATEST` 

 ** [dialogState](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-dialogState"></a>
 사용자 상호 작용의 현재 상태를 식별합니다. Amazon Lex는 다음 값 중 하나를 `dialogState`로 반환합니다. 클라이언트는 선택적으로 이 정보를 사용하여 사용자 인터페이스를 사용자 정의할 수 있습니다.  
+  `ElicitIntent` - Amazon Lex는 사용자의 의도를 이끌어내고자 합니다.

  예를 들어, 사용자가 의도("피자를 주문하고 싶어요")를 말할 수 있습니다. Amazon Lex가 이 표현에서 사용자 의도를 유추할 수 없는 경우 이 dialogState를 반환합니다.
+  `ConfirmIntent` - Amazon Lex는 "예" 또는 "아니요"라는 응답을 기대하고 있습니다.

   예를 들어 Amazon Lex는 의도를 이행하기 전에 사용자 확인을 원합니다.

  사용자는 단순한 "예" 또는 "아니요" 대신 추가 정보로 응답할 수 있습니다. 예를 들어 "네, 하지만 두꺼운 크러스트 피자로 만드세요" 또는 "아니요, 음료를 주문하고 싶어요." Amazon Lex는 이러한 추가 정보를 처리할 수 있습니다(이 예시에서는 크러스트 유형 슬롯을 업데이트하거나 의도를 OrderPizza에서 OrderDrink로 변경).
+  `ElicitSlot` - Amazon Lex는 현재 의도에 사용할 슬롯의 값을 예상하고 있습니다.

  예를 들어 Amazon Lex가 응답에서 "어떤 크기의 피자를 원하시나요?"라는 메시지를 보낸다고 가정해 보겠습니다. 사용자가 슬롯 값(예: "중간")으로 응답할 수 있습니다. 사용자는 응답 시 추가 정보(예: "중간 두께의 크러스트 피자") 를 제공할 수도 있습니다. Amazon Lex는 이러한 추가 정보를 적절하게 처리할 수 있습니다.
+  `Fulfilled` - 의도에 대해 구성된 Lambda 함수가 성공적으로 이행되었음을 전달합니다.
+  `ReadyForFulfillment` - 클라이언트가 의도를 이행해야 한다는 것을 전달합니다.
+  `Failed` - 사용자와의 대화가 실패했음을 전달합니다.

   이는 사용자가 서비스의 프롬프트에 적절한 응답을 제공하지 않았거나(Amazon Lex가 사용자에게 특정 정보에 대한 메시지를 표시할 수 있는 횟수를 구성할 수 있음) Lambda 함수가 의도를 이행하지 못한 경우 등 다양한 이유로 발생할 수 있습니다.
타입: 문자열  
유효 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [intentName](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-intentName"></a>
Amazon Lex가 알고 있는 현재 사용자 의도를 나타냅니다.  
유형: 문자열

 ** [message](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-message"></a>
사용자에게 전달하는 메시지입니다. 메시지는 봇의 구성 또는 Lambda 함수에서 올 수 있습니다.  
의도가 Lambda 함수로 구성되지 않았거나 Lambda 함수가 응답으로 `Delegate`을 `dialogAction.type`로 반환하는 경우, Amazon Lex는 다음 액션 코스를 결정하고 현재 상호 작용 컨텍스트를 기반으로 봇의 구성에서 적절한 메시지를 선택합니다. 예를 들어 Amazon Lex가 사용자 입력을 이해할 수 없는 경우 설명 프롬프트 메시지를 사용합니다.  
의도를 생성하면 그룹에 메시지를 할당할 수 있습니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지를 하나씩 반환합니다. 메시지 필드는 메시지가 포함된 이스케이프된 JSON 문자열입니다. 반환된 JSON 문자열의 구조에 대한 자세한 내용은 [지원되는 메시지 형식](howitworks-manage-prompts.md#msg-prompts-formats)을 참조하세요.  
Lambda 함수가 메시지를 반환하면 Amazon Lex는 응답으로 이를 클라이언트에 전달합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 1,024.

 ** [messageFormat](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-messageFormat"></a>
응답 메시지의 형식. 다음 값 중 하나입니다.  
+  `PlainText` - 메시지에 일반 UTF-8 텍스트가 포함됩니다.
+  `CustomPayload` - 메시지는 Lambda 함수에서 정의되는 사용자 지정 형식입니다.
+  `SSML` - 메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.
+  `Composite` - 메시지에는 의도 생성 시 메시지가 할당된 그룹의 메시지가 하나 이상 포함된 이스케이프된 JSON 개체가 포함되어 있습니다.
타입: 문자열  
유효 값: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-nluIntentConfidence"></a>
Amazon Lex가 반환된 의도가 사용자의 의도와 일치한다고 얼마나 확신하는지 나타내는 점수를 제공합니다. 점수는 0.0\$11.0 사이입니다. 자세한 내용은 [신뢰도 점수](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html)를 참조하세요.  
점수는 상대 점수이며 절대 점수가 아닙니다. 점수는 Amazon Lex의 개선 사항에 따라 변경될 수 있습니다.  
유형: [IntentConfidence](API_runtime_IntentConfidence.md)객체

 ** [responseCard](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-responseCard"></a>
사용자가 현재 프롬프트에 응답해야 하는 옵션을 나타냅니다. 응답 카드는 봇 구성 (Amazon Lex 콘솔에서, 슬롯 옆의 설정 버튼 선택) 또는 코드 후크(Lambda 함수)에서 가져올 수 있습니다.  
유형: [ResponseCard](API_runtime_ResponseCard.md)객체

 ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sentimentResponse"></a>
표현된 감정과 표현.  
봇이 감정 분석을 위해 Amazon Comprehend로 표현을 보내도록 구성된 경우 이 필드에 분석 결과가 포함됩니다.  
유형: [SentimentResponse](API_runtime_SentimentResponse.md)객체

 ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionAttributes"></a>
세션별 컨텍스트 정보를 나타내는 키-값 페어의 맵입니다.  
유형: 문자열 간 맵

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

 ** [slots](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slots"></a>
 Amazon Lex가 대화의 사용자 입력에서 감지한 의도 슬롯.  
Amazon Lex는 슬롯에 대한 예상 값을 가진 해결 목록을 생성합니다. 반환되는 값은 슬롯 유형이 생성되거나 업데이트될 때 선택된 `valueSelectionStrategy`에 따라 결정됩니다. `valueSelectionStrategy`을 `ORIGINAL_VALUE`로 설정하면 사용자 값이 슬롯 값과 유사한 경우 사용자가 제공한 값이 반환됩니다. `valueSelectionStrategy`가 `TOP_RESOLUTION`로 설정된 경우, Amazon Lex는 해결 목록의 첫 번째 값을 반환하고, 해결 목록이 없는 경우 null을 반환합니다. `valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다.  
유형: 문자열 간 맵

 ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slotToElicit"></a>
`dialogState` 값이 `ElicitSlot`인 경우 Amazon Lex가 값을 추출하는 슬롯의 이름을 반환합니다.  
유형: 문자열

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

 ** BadGatewayException **   
Amazon Lex 봇이 아직 구축 중이거나 종속 서비스 중 하나(Amazon Polly, AWS Lambda) 가 내부 서비스 오류로 인해 장애가 발생했습니다.  
HTTP 상태 코드: 502

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

 ** ConflictException **   
 두 클라이언트가 동일한 AWS 계정, Amazon Lex 봇 및 사용자 ID를 사용하고 있습니다.  
HTTP 상태 코드: 409

 ** DependencyFailedException **   
 AWS Lambda 또는 Amazon Polly와 같은 종속 서비스 중 하나에서 예외가 발생했습니다. 예를 들어,   
+ Amazon Lex에 Lambda 함수를 호출할 수 있는 충분한 권한이 없는 경우.
+ Lambda 함수를 실행하는 데 30초 이상 걸리는 경우.
+ 이행 Lambda 함수가 슬롯 값을 제거하지 않고 `Delegate` 대화 작업을 반환하는 경우.
HTTP 상태 코드: 424

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

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

 ** LoopDetectedException **   
이 예외는 사용되지 않습니다.  
HTTP 상태 코드: 508

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

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostText) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText) 

# PutSession
<a name="API_runtime_PutSession"></a>

Amazon Lex 봇을 사용하여 새 세션을 생성하거나 기존 세션을 수정합니다. 이 작업을 사용하면 애플리케이션이 봇의 상태를 설정할 수 있습니다.

자세한 내용은 [세션 관리](https://docs.aws.amazon.com/lex/latest/dg/how-session-api.html)를 참조하세요.

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

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

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

 ** [accept](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-accept"></a>
Amazon Lex가 응답으로 반환하는 메시지는 이 필드의 값에 따라 텍스트 또는 음성일 수 있습니다.  
+ 값이 `text/plain; charset=utf-8`인 경우 Amazon Lex는 응답에서 텍스트를 반환합니다.
+ 값이 `audio/`로 시작하는 경우, Amazon Lex는 응답으로 음성을 반환합니다. Amazon Lex는 Amazon Polly를 사용하여 사용자가 지정한 구성으로 음성을 생성합니다. 예를 들어, 값을 `audio/mpeg`로 지정하면 Amazon Lex는 음성을 MPEG 형식으로 반환합니다.
+ 값이 `audio/pcm`인 경우 반환되는 음성은 16비트 리틀 엔디안 형식의 `audio/pcm`입니다.
+ 허용되는 값은 다음과 같습니다.
  +  `audio/mpeg` 
  +  `audio/ogg` 
  +  `audio/pcm` 
  +  `audio/*`(기본값은 mpeg)
  +  `text/plain; charset=utf-8` 

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

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

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

## 요청 본문
<a name="API_runtime_PutSession_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [activeContexts](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-activeContexts"></a>
요청에 대해 활성화된 컨텍스트 목록. 이전 의도가 이행될 때 또는 요청에 컨텍스트를 포함시켜 컨텍스트를 활성화할 수 있습니다.  
컨텍스트 목록을 지정하지 않으면 Amazon Lex는 세션의 현재 컨텍스트 목록을 사용합니다. 빈 목록을 지정하면 세션의 모든 컨텍스트가 지워집니다.  
타입: [ActiveContext](API_runtime_ActiveContext.md)객체 배열  
배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.  
필수 여부: 아니요

 ** [dialogAction](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-dialogAction"></a>
봇이 대화를 수행하기 위해 취해야 할 다음 조치를 설정합니다.  
유형: [DialogAction](API_runtime_DialogAction.md)객체  
필수 여부: 아니요

 ** [recentIntentSummaryView](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-recentIntentSummaryView"></a>
봇에 대한 최근 의도 요약. 의도 요약 보기를 사용하여 의도에 체크포인트 라벨을 설정하고 의도의 속성을 수정할 수 있습니다. 또한 이를 사용하여 의도 요약 개체를 제거하거나 목록에서 추가할 수 있습니다.  
목록에 수정하거나 추가하는 의도는 봇에 적합해야 합니다. 예를 들어 의도 이름은 봇에 대해 유효해야 합니다. 다음의 값을 제공해야 합니다.  
+  `intentName` 
+ 슬롯 이름
+  `slotToElict` 
`PutSession` 요청에 `recentIntentSummaryView` 파라미터를 보내면 새 요약 보기의 콘텐츠가 이전 요약 보기를 대체합니다. 예를 들어 `GetSession` 요청이 요약 보기에서 세 개의 의도를 반환하고 요약 보기에서 하나의 의도로 `PutSession`를 호출하는 경우 다음 `GetSession`에 대한 호출에서는 하나의 의도만 반환됩니다.  
타입: [IntentSummary](API_runtime_IntentSummary.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수는 3개.  
필수 여부: 아니요

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

## 응답 구문
<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
```

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

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

응답에 다음 HTTP 헤더가 반환됩니다.

 ** [activeContexts](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-activeContexts"></a>
세션에 대해 활성화된 컨텍스트 목록.

 ** [contentType](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-contentType"></a>
요청의 `Accept` HTTP 헤더에 지정된 콘텐츠 유형입니다.

 ** [dialogState](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-dialogState"></a>
  
+  `ConfirmIntent` - Amazon Lex는 의도를 이행하기 전에 의도를 확인하기 위해 “예” 또는 “아니요” 응답을 기대하고 있습니다.
+  `ElicitIntent` - Amazon Lex는 사용자의 의도를 이끌어내고자 합니다.
+  `ElicitSlot`- Amazon Lex는 현재 의도에 사용할 슬롯의 값을 예상하고 있습니다.
+  `Failed` - 사용자와의 대화가 실패했음을 전달합니다. 이는 사용자가 서비스의 프롬프트에 적절한 응답을 제공하지 않거나 Lambda 함수가 의도를 이행하지 못하는 경우 등 다양한 이유로 발생할 수 있습니다.
+  `Fulfilled` - Lambda 함수가 의도를 성공적으로 수행했음을 전달합니다.
+  `ReadyForFulfillment` - 클라이언트가 의도를 이행해야 한다는 것을 전달합니다.
유효한 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedMessage](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-encodedMessage"></a>
사용자에게 제시해야 할 다음 메시지입니다.  
`encodedMessage` 필드는 base-64로 인코딩됩니다. 값을 사용하려면 먼저 필드를 디코딩해야 합니다.  
길이 제약: 최소 길이는 1. 최대 길이는 1,366.

 ** [intentName](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-intentName"></a>
현재 의도의 이름.

 ** [message](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-message"></a>
 *이 헤더는 더 이상 사용되지 않습니다.*  
사용자에게 제시해야 할 다음 메시지입니다.  
이 필드는 de-de, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR 및 it-IT 로캘에서만 사용할 수 있습니다. 다른 모든 로캘에서는 이 `message` 필드가 null입니다. 대신에 `encodedMessage` 필드를 사용해야 합니다.  
길이 제약: 최소 길이 1. 최대 길이는 1,024.

 ** [messageFormat](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-messageFormat"></a>
응답 메시지의 형식. 다음 값 중 하나입니다.  
+  `PlainText` - 메시지에 일반 UTF-8 텍스트가 포함됩니다.
+  `CustomPayload` - 메시지는 클라이언트의 사용자 지정 형식입니다.
+  `SSML` - 메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.
+  `Composite` - 메시지에는 의도 생성 시 메시지가 할당된 그룹의 메시지가 하나 이상 포함된 이스케이프된 JSON 개체가 포함되어 있습니다.
유효한 값: `PlainText | CustomPayload | SSML | Composite` 

 ** [sessionAttributes](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionAttributes"></a>
세션별 컨텍스트 정보를 나타내는 키/값 페어의 맵입니다.

 ** [sessionId](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionId"></a>
세션에 대한 고유 식별자입니다.

 ** [slots](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slots"></a>
Amazon Lex가 대화 중에 사용자 입력에서 감지한 0개 이상의 의도 슬롯의 맵입니다.  
Amazon Lex는 슬롯에 대한 예상 값을 가진 해결 목록을 생성합니다. 반환되는 값은 슬롯 유형이 생성되거나 업데이트될 때 선택된 `valueSelectionStrategy`에 따라 결정됩니다. `valueSelectionStrategy`을 `ORIGINAL_VALUE`로 설정하면 사용자 값이 슬롯 값과 유사한 경우 사용자가 제공한 값이 반환됩니다. `valueSelectionStrategy`가 `TOP_RESOLUTION`로 설정된 경우, Amazon Lex는 해결 목록의 첫 번째 값을 반환하고, 해결 목록이 없는 경우 null을 반환합니다. `valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다.

 ** [slotToElicit](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slotToElicit"></a>
`dialogState`이 `ElicitSlot`인 경우 Amazon Lex가 값을 추출하는 슬롯의 이름을 반환합니다.

응답은 다음 내용을 HTTP 본문으로 반환합니다.

 ** [audioStream](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-audioStream"></a>
사용자에게 전달할 메시지의 오디오 버전입니다.

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

 ** BadGatewayException **   
Amazon Lex 봇이 아직 구축 중이거나 종속 서비스 중 하나(Amazon Polly, AWS Lambda) 가 내부 서비스 오류로 인해 장애가 발생했습니다.  
HTTP 상태 코드: 502

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

 ** ConflictException **   
 두 클라이언트가 동일한 AWS 계정, Amazon Lex 봇 및 사용자 ID를 사용하고 있습니다.  
HTTP 상태 코드: 409

 ** DependencyFailedException **   
 AWS Lambda 또는 Amazon Polly와 같은 종속 서비스 중 하나에서 예외가 발생했습니다. 예를 들어,   
+ Amazon Lex에 Lambda 함수를 호출할 수 있는 충분한 권한이 없는 경우.
+ Lambda 함수를 실행하는 데 30초 이상 걸리는 경우.
+ 이행 Lambda 함수가 슬롯 값을 제거하지 않고 `Delegate` 대화 작업을 반환하는 경우.
HTTP 상태 코드: 424

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

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

 ** NotAcceptableException **   
요청의 수락 헤더에 유효한 값이 없습니다.  
HTTP 상태 코드: 406

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

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PutSession) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PutSession) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PutSession) 

# 데이터 타입
<a name="API_Types"></a>

다음 데이터 유형이 Amazon Lex 모델 구축 서비스에서 지원됩니다.
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

다음 데이터 유형이 Amazon Lex 런타임 서비스에서 지원됩니다.
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# Amazon Lex 모델 구축 서비스
<a name="API_Types_Amazon_Lex_Model_Building_Service"></a>

다음 데이터 유형이 Amazon Lex 모델 구축 서비스에서 지원됩니다.
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

# BotAliasMetadata
<a name="API_BotAliasMetadata"></a>

봇 별칭에 대한 정보를 제공합니다.

## 콘텐츠
<a name="API_BotAliasMetadata_Contents"></a>

 ** botName **   <a name="lex-Type-BotAliasMetadata-botName"></a>
별칭이 가리키는 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** botVersion **   <a name="lex-Type-BotAliasMetadata-botVersion"></a>
별칭이 가리키는 Amazon Lex 봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
Required: No

 ** checksum **   <a name="lex-Type-BotAliasMetadata-checksum"></a>
봇 별칭의 체크섬입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** conversationLogs **   <a name="lex-Type-BotAliasMetadata-conversationLogs"></a>
Amazon Lex가 별칭에 대한 대화 로그를 사용하는 방법을 결정하는 설정입니다.  
유형: [ConversationLogsResponse](API_ConversationLogsResponse.md) 객체  
필수 여부: 아니요

 ** createdDate **   <a name="lex-Type-BotAliasMetadata-createdDate"></a>
봇 별칭이 생성된 날짜.  
유형: 타임스탬프  
필수 여부: 아니요

 ** description **   <a name="lex-Type-BotAliasMetadata-description"></a>
별칭에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** lastUpdatedDate **   <a name="lex-Type-BotAliasMetadata-lastUpdatedDate"></a>
봇 별칭이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** name **   <a name="lex-Type-BotAliasMetadata-name"></a>
봇 별칭의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotAliasMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotAliasMetadata) 

# BotChannelAssociation
<a name="API_BotChannelAssociation"></a>

Amazon Lex 봇과 외부 메시징 플랫폼 간의 연결을 나타냅니다.

## 콘텐츠
<a name="API_BotChannelAssociation_Contents"></a>

 ** botAlias **   <a name="lex-Type-BotChannelAssociation-botAlias"></a>
이 연결이 이루어지는 Amazon Lex 봇의 특정 버전을 가리키는 별칭입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** botConfiguration **   <a name="lex-Type-BotChannelAssociation-botConfiguration"></a>
메시징 플랫폼과 통신하는 데 필요한 정보를 제공합니다.  
유형: 문자열 간 맵  
맵 항목: 최대 항목 수는 10개.  
필수 여부: 아니요

 ** botName **   <a name="lex-Type-BotChannelAssociation-botName"></a>
이 연결이 이루어지는 Amazon Lex 봇의 이름.  
현재 Amazon Lex는 페이스북, 슬랙, 트윌리오와의 제휴를 지원하고 있습니다.
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** createdDate **   <a name="lex-Type-BotChannelAssociation-createdDate"></a>
Amazon Lex 봇과 채널 간의 연결이 생성된 날짜입니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** description **   <a name="lex-Type-BotChannelAssociation-description"></a>
생성 중인 연결에 대한 텍스트 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** failureReason **   <a name="lex-Type-BotChannelAssociation-failureReason"></a>
만약 `status`이 `FAILED`라면, Amazon Lex는 봇 구축에 실패한 이유를 제공합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** name **   <a name="lex-Type-BotChannelAssociation-name"></a>
봇과 채널 간의 연결 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** status **   <a name="lex-Type-BotChannelAssociation-status"></a>
봇 채널의 상태입니다.  
+  `CREATED` - 채널이 생성되어 사용할 준비가 되었습니다.
+  `IN_PROGRESS` - 채널 생성이 진행 중입니다.
+  `FAILED` - 채널을 만드는 중 오류가 발생했습니다. 필드에 대한 자세한 내용은 `failureReason` 필드를 참조하세요.
타입: 문자열  
유효 값: `IN_PROGRESS | CREATED | FAILED`   
필수 여부: 아니요

 ** type **   <a name="lex-Type-BotChannelAssociation-type"></a>
Amazon Lex 봇과 외부 메시징 플랫폼 간에 설정되는 채널 유형을 표시하여 연결 유형을 지정합니다.  
타입: 문자열  
유효 값: `Facebook | Slack | Twilio-Sms | Kik`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotChannelAssociation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotChannelAssociation) 

# BotMetadata
<a name="API_BotMetadata"></a>

봇에 대한 정보를 제공합니다.

## 콘텐츠
<a name="API_BotMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-BotMetadata-createdDate"></a>
봇이 생성된 날짜.  
유형: 타임스탬프  
필수 여부: 아니요

 ** description **   <a name="lex-Type-BotMetadata-description"></a>
봇에 대한 설명입니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** lastUpdatedDate **   <a name="lex-Type-BotMetadata-lastUpdatedDate"></a>
봇이 생성된 날짜입니다. 봇을 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** name **   <a name="lex-Type-BotMetadata-name"></a>
봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** status **   <a name="lex-Type-BotMetadata-status"></a>
봇의 상태.  
타입: 문자열  
유효 값: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT`   
필수 여부: 아니요

 ** version **   <a name="lex-Type-BotMetadata-version"></a>
봇의 버전. 새 봇의 경우 버전은 항상 `$LATEST`입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotMetadata) 

# BuiltinIntentMetadata
<a name="API_BuiltinIntentMetadata"></a>

기본 제공 의도에 관한 메타데이터를 제공합니다.

## 콘텐츠
<a name="API_BuiltinIntentMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinIntentMetadata-signature"></a>
기본 제공 의도의 고유 식별자. 의도의 서명을 찾으려면 *Alexa Skills Ki*t의 [표준 기본 제공 의도](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents)를 참조하십시오.  
유형: 문자열  
필수 항목 여부: 아니요

 ** supportedLocales **   <a name="lex-Type-BuiltinIntentMetadata-supportedLocales"></a>
의도가 지원하는 로캘의 목록입니다.  
유형: 문자열 배열  
유효 값: `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`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentMetadata) 

# BuiltinIntentSlot
<a name="API_BuiltinIntentSlot"></a>

기본 제공 의도에 사용되는 슬롯에 관한 정보를 제공합니다.

## 콘텐츠
<a name="API_BuiltinIntentSlot_Contents"></a>

 ** name **   <a name="lex-Type-BuiltinIntentSlot-name"></a>
의도에 정의된 슬롯 목록.  
유형: 문자열  
필수 항목 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentSlot) 

# BuiltinSlotTypeMetadata
<a name="API_BuiltinSlotTypeMetadata"></a>

기본 제공 슬롯 유형에 관한 정보를 제공합니다.

## 콘텐츠
<a name="API_BuiltinSlotTypeMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinSlotTypeMetadata-signature"></a>
기본 제공 슬롯 유형의 고유 식별자. 슬롯 유형의 서명을 찾으려면 *Alexa Skills Kit의* [슬롯 유형 참조](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference)를 참조하십시오.  
유형: 문자열  
필수 항목 여부: 아니요

 ** supportedLocales **   <a name="lex-Type-BuiltinSlotTypeMetadata-supportedLocales"></a>
슬롯의 대상 로캘의 목록입니다.  
유형: 문자열 배열  
유효 값: `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`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 

# CodeHook
<a name="API_CodeHook"></a>

봇에 대한 요청을 확인하거나 봇에 대한 사용자의 요청을 이행하는 Lambda 함수를 지정합니다.

## 콘텐츠
<a name="API_CodeHook_Contents"></a>

 ** messageVersion **   <a name="lex-Type-CodeHook-messageVersion"></a>
Amazon Lex가 Lambda 함수를 간접 호출하는 데 사용할 요청-응답의 버전입니다. 자세한 내용은 [Lambda 함수 사용](using-lambda.md)을 참조하세요.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 5.  
필수 여부: 예

 ** uri **   <a name="lex-Type-CodeHook-uri"></a>
Lambda 함수의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
Pattern: `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-_]+)?`   
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CodeHook) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CodeHook) 

# ConversationLogsRequest
<a name="API_ConversationLogsRequest"></a>

대화 로그에 필요한 설정을 제공합니다.

## 내용
<a name="API_ConversationLogsRequest_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsRequest-iamRoleArn"></a>
텍스트 로그의 경우 CloudWatch Logs에, 오디오 로그의 경우 S3 버킷에 쓸 수 있는 권한이 있는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 오디오 암호화가 활성화된 경우 이 역할은 오디오 로그를 암호화하는 데 사용되는 AWS KMS 키에 대한 액세스 권한도 제공합니다. 자세한 내용은 [대화 로그를 위한 IAM 역할 및 정책 생성](https://docs.aws.amazon.com/lex/latest/dg/conversation-logs-role-and-policy.html)을 참조하십시오.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
Pattern: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
필수 여부: 예

 ** logSettings **   <a name="lex-Type-ConversationLogsRequest-logSettings"></a>
대화 로그 설정. 대화 텍스트, 대화 오디오 또는 둘 다를 기록할 수 있습니다.  
유형: [LogSettingsRequest](API_LogSettingsRequest.md)객체 어레이  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsRequest) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsRequest) 

# ConversationLogsResponse
<a name="API_ConversationLogsResponse"></a>

대화 로그 설정에 대한 정보가 포함되어있습니다.

## 내용
<a name="API_ConversationLogsResponse_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsResponse-iamRoleArn"></a>
CloudWatch Logs 또는 S3 버킷에 로그를 작성하는 데 사용되는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Required: No

 ** logSettings **   <a name="lex-Type-ConversationLogsResponse-logSettings"></a>
대화 로그 설정. 텍스트, 오디오 또는 둘 다를 기록할 수 있습니다.  
유형: [LogSettingsResponse](API_LogSettingsResponse.md) 객체 배열  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsResponse) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsResponse) 

# EnumerationValue
<a name="API_EnumerationValue"></a>

각 슬롯 유형에는 값 세트가 있을 수 있습니다. 각 열거 값은 슬롯 유형에 사용할 수 있는 값을 나타냅니다.

예를 들어 피자 주문 봇은 피자에 있어야 하는 크러스트 유형을 지정하는 슬롯 유형을 가질 수 있습니다. 슬롯 유형에는 값이 포함될 수 있습니다.
+ 두꺼운
+ 얇은
+ 속을 채운

## 내용
<a name="API_EnumerationValue_Contents"></a>

 ** value **   <a name="lex-Type-EnumerationValue-value"></a>
슬롯 유형의 값.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 140.  
필수 여부: 예

 ** synonyms **   <a name="lex-Type-EnumerationValue-synonyms"></a>
슬롯 유형 항목과 관련된 추가 값입니다.  
유형: 문자열 배열  
길이 제약: 최소 길이는 1. 최대 길이는 140.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/EnumerationValue) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/EnumerationValue) 

# FollowUpPrompt
<a name="API_FollowUpPrompt"></a>

의도가 이행된 후 추가 활동에 대한 프롬프트입니다. 예를 들어 `OrderPizza` 의도가 충족된 후 사용자에게 음료를 주문하고 싶은지 여부를 확인하라는 프롬프트를 표시할 수 있습니다.

## 내용
<a name="API_FollowUpPrompt_Contents"></a>

 ** prompt **   <a name="lex-Type-FollowUpPrompt-prompt"></a>
사용자가 제공하는 정보를 위한 프롬프트.  
유형: [Prompt](API_Prompt.md) 객체  
필수 여부: 예

 ** rejectionStatement **   <a name="lex-Type-FollowUpPrompt-rejectionStatement"></a>
사용자가 `prompt` 필드에 정의된 질문에 "아니요"라고 답하면 Amazon Lex는 의도가 취소되었음을 확인하기 위해 이 문장으로 답합니다.  
유형: [Statement](API_Statement.md) 객체  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FollowUpPrompt) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FollowUpPrompt) 

# FulfillmentActivity
<a name="API_FulfillmentActivity"></a>

 사용자가 의도에 필요한 모든 정보를 제공한 후 의도가 이행되는 방식을 설명합니다. Lambda 함수를 제공하여 의도를 처리하거나 의도 정보를 클라이언트 애플리케이션에 반환할 수 있습니다. 관련 로직이 클라우드에 있도록 Lambda 함수를 사용하고 클라이언트 측 코드를 주로 프레젠테이션으로만 제한하는 것이 좋습니다. 로직을 업데이트해야 하는 경우 Lambda 함수만 업데이트하면 되며 클라이언트 애플리케이션을 업그레이드할 필요는 없습니다.

다음 예제를 살펴보세요.
+ 피자 주문 애플리케이션에서는 사용자가 주문을 위한 모든 정보를 제공한 후 Lambda 함수를 사용하여 피자 가게에 주문을 합니다.
+ 게임 애플리케이션에서는 사용자가 “돌을 주워”라고 말하면 클라이언트 애플리케이션이 작업을 수행하고 그래픽을 업데이트할 수 있도록 이 정보가 클라이언트 애플리케이션에 다시 전달되어야 합니다. 이 경우 사용자는 Amazon Lex가 의도 데이터를 클라이언트에 반환하기를 원합니다.

## 내용
<a name="API_FulfillmentActivity_Contents"></a>

 ** type **   <a name="lex-Type-FulfillmentActivity-type"></a>
 Lambda 함수를 실행하거나 슬롯 데이터를 클라이언트 애플리케이션에 반환하여 의도를 이행하는 방법.  
타입: 문자열  
유효 값: `ReturnIntent | CodeHook`   
필수 사항 여부: 예

 ** codeHook **   <a name="lex-Type-FulfillmentActivity-codeHook"></a>
 의도를 이행하기 위해 실행되는 Lambda 함수에 대한 설명.  
유형: [CodeHook](API_CodeHook.md) 객체  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FulfillmentActivity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FulfillmentActivity) 

# InputContext
<a name="API_InputContext"></a>

Amazon Lex에서 의도를 선택하려면 활성화되어야 하는 컨텍스트의 이름입니다.

## 내용
<a name="API_InputContext_Contents"></a>

 ** name **   <a name="lex-Type-InputContext-name"></a>
컨텍스트의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
Pattern: `^([A-Za-z]_?)+$`   
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/InputContext) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/InputContext) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/InputContext) 

# Intent
<a name="API_Intent"></a>

의도의 특정 개정 버전을 식별합니다.

## 내용
<a name="API_Intent_Contents"></a>

 ** intentName **   <a name="lex-Type-Intent-intentName"></a>
의도의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
Pattern: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** intentVersion **   <a name="lex-Type-Intent-intentVersion"></a>
의도의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
Pattern: `\$LATEST|[0-9]+`   
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Intent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Intent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Intent) 

# IntentMetadata
<a name="API_IntentMetadata"></a>

의도에 대한 정보를 제공합니다.

## 내용
<a name="API_IntentMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-IntentMetadata-createdDate"></a>
의도가 생성된 날짜입니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** description **   <a name="lex-Type-IntentMetadata-description"></a>
의도에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** lastUpdatedDate **   <a name="lex-Type-IntentMetadata-lastUpdatedDate"></a>
의도가 업데이트된 날짜. 봇을 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** name **   <a name="lex-Type-IntentMetadata-name"></a>
의도의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** version **   <a name="lex-Type-IntentMetadata-version"></a>
의도의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/IntentMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/IntentMetadata) 

# KendraConfiguration
<a name="API_KendraConfiguration"></a>

AMAZON.KendraSearchInten 의도에 대한 구성 정보를 제공합니다. 이 의도를 사용할 때 Amazon Lex는 지정된 Amazon Kendra 인덱스를 검색하고 인덱스에서 사용자의 표현과 일치하는 문서를 반환합니다. 자세한 내용은 [AMAZON.KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html)를 참조하세요.

## 내용
<a name="API_KendraConfiguration_Contents"></a>

 ** kendraIndex **   <a name="lex-Type-KendraConfiguration-kendraIndex"></a>
AMAZON.KendraSearchIntent 의도가 검색할 Amazon Kendra 인덱스의 Amazon 리소스 이름(ARN)입니다. 인덱스는 Amazon Lex 봇과 동일한 계정 및 리전에 있어야 합니다. Amazon Kendra 인덱스가 없는 경우 `PutIntent` 작업을 호출할 때 예외가 발생합니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
Pattern: `arn:aws:kendra:[a-z]+-[a-z]+-[0-9]:[0-9]{12}:index\/[a-zA-Z0-9][a-zA-Z0-9_-]*`   
필수 여부: 예

 ** role **   <a name="lex-Type-KendraConfiguration-role"></a>
Amazon Kendra 인덱스를 검색할 권한이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다. 인덱스는 Amazon Lex 봇과 동일한 계정 및 리전에 있어야 합니다. 역할이 없는 경우 `PutIntent` 작업을 호출할 때 예외가 발생합니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
Pattern: `arn:aws:iam::[0-9]{12}:role/.*`   
필수 여부: 예

 ** queryFilterString **   <a name="lex-Type-KendraConfiguration-queryFilterString"></a>
쿼리의 응답을 필터링하기 위해 Amazon Lex에서 Amazon Kendra에 전송하는 쿼리 필터입니다. 필터는 Amazon Kendra에서 정의한 형식입니다. 자세한 내용은 [쿼리 필터링](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)을 참조하세요.  
런타임 시 이 필터 문자열을 새 필터 문자열로 재정의할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 0.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/KendraConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/KendraConfiguration) 

# LogSettingsRequest
<a name="API_LogSettingsRequest"></a>

대화 로그의 전달 모드 및 대상을 구성하는 데 사용되는 설정입니다.

## 내용
<a name="API_LogSettingsRequest_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsRequest-destination"></a>
로그가 전송될 위치. 텍스트 로그는 CloudWatch Logs 로그 그룹에 전송됩니다. S3 버킷으로 오디오 로그가 전송됩니다.  
타입: 문자열  
유효 값: `CLOUDWATCH_LOGS | S3`   
필수 사항 여부: 예

 ** logType **   <a name="lex-Type-LogSettingsRequest-logType"></a>
활성화할 로그 유형의 목록입니다. 텍스트 로그는 CloudWatch Logs 로그 그룹에 전송됩니다. S3 버킷으로 오디오 로그가 전송됩니다.  
타입: 문자열  
유효 값: `AUDIO | TEXT`   
필수 사항 여부: 예

 ** resourceArn **   <a name="lex-Type-LogSettingsRequest-resourceArn"></a>
로그가 전송되어야 하는 S3 버킷이나 CloudWatch Logs 로그 그룹의 Amazon 리소스 이름 (ARN) 입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
Pattern: `^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])$`   
필수 여부: 예

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsRequest-kmsKeyArn"></a>
S3 버킷으로 전송되는 오디오 로그를 암호화하기 위한 AWS KMS 고객 관리 키의 Amazon 리소스 이름 (ARN) 입니다. 키는 CloudWatch Logs에는 적용되지 않으며 S3 버킷의 경우 선택 사항입니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsRequest) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsRequest) 

# LogSettingsResponse
<a name="API_LogSettingsResponse"></a>

대화 로그 설정.

## 내용
<a name="API_LogSettingsResponse_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsResponse-destination"></a>
로그가 전달되는 대상.  
타입: 문자열  
유효 값: `CLOUDWATCH_LOGS | S3`   
필수 여부: 아니요

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsResponse-kmsKeyArn"></a>
S3 버킷의 오디오 로그 파일을 암호화하기 위한 키의 Amazon 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Required: No

 ** logType **   <a name="lex-Type-LogSettingsResponse-logType"></a>
활성화된 로깅 유형.  
타입: 문자열  
유효 값: `AUDIO | TEXT`   
필수 여부: 아니요

 ** resourceArn **   <a name="lex-Type-LogSettingsResponse-resourceArn"></a>
로그가 전송되어야 하는 S3 버킷이나 CloudWatch Logs 로그 그룹의 Amazon 리소스 이름 (ARN).  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `^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])$`   
Required: No

 ** resourcePrefix **   <a name="lex-Type-LogSettingsResponse-resourcePrefix"></a>
리소스 접두사는 오디오 로그를 포함하도록 지정한 S3 버킷 내 S3 객체 키의 첫 번째 부분입니다. CloudWatch Logs의 경우, 지정한 로그 그룹 내 로그 스트림 이름의 접두사입니다.  
유형: 문자열  
길이 제약: 최대 길이는 1,024.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsResponse) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsResponse) 

# Message
<a name="API_Message"></a>

메시지 텍스트와 유형을 제공하는 객체입니다.

## 내용
<a name="API_Message_Contents"></a>

 ** content **   <a name="lex-Type-Message-content"></a>
메시지의 텍스트.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000.  
필수 여부: 예

 ** contentType **   <a name="lex-Type-Message-contentType"></a>
메시지 문자열의 콘텐츠 유형.  
타입: 문자열  
유효 값: `PlainText | SSML | CustomPayload`   
필수 사항 여부: 예

 ** groupNumber **   <a name="lex-Type-Message-groupNumber"></a>
메시지가 속한 메시지 그룹을 식별합니다. 메시지가 그룹에 할당되면 Amazon Lex는 응답의 각 그룹에서 메시지 하나를 반환합니다.  
타입: 정수  
유효한 범위: 최소값은 1. 최댓값은 5.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Message) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Message) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Message) 

# MigrationAlert
<a name="API_MigrationAlert"></a>

Amazon Lex가 마이그레이션 중에 보내는 알림 및 경고에 대한 정보를 제공합니다. 알림에는 문제를 해결하는 방법에 대한 정보가 포함됩니다.

## 내용
<a name="API_MigrationAlert_Contents"></a>

 ** details **   <a name="lex-Type-MigrationAlert-details"></a>
알림에 대한 추가 세부 정보.  
유형: 문자열 배열  
필수 여부: 아니요

 ** message **   <a name="lex-Type-MigrationAlert-message"></a>
경고가 발생한 이유를 설명하는 메시지.  
유형: 문자열  
필수 항목 여부: 아니요

 ** referenceURLs **   <a name="lex-Type-MigrationAlert-referenceURLs"></a>
알림 해결 방법을 설명하는 Amazon Lex 설명서 링크입니다.  
유형: 문자열 배열  
필수 여부: 아니요

 ** type **   <a name="lex-Type-MigrationAlert-type"></a>
오류의 유형. 다음 두 가지 종류의 알림이 있습니다.  
+  `ERROR` - 마이그레이션 중에 해결할 수 없는 문제가 발생했습니다. 마이그레이션이 중지됩니다.
+  `WARN` - 마이그레이션 중에 새 Amazon Lex V2 봇을 수동으로 변경해야 하는 문제가 발생했습니다. 마이그레이션은 계속됩니다.
타입: 문자열  
유효 값: `ERROR | WARN`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationAlert) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationAlert) 

# MigrationSummary
<a name="API_MigrationSummary"></a>

Amazon Lex V1에서 Amazon Lex V2로 봇을 마이그레이션하는 방법에 대한 정보를 제공합니다.

## 내용
<a name="API_MigrationSummary_Contents"></a>

 ** migrationId **   <a name="lex-Type-MigrationSummary-migrationId"></a>
Amazon Lex가 마이그레이션에 할당한 고유 식별자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$`   
Required: No

 ** migrationStatus **   <a name="lex-Type-MigrationSummary-migrationStatus"></a>
작업의 상태. 상태가 `COMPLETE`이면 Amazon Lex V2에서 봇을 사용할 수 있습니다. 마이그레이션을 완료하기 위해 해결해야 하는 알림 및 경고가 있을 수 있습니다.  
타입: 문자열  
유효 값: `IN_PROGRESS | COMPLETED | FAILED`   
필수 여부: 아니요

 ** migrationStrategy **   <a name="lex-Type-MigrationSummary-migrationStrategy"></a>
마이그레이션을 수행하는 데 사용된 전략.  
타입: 문자열  
유효 값: `CREATE_NEW | UPDATE_EXISTING`   
필수 여부: 아니요

 ** migrationTimestamp **   <a name="lex-Type-MigrationSummary-migrationTimestamp"></a>
마이그레이션이 시작된 날짜와 시간.  
유형: 타임스탬프  
필수 여부: 아니요

 ** v1BotLocale **   <a name="lex-Type-MigrationSummary-v1BotLocale"></a>
마이그레이션의 소스가 되는 Amazon Lex V1 봇의 로캘.  
타입: 문자열  
유효 값: `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 **   <a name="lex-Type-MigrationSummary-v1BotName"></a>
마이그레이션의 소스가 되는 Amazon Lex V1 봇의 이름.  
유형: 문자열  
길이 제한: 최소 길이는 2. 최대 길이는 50.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** v1BotVersion **   <a name="lex-Type-MigrationSummary-v1BotVersion"></a>
마이그레이션의 소스가 되는 Amazon Lex V1 봇의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
Required: No

 ** v2BotId **   <a name="lex-Type-MigrationSummary-v2BotId"></a>
마이그레이션의 대상이 되는 Amazon Lex V2의 고유 식별자입니다.  
유형: 문자열  
길이 제약 조건: 고정 길이는 10.  
패턴: `^[0-9a-zA-Z]+$`   
Required: No

 ** v2BotRole **   <a name="lex-Type-MigrationSummary-v2BotRole"></a>
Amazon Lex가 Amazon Lex V2 봇을 실행하는 데 사용하는 IAM 역할.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationSummary) 

# OutputContext
<a name="API_OutputContext"></a>

의도가 이행될 때 출력 컨텍스트의 사양.

## 내용
<a name="API_OutputContext_Contents"></a>

 ** name **   <a name="lex-Type-OutputContext-name"></a>
컨텍스트의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
Pattern: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** timeToLiveInSeconds **   <a name="lex-Type-OutputContext-timeToLiveInSeconds"></a>
`PostContent`또는 `PostText` 응답으로 컨텍스트가 처음 전송된 후 컨텍스트가 활성화되어야 하는 시간(초). 5초에서 86,400초(24시간) 사이를 설정할 수 있습니다.  
유형: 정수  
유효한 범위: 최소값은 5. 최대값은 86,400.  
필수 여부: 예

 ** turnsToLive **   <a name="lex-Type-OutputContext-turnsToLive"></a>
컨텍스트가 활성 상태로 유지되어야 하는 대화 턴 수입니다. 대화 턴은 하나의 `PostContent` 또는 `PostText` 요청 및 Amazon Lex로부터의 관련 응답입니다.  
타입: 정수  
유효한 범위: 최소값은 1. 최대값은 20.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/OutputContext) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/OutputContext) 

# Prompt
<a name="API_Prompt"></a>

사용자로부터 정보를 얻습니다. 프롬프트를 정의하려면 메시지를 하나 이상 제공하고 사용자로부터 정보를 얻으려는 시도 횟수를 지정합니다. 메시지를 두 개 이상 제공하는 경우 Amazon Lex는 메시지 중 하나를 선택하여 사용자에게 메시지를 표시합니다. 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md)을 참조하십시오.

## 내용
<a name="API_Prompt_Contents"></a>

 ** maxAttempts **   <a name="lex-Type-Prompt-maxAttempts"></a>
사용자에게 정보를 요청하는 횟수입니다.  
타입: 정수  
유효한 범위: 최소값은 1. 최대값은 5.  
필수 여부: 예

 ** messages **   <a name="lex-Type-Prompt-messages"></a>
각각 메시지 문자열과 유형을 제공하는 객체의 배열입니다. 일반 텍스트 또는 음성 합성 마크업 언어(SSML)로 메시지 문자열을 지정할 수 있습니다.  
유형: [Message](API_Message.md)객체 어레이  
배열 멤버: 최소 항목 수는 1개. 최대 항목 수는 15개.  
필수 여부: 예

 ** responseCard **   <a name="lex-Type-Prompt-responseCard"></a>
응답 카드. Amazon Lex는 런타임 시 `PostText` API 응답에서 이 프롬프트를 사용합니다. 응답 카드의 자리 표시자를 세션 속성과 슬롯 값으로 대체합니다. 자세한 내용은 [응답 카드 사용](ex-resp-card.md) 단원을 참조하십시오.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 50,000.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Prompt) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Prompt) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Prompt) 

# ResourceReference
<a name="API_ResourceReference"></a>

삭제하려는 리소스를 참조하는 리소스를 설명합니다. 이 개체는 `ResourceInUseException` 예외의 일부로 반환됩니다.

## 내용
<a name="API_ResourceReference_Contents"></a>

 ** name **   <a name="lex-Type-ResourceReference-name"></a>
삭제하려는 리소스를 사용 중인 리소스의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z_]+`   
Required: No

 ** version **   <a name="lex-Type-ResourceReference-version"></a>
삭제하려는 리소스를 사용 중인 리소스의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ResourceReference) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ResourceReference) 

# Slot
<a name="API_Slot"></a>

슬롯의 특정 버전을 식별합니다.

## 내용
<a name="API_Slot_Contents"></a>

 ** name **   <a name="lex-Type-Slot-name"></a>
슬롯의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
Pattern: `^([A-Za-z](-|_|.)?)+$`   
필수 여부: 예

 ** slotConstraint **   <a name="lex-Type-Slot-slotConstraint"></a>
슬롯이 필수인지 옵션인지 여부를 지정합니다.  
타입: 문자열  
유효 값: `Required | Optional`   
필수 사항 여부: 예

 ** defaultValueSpec **   <a name="lex-Type-Slot-defaultValueSpec"></a>
슬롯의 기본값 목록입니다. Amazon Lex가 슬롯에 대한 값을 결정하지 않은 경우 기본값이 사용됩니다. 컨텍스트 변수, 세션 속성 및 정의된 값에서 기본값을 지정할 수 있습니다.  
유형: [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 객체  
필수 여부: 아니요

 ** description **   <a name="lex-Type-Slot-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** obfuscationSetting **   <a name="lex-Type-Slot-obfuscationSetting"></a>
대화 로그와 저장된 표현 내용에서 슬롯이 난독화되는지 여부를 결정합니다. 슬롯을 난독 처리하면 값이 중괄호 (\$1\$1)로 묶인 슬롯 이름으로 대체됩니다. 예를 들어 슬롯 이름이 “full\$1name”인 경우 난독화된 값은 "\$1full\$1name\$1"으로 대체됩니다. 자세한 내용은 [슬롯 난독화 ](https://docs.aws.amazon.com/lex/latest/dg/how-obfuscate.html)를 참조하십시오.  
타입: 문자열  
유효 값: `NONE | DEFAULT_OBFUSCATION`   
필수 여부: 아니요

 ** priority **   <a name="lex-Type-Slot-priority"></a>
 사용자로부터 이 슬롯 값을 추출하는 순서를 Amazon Lex에 지시합니다. 예를 들어 의도에 우선 순위가 1과 2인 슬롯 두 개가 있는 경우 AWS Amazon Lex는 우선 순위가 1인 슬롯의 값을 먼저 추출합니다.  
여러 슬롯이 동일한 우선 순위를 공유하는 경우 Amazon Lex가 값을 도출하는 순서는 임의적입니다.  
유형: 정수  
유효 범위: 최소값은 0입니다. 최댓값은 100입니다.  
필수 여부: 아니요

 ** responseCard **   <a name="lex-Type-Slot-responseCard"></a>
 텍스트 기반 클라이언트가 사용하는 슬롯 유형에 대해 가능한 응답 세트입니다. 사용자는 텍스트를 사용하여 회신하는 대신 응답 카드에서 옵션을 선택합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 50,000.  
필수 여부: 아니요

 ** sampleUtterances **   <a name="lex-Type-Slot-sampleUtterances"></a>
 사용자가 슬롯 값에 대한 Amazon Lex 요청에 응답할 수 있는 특정 패턴을 알고 있는 경우 이러한 표현을 제공하여 정확도를 높일 수 있습니다. 이는 선택 사항입니다. 대부분의 경우 Amazon Lex는 사용자의 표현을 이해할 수 있습니다.  
유형: 문자열 배열  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 200.  
필수 여부: 아니요

 ** slotType **   <a name="lex-Type-Slot-slotType"></a>
슬롯 유형(정의한 사용자 정의 슬롯 유형 또는 기본 제공 슬롯 유형 중 하나)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Required: No

 ** slotTypeVersion **   <a name="lex-Type-Slot-slotTypeVersion"></a>
슬롯 유형의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
Required: No

 ** valueElicitationPrompt **   <a name="lex-Type-Slot-valueElicitationPrompt"></a>
Amazon Lex가 사용자로부터 슬롯 값을 추출하는 데 사용하는 프롬프트입니다.  
유형: [Prompt](API_Prompt.md) 객체  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Slot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Slot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Slot) 

# SlotDefaultValue
<a name="API_SlotDefaultValue"></a>

슬롯의 기본값.

## 내용
<a name="API_SlotDefaultValue_Contents"></a>

 ** defaultValue **   <a name="lex-Type-SlotDefaultValue-defaultValue"></a>
슬롯의 기본값. 다음 중 한 가지를 지정할 수 있습니다.  
+  `#context-name.slot-name` - "컨텍스트 이름" 컨텍스트의 슬롯 값 "슬롯 이름".
+  `{attribute}` - 세션 속성 "속성"의 슬롯 값.
+  `'value'` - 불연속 값 "값".
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 202.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValue) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValue) 

# SlotDefaultValueSpec
<a name="API_SlotDefaultValueSpec"></a>

슬롯의 기본값을 포함합니다. Amazon Lex가 슬롯에 대한 값을 결정하지 않은 경우 기본값이 사용됩니다.

## 내용
<a name="API_SlotDefaultValueSpec_Contents"></a>

 ** defaultValueList **   <a name="lex-Type-SlotDefaultValueSpec-defaultValueList"></a>
슬롯의 기본값. 둘 이상의 값을 지정할 수 있습니다. 예를 들어 일치하는 컨텍스트 변수, 세션 속성 또는 고정 값에서 사용할 기본값을 지정할 수 있습니다.  
선택한 기본값은 목록에서 지정한 순서에 따라 선택됩니다. 예를 들어 컨텍스트 변수와 고정 값을 순서대로 지정하는 경우 Amazon Lex는 컨텍스트 변수를 사용하고, 사용 가능한 경우 고정 값을 사용합니다.  
유형: [SlotDefaultValue](API_SlotDefaultValue.md)객체 어레이  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValueSpec) 

# SlotTypeConfiguration
<a name="API_SlotTypeConfiguration"></a>

슬롯 유형에 대한 구성 정보를 제공합니다.

## 내용
<a name="API_SlotTypeConfiguration_Contents"></a>

 ** regexConfiguration **   <a name="lex-Type-SlotTypeConfiguration-regexConfiguration"></a>
슬롯 값을 검증하는 데 사용되는 정규식.  
유형: [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 객체  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeConfiguration) 

# SlotTypeMetadata
<a name="API_SlotTypeMetadata"></a>

슬롯 유형에 관한 정보를 제공합니다.

## 내용
<a name="API_SlotTypeMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-SlotTypeMetadata-createdDate"></a>
슬롯 유형이 생성된 날짜.  
유형: 타임스탬프  
필수 여부: 아니요

 ** description **   <a name="lex-Type-SlotTypeMetadata-description"></a>
슬롯 유형에 대한 설명.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 200.  
필수 여부: 아니요

 ** lastUpdatedDate **   <a name="lex-Type-SlotTypeMetadata-lastUpdatedDate"></a>
슬롯 유형이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.  
유형: 타임스탬프  
필수 여부: 아니요

 ** name **   <a name="lex-Type-SlotTypeMetadata-name"></a>
슬롯 유형의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `^([A-Za-z]_?)+$`   
Required: No

 ** version **   <a name="lex-Type-SlotTypeMetadata-version"></a>
슬롯 유형의 버전.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeMetadata) 

# SlotTypeRegexConfiguration
<a name="API_SlotTypeRegexConfiguration"></a>

슬롯 값을 검증하는 데 사용되는 정규식을 제공합니다.

## 내용
<a name="API_SlotTypeRegexConfiguration_Contents"></a>

 ** pattern **   <a name="lex-Type-SlotTypeRegexConfiguration-pattern"></a>
슬롯 값을 검증하는 데 사용되는 정규식.  
표준 정규 표현식을 사용합니다. Amazon Lex는 정규 표현식에서 다음 문자를 지원합니다.  
+ A\$1Z, a\$1z
+ 0\$19
+ 유니코드 문자("\$1u<Unicode>")
4자리 숫자가 포함된 유니코드 문자를 나타냅니다(예: "\$1u0041" 또는 "\$1u005A").  
다음 정규식 연산자는 지원되지 않습니다.  
+ 무한 반복자: 상한이 없는 \$1, \$1 또는 \$1x,\$1
+ 와일드 카드(.)
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeRegexConfiguration) 

# Statement
<a name="API_Statement"></a>

사용자에게 정보를 전달하는 메시지 모음. Amazon Lex는 런타임 시 전달할 메시지를 선택합니다.

## 내용
<a name="API_Statement_Contents"></a>

 ** messages **   <a name="lex-Type-Statement-messages"></a>
메시지 객체의 모음.  
유형: [Message](API_Message.md)객체 어레이  
배열 멤버: 최소 항목 수는 1개. 최대 항목 수는 15개.  
필수 여부: 예

 ** responseCard **   <a name="lex-Type-Statement-responseCard"></a>
 런타임 시 클라이언트가 [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) API를 사용하는 경우 Amazon Lex는 응답에 응답 카드를 포함합니다. 응답 카드의 자리 표시자를 세션 속성과 슬롯 값으로 대체합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 50,000.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Statement) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Statement) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Statement) 

# Tag
<a name="API_Tag"></a>

봇, 봇 별칭 또는 봇 채널을 식별하는 키/값 쌍의 목록. 키와 값의 문자로는 Unicode 문자, 숫자, 공백 그리고 다음 기호가 허용됩니다:\$1 . : / = \$1 - @.

## 내용
<a name="API_Tag_Contents"></a>

 ** key **   <a name="lex-Type-Tag-key"></a>
태그의 키. 키는 대/소문자를 구분하지 않으며 고유해야 합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 128.  
필수 여부: 예

 ** value **   <a name="lex-Type-Tag-value"></a>
키에 연결할 값입니다. 값은 빈 문자열일 수 있지만 null일 수는 없습니다.  
유형: 문자열  
길이 제약: 최소 길이는 0. 최대 길이는 256.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Tag) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Tag) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Tag) 

# UtteranceData
<a name="API_UtteranceData"></a>

봇에 생성된 단일 표현에 대한 정보를 제공합니다 

## 내용
<a name="API_UtteranceData_Contents"></a>

 ** count **   <a name="lex-Type-UtteranceData-count"></a>
표현이 처리된 횟수.  
유형: 정수  
필수 항목 여부: 아니요

 ** distinctUsers **   <a name="lex-Type-UtteranceData-distinctUsers"></a>
해당 표현을 사용한 총 개인 수.  
유형: 정수  
필수 항목 여부: 아니요

 ** firstUtteredDate **   <a name="lex-Type-UtteranceData-firstUtteredDate"></a>
표현이 처음 기록된 날짜.  
유형: 타임스탬프  
필수 여부: 아니요

 ** lastUtteredDate **   <a name="lex-Type-UtteranceData-lastUtteredDate"></a>
표현이 마지막으로 기록된 날짜.  
유형: 타임스탬프  
필수 여부: 아니요

 ** utteranceString **   <a name="lex-Type-UtteranceData-utteranceString"></a>
사용자가 입력한 텍스트 또는 오디오 클립의 텍스트 표현.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,000.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceData) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceData) 

# UtteranceList
<a name="API_UtteranceList"></a>

봇의 특정 버전에 대한 표현 목록을 제공합니다. 목록에는 최대 100개의 표현이 포함됩니다.

## 내용
<a name="API_UtteranceList_Contents"></a>

 ** botVersion **   <a name="lex-Type-UtteranceList-botVersion"></a>
목록을 처리한 봇의 버전입니다.  
유형: 문자열  
길이 제한: 최소 길이는 1. 최대 길이는 64.  
패턴: `\$LATEST|[0-9]+`   
Required: No

 ** utterances **   <a name="lex-Type-UtteranceList-utterances"></a>
봇에게 한 표현에 대한 정보가 들어 있는 하나 이상의 [UtteranceData](API_UtteranceData.md) 개체. 최대 객체 개수는 100.  
유형: [UtteranceData](API_UtteranceData.md) 객체 배열  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceList) 

# Amazon Lex 런타임 서비스
<a name="API_Types_Amazon_Lex_Runtime_Service"></a>

다음 데이터 유형이 Amazon Lex 런타임 서비스에서 지원됩니다.
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# ActiveContext
<a name="API_runtime_ActiveContext"></a>

컨텍스트는 사용자와 Amazon Lex 간의 현재 대화 상태에 대한 정보를 포함하는 변수입니다. 컨텍스트는 의도가 이행될 때 Amazon Lex에서 자동으로 설정하거나 `PutContent`, `PutText`, 또는 `PutSession` 작업을 사용하여 런타임 시 설정할 수 있습니다.

## 내용
<a name="API_runtime_ActiveContext_Contents"></a>

 ** name **   <a name="lex-Type-runtime_ActiveContext-name"></a>
컨텍스트의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
Pattern: `^([A-Za-z]_?)+$`   
필수 여부: 예

 ** parameters **   <a name="lex-Type-runtime_ActiveContext-parameters"></a>
현재 컨텍스트의 상태 변수. 이 값을 후속 이벤트에서 슬롯의 기본값으로 사용할 수 있습니다.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개. 최대 항목 수는 10개.  
키 길이 제약 조건: 최소 길이는 1. 최대 길이는 100.  
값 길이 제약 조건: 최소 길이는 1. 최대 길이는 1,024.  
필수 여부: 예

 ** timeToLive **   <a name="lex-Type-runtime_ActiveContext-timeToLive"></a>
컨텍스트가 활성 상태로 유지되는 시간 또는 턴 수.  
유형: [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 객체  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContext) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContext) 

# ActiveContextTimeToLive
<a name="API_runtime_ActiveContextTimeToLive"></a>

컨텍스트가 활성 상태로 유지되는 시간 또는 턴 수.

## 내용
<a name="API_runtime_ActiveContextTimeToLive_Contents"></a>

 ** timeToLiveInSeconds **   <a name="lex-Type-runtime_ActiveContextTimeToLive-timeToLiveInSeconds"></a>
`PostContent` 또는 `PostText` 응답으로 컨텍스트가 처음 전송된 후 컨텍스트가 활성화되어야 하는 시간(초). 5초에서 86,400초(24시간) 사이를 설정할 수 있습니다.  
유형: 정수  
유효한 범위: 최소값은 5. 최대값은 86,400.  
필수 여부: 아니요

 ** turnsToLive **   <a name="lex-Type-runtime_ActiveContextTimeToLive-turnsToLive"></a>
컨텍스트가 활성 상태로 유지되어야 하는 대화 턴 수입니다. 대화 턴은 하나의 `PostContent` 또는 `PostText` 요청 및 Amazon Lex로부터의 관련 응답입니다.  
타입: 정수  
유효한 범위: 최소값은 1. 최대값은 20.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContextTimeToLive) 

# Button
<a name="API_runtime_Button"></a>

클라이언트 플랫폼(페이스북, 슬랙 등)에 표시할 옵션을 나타냅니다.

## 내용
<a name="API_runtime_Button_Contents"></a>

 ** text **   <a name="lex-Type-runtime_Button-text"></a>
버튼에서 사용자에게 표시되는 텍스트.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 15.  
필수 여부: 예

 ** value **   <a name="lex-Type-runtime_Button-value"></a>
사용자가 버튼을 선택할 때 Amazon Lex로 전송되는 값입니다. 버튼 텍스트 “NYC”를 예로 들어 보겠습니다. 사용자가 버튼을 선택하면 전송되는 값은 “뉴욕 시”가 될 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000.  
필수 여부: 예

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/Button) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/Button) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/Button) 

# DialogAction
<a name="API_runtime_DialogAction"></a>

봇이 사용자와의 상호작용에서 취해야 하는 다음 조치를 설명하고 작업이 발생하는 상황에 대한 정보를 제공합니다. `DialogAction` 데이터 유형을 사용하여 상호 작용을 특정 상태로 설정하거나 상호 작용을 이전 상태로 되돌릴 수 있습니다.

## 내용
<a name="API_runtime_DialogAction_Contents"></a>

 ** type **   <a name="lex-Type-runtime_DialogAction-type"></a>
봇이 사용자와의 상호 작용에서 수행해야 하는 다음 작업입니다. 가능한 값은 다음과 같습니다.  
+  `ConfirmIntent` - 다음 작업은 사용자에게 의도가 완료되었고 이행할 준비가 되었는지 묻는 것입니다. “주문하세요?”와 같은 예/아니요 질문입니다.
+  `Close` - 사용자로부터 응답이 없을 것임을 나타냅니다. 예를 들어 "주문 되었습니다"라는 문장에는 응답이 필요 없습니다.
+  `Delegate` - Amazon Lex가 다음 작업을 결정합니다.
+  `ElicitIntent` - 다음 작업은 사용자가 이행하고자 하는 의도를 결정하는 것입니다.
+  `ElicitSlot` - 다음 작업은 사용자로부터 슬롯 값을 추출하는 것입니다.
타입: 문자열  
유효 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
필수 사항 여부: 예

 ** fulfillmentState **   <a name="lex-Type-runtime_DialogAction-fulfillmentState"></a>
의도에 대한 이행 상태. 가능한 값은 다음과 같습니다.  
+  `Failed` - 의도와 연결된 Lambda 함수가 의도를 이행하지 못했습니다.
+  `Fulfilled` - 의도는 의도와 연결된 Lambda 함수에 의해 이행되었습니다.
+  `ReadyForFulfillment` - 의도에 필요한 모든 정보가 존재하며 클라이언트 애플리케이션에서 의도를 이행할 준비가 되어 있습니다.
타입: 문자열  
유효 값: `Fulfilled | Failed | ReadyForFulfillment`   
필수 여부: 아니요

 ** intentName **   <a name="lex-Type-runtime_DialogAction-intentName"></a>
의도의 이름.  
유형: 문자열  
필수 항목 여부: 아니요

 ** message **   <a name="lex-Type-runtime_DialogAction-message"></a>
사용자에게 표시해야 하는 메시지입니다. 사용자가 메시지를 지정하지 않으면 Amazon Lex는 의도에 대해 구성된 메시지를 사용합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 1024.  
필수 여부: 아니요

 ** messageFormat **   <a name="lex-Type-runtime_DialogAction-messageFormat"></a>
+  `PlainText` - 메시지에 일반 UTF-8 텍스트가 포함됩니다.
+  `CustomPayload` - 메시지는 클라이언트의 사용자 지정 형식입니다.
+  `SSML` - 메시지에 음성 출력용으로 서식이 지정된 텍스트가 포함됩니다.
+  `Composite` - 메시지에 하나 이상의 메시지가 포함된 이스케이프된 JSON 객체가 포함되어 있습니다. 더 자세한 내용은, [메시지 그룹](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html)을 참조하십시오.
타입: 문자열  
유효 값: `PlainText | CustomPayload | SSML | Composite`   
필수 여부: 아니요

 ** slots **   <a name="lex-Type-runtime_DialogAction-slots"></a>
수집된 슬롯과 해당 값의 맵.  
유형: 문자열 간 맵  
필수 여부: 아니요

 ** slotToElicit **   <a name="lex-Type-runtime_DialogAction-slotToElicit"></a>
사용자로부터 추출해야 하는 슬롯의 이름입니다.  
유형: 문자열  
필수 항목 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DialogAction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DialogAction) 

# GenericAttachment
<a name="API_runtime_GenericAttachment"></a>

프롬프트가 표시될 때 사용자에게 렌더링되는 옵션을 나타냅니다. 이미지, 버튼, 링크 또는 텍스트일 수 있습니다.

## 내용
<a name="API_runtime_GenericAttachment_Contents"></a>

 ** attachmentLinkUrl **   <a name="lex-Type-runtime_GenericAttachment-attachmentLinkUrl"></a>
응답 카드에 있는 첨부 파일의 URL.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 여부: 아니요

 ** buttons **   <a name="lex-Type-runtime_GenericAttachment-buttons"></a>
사용자에게 표시할 옵션 목록.  
유형: [Button](API_runtime_Button.md)객체 어레이  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 5개.  
필수 여부: 아니요

 ** imageUrl **   <a name="lex-Type-runtime_GenericAttachment-imageUrl"></a>
사용자에게 표시되는 이미지의 URL.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
필수 여부: 아니요

 ** subTitle **   <a name="lex-Type-runtime_GenericAttachment-subTitle"></a>
제목 아래에 표시된 자막.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 80.  
필수 여부: 아니요

 ** title **   <a name="lex-Type-runtime_GenericAttachment-title"></a>
옵션의 제목.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 80.  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GenericAttachment) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GenericAttachment) 

# IntentConfidence
<a name="API_runtime_IntentConfidence"></a>

의도가 사용자의 의도를 만족하는 것인지 여부에 대한 Amazon Lex의 신뢰도를 나타내는 점수를 제공합니다.

## 내용
<a name="API_runtime_IntentConfidence_Contents"></a>

 ** score **   <a name="lex-Type-runtime_IntentConfidence-score"></a>
Amazon Lex가 의도가 사용자의 의도를 만족시키는지 신뢰하는 정도를 나타내는 점수입니다. 범위는 0.00에서 1.00 사이입니다. 점수가 높을수록 신뢰도가 높습니다.  
유형: 더블  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentConfidence) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentConfidence) 

# IntentSummary
<a name="API_runtime_IntentSummary"></a>

의도의 상태에 대한 정보를 제공합니다. 이 정보를 사용하여 의도의 현재 상태를 파악하여 의도를 처리하거나 의도를 이전 상태로 되돌릴 수 있습니다.

## 내용
<a name="API_runtime_IntentSummary_Contents"></a>

 ** dialogActionType **   <a name="lex-Type-runtime_IntentSummary-dialogActionType"></a>
봇이 사용자와의 상호 작용에서 수행해야 하는 다음 작업입니다. 가능한 값은 다음과 같습니다.  
+  `ConfirmIntent` - 다음 작업은 사용자에게 의도가 완료되었고 이행할 준비가 되었는지 묻는 것입니다. “주문하세요?”와 같은 예/아니요 질문입니다.
+  `Close` - 사용자로부터 응답이 없을 것임을 나타냅니다. 예를 들어 "주문 되었습니다"라는 문장에는 응답이 필요 없습니다.
+  `ElicitIntent` - 다음 작업은 사용자가 이행하고자 하는 의도를 결정하는 것입니다.
+  `ElicitSlot` - 다음 작업은 사용자로부터 슬롯 값을 추출하는 것입니다.
타입: 문자열  
유효 값: `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
필수 사항 여부: 예

 ** checkpointLabel **   <a name="lex-Type-runtime_IntentSummary-checkpointLabel"></a>
특정 의도를 식별하는 사용자 정의 라벨입니다. 이 레이블을 사용하여 이전 의도로 돌아갈 수 있습니다.  
`GetSessionRequest` 작업의 `checkpointLabelFilter` 매개변수를 사용하여 작업에서 반환된 의도를, 지정된 라벨만 있는 의도로 필터링합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 255.  
패턴: `[a-zA-Z0-9-]+`   
Required: No

 ** confirmationStatus **   <a name="lex-Type-runtime_IntentSummary-confirmationStatus"></a>
사용자가 확인 프롬프트에 응답한 이후의 의도 상태입니다. 사용자가 의도를 확인하면 Amazon Lex는 이 필드를 `Confirmed`로 설정합니다. 사용자가 의도를 거부하면 Amazon Lex는 이 값을 `Denied`로 설정합니다. 가능한 값은 다음과 같습니다.  
+  `Confirmed` - 사용자가 확인 프롬프트에 “예”라고 응답하여 의도가 완료되었으며 이행할 준비가 되었음을 확인했습니다.
+  `Denied` - 사용자가 확인 프롬프트에 “아니요”라고 응답했습니다.
+  `None` - 사용자에게 확인 메시지가 표시되지 않거나 사용자에게 메시지가 표시되었지만 메시지를 확인하거나 거부하지 않았습니다.
타입: 문자열  
유효 값: `None | Confirmed | Denied`   
필수 여부: 아니요

 ** fulfillmentState **   <a name="lex-Type-runtime_IntentSummary-fulfillmentState"></a>
의도의 이행 상태. 가능한 값은 다음과 같습니다.  
+  `Failed` - 의도와 연결된 Lambda 함수가 의도를 이행하지 못했습니다.
+  `Fulfilled` - 의도는 의도와 연결된 Lambda 함수에 의해 이행되었습니다.
+  `ReadyForFulfillment` - 의도에 필요한 모든 정보가 존재하며 클라이언트 애플리케이션에서 의도를 이행할 준비가 되어 있습니다.
타입: 문자열  
유효 값: `Fulfilled | Failed | ReadyForFulfillment`   
필수 여부: 아니요

 ** intentName **   <a name="lex-Type-runtime_IntentSummary-intentName"></a>
의도의 이름.  
유형: 문자열  
필수 항목 여부: 아니요

 ** slots **   <a name="lex-Type-runtime_IntentSummary-slots"></a>
수집된 슬롯과 해당 값의 맵.  
유형: 문자열 간 맵  
필수 여부: 아니요

 ** slotToElicit **   <a name="lex-Type-runtime_IntentSummary-slotToElicit"></a>
사용자로부터 유도할 다음 슬롯. 유도할 슬롯이 없는 경우 해당 필드는 비어 있습니다.  
유형: 문자열  
필수 항목 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentSummary) 

# PredictedIntent
<a name="API_runtime_PredictedIntent"></a>

Amazon Lex에서 제안하는 의도는 사용자의 의도를 만족시킵니다. 의도의 이름, Amazon Lex가 사용자의 의도가 만족되었다는 신뢰도, 의도에 대해 정의된 슬롯을 포함합니다.

## 내용
<a name="API_runtime_PredictedIntent_Contents"></a>

 ** intentName **   <a name="lex-Type-runtime_PredictedIntent-intentName"></a>
Amazon Lex에서 제안하는 의도 이름은 사용자의 의도를 만족합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** nluIntentConfidence **   <a name="lex-Type-runtime_PredictedIntent-nluIntentConfidence"></a>
Amazon Lex가 의도가 사용자의 의도를 만족한다고 얼마나 신뢰하는지 나타냅니다.  
유형: [IntentConfidence](API_runtime_IntentConfidence.md) 객체  
필수 여부: 아니요

 ** slots **   <a name="lex-Type-runtime_PredictedIntent-slots"></a>
예측된 의도와 관련된 슬롯 및 슬롯 값.  
유형: 문자열 간 맵  
필수 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PredictedIntent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PredictedIntent) 

# ResponseCard
<a name="API_runtime_ResponseCard"></a>

봇을 생성할 때 응답 카드를 구성하면 Amazon Lex는 사용 가능한 세션 속성과 슬롯 값을 대체한 다음 이를 반환합니다. 응답 카드는 Lambda 함수 (`dialogCodeHook` 및 `fulfillmentActivity` 인텐트)에서 가져올 수도 있습니다.

## 내용
<a name="API_runtime_ResponseCard_Contents"></a>

 ** contentType **   <a name="lex-Type-runtime_ResponseCard-contentType"></a>
응답의 콘텐츠 유형.  
타입: 문자열  
유효 값: `application/vnd.amazonaws.card.generic`   
필수 여부: 아니요

 ** genericAttachments **   <a name="lex-Type-runtime_ResponseCard-genericAttachments"></a>
옵션을 나타내는 첨부 객체 배열.  
유형: [GenericAttachment](API_runtime_GenericAttachment.md)객체 어레이  
배열 멤버: 최소 항목 수는 0개. 최대 항목 수 10개.  
필수 여부: 아니요

 ** version **   <a name="lex-Type-runtime_ResponseCard-version"></a>
응답 카드 형식의 버전.  
유형: 문자열  
필수 항목 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ResponseCard) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ResponseCard) 

# SentimentResponse
<a name="API_runtime_SentimentResponse"></a>

감정이 하나의 표현으로 표현되었습니다.

봇이 감정 분석을 위해 Amazon Comprehend로 표현을 보내도록 구성된 경우 이 필드에 분석 결과가 포함됩니다.

## 내용
<a name="API_runtime_SentimentResponse_Contents"></a>

 ** sentimentLabel **   <a name="lex-Type-runtime_SentimentResponse-sentimentLabel"></a>
Amazon Comprehend가 가장 신뢰하는 추론된 감정입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** sentimentScore **   <a name="lex-Type-runtime_SentimentResponse-sentimentScore"></a>
감정이 올바르게 추론되었을 가능성.  
유형: 문자열  
필수 항목 여부: 아니요

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

언어별 AWS SDKs
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/SentimentResponse) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/SentimentResponse)