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

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

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