지원 종료 공지: 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) 참조하세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # PutSlotType 사용자 지정 슬롯 유형을 생성하거나 기존 사용자 지정 슬롯 유형을 교체합니다. 사용자 정의 슬롯 유형을 생성하려면 슬롯 유형의 이름과 이 유형의 슬롯이 가정할 수 있는 값인 열거 값 세트를 지정합니다. 자세한 내용은 [Amazon Lex: 작동 방식](how-it-works.md)을 참조하세요. 기존 슬롯 유형의 이름을 지정하는 경우, 요청의 필드가 슬롯 유형의 `$LATEST` 버전의 기존 값을 대체합니다. Amazon Lex는 요청에서 제공하지 않은 필드를 제거합니다. 필수 필드 값을 지정하지 않으면 Amazon Lex에서 예외가 발생합니다. 슬롯 유형의 `$LATEST` 버전을 업데이트할 때 봇이 슬롯 유형을 포함하는 의도 `$LATEST` 버전을 사용하는 경우 봇의 `status` 필드는 `NOT_BUILT`로 설정됩니다. 이 작업에는 `lex:PutSlotType` 액션에 대한 권한이 필요합니다. ## Request Syntax ``` 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 요청 파라미터 다음의 URI 파라미터를 사용하여 요청합니다. ** [name](#API_PutSlotType_RequestSyntax) ** 슬롯 유형의 이름. 이름은 대/소문자를 구분하지 *않습니다*. 이름은 기본 제공 의도 이름 또는 "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]_?)+$` 필수 여부: 예 ## 요청 본문 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [checksum](#API_PutSlotType_RequestSyntax) ** `$LATEST` 버전의 특정 개정 버전을 식별합니다. 새 봇을 만들 때는 `checksum` 필드를 비워 두십시오. 체크섬을 지정하면 `BadRequestException` 예외가 발생합니다. 봇을 업데이트하려면 `checksum` 필드를 해당 버전의 `$LATEST` 버전의 최신 개정의 체크섬으로 설정하십시오. ` checksum` 필드를 지정하지 않거나 체크섬이 `$LATEST` 버전과 일치하지 않으면 `PreconditionFailedException` 예외가 발생합니다. 유형: 문자열 필수 항목 여부: 아니요 ** [createVersion](#API_PutSlotType_RequestSyntax) ** `true`로 설정하면 번호가 매겨진 새 버전의 슬롯 유형이 생성됩니다. 이는 `CreateSlotTypeVersion` 작업을 호출하는 것과 같습니다. `createVersion`를 지정하지 않으면 기본값은 `false`입니다. 유형: 부울 필수 항목 여부: 아니요 ** [description](#API_PutSlotType_RequestSyntax) ** 슬롯 유형에 대한 설명. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200. 필수 여부: 아니요 ** [enumerationValues](#API_PutSlotType_RequestSyntax) ** 슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록. 각 값에는 슬롯에 대해 확인되는 값에 대해 기계 학습 모델을 훈련하는 데 도움이 되는 추가 값인 `synonyms` 목록이 있을 수 있습니다. 정규 표현식 슬롯 유형에는 열거형 값이 필요하지 않습니다. 다른 모든 슬롯 유형에는 열거값 목록이 필요합니다. Amazon Lex는 슬롯 값을 확인할 때 슬롯에 사용할 수 있는 값을 최대 5개까지 포함하는 확인 목록을 생성합니다. Lambda 함수를 사용하는 경우 이 확인 목록이 함수에 전달됩니다. Lambda 함수를 사용하지 않는 경우 사용자가 입력한 값을 반환하거나 확인 목록의 첫 번째 값을 슬롯 값으로 반환하도록 선택할 수 있습니다. `valueSelectionStrategy` 필드는 사용할 옵션을 나타냅니다. 타입: [EnumerationValue](API_EnumerationValue.md)객체 배열 배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개. 필수 여부: 아니요 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) ** 이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형. 상위 슬롯 유형을 정의하면 새 슬롯 유형은 상위 슬롯 유형과 구성이 모두 동일합니다. `AMAZON.AlphaNumeric`만 지원됩니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 100. 패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+` 필수 여부: 아니요 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) ** 상위 기본 제공 슬롯 유형을 확장하는 구성 정보. 구성이 상위 슬롯 유형의 설정에 추가됩니다. 타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열 배열 멤버: 최소 항목 수는 0개. 최대 항목 수 10개. 필수 여부: 아니요 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) ** Amazon Lex가 슬롯 유형 값을 반환하는 데 사용하는 슬롯 확인 전략을 결정합니다. 다음 값 중 하나로 필드를 설정할 수 있습니다. + `ORIGINAL_VALUE` - 사용자 값이 슬롯 값과 유사한 경우 사용자가 입력한 값을 반환합니다. + `TOP_RESOLUTION` - 슬롯에 대한 확인 목록이 있는 경우 확인 목록의 첫 번째 값을 슬롯 유형 값으로 반환합니다. 확인 목록이 없으면 null이 반환됩니다. `valueSelectionStrategy`를 지정하지 않으면 기본값은 `ORIGINAL_VALUE`입니다. 타입: 문자열 유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION` 필수 항목 여부: 아니요 ## 응답 구문 ``` 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" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [checksum](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형의 `$LATEST` 버전의 체크섬. 유형: 문자열 ** [createdDate](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형이 생성된 날짜. 유형: 타임스탬프 ** [createVersion](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형의 새 버전이 생성된 경우 `True`. 요청에서 `createVersion` 필드를 지정하지 않은 경우 응답에서 `createVersion` 필드는 거짓으로 설정됩니다. 유형: Boolean ** [description](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형에 대한 설명. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200. ** [enumerationValues](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형이 사용할 수 있는 값을 정의하는 `EnumerationValue` 객체의 목록. 타입: [EnumerationValue](API_EnumerationValue.md)객체 배열 배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개. ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형이 업데이트된 날짜. 슬롯 유형을 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다. 유형: 타임스탬프 ** [name](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형의 이름. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 100. 패턴: `^([A-Za-z]_?)+$` ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) ** 이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 100. 패턴: `^((AMAZON\.)_?|[A-Za-z]_?)+` ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) ** 상위 기본 제공 슬롯 유형을 확장하는 구성 정보. 타입: [SlotTypeConfiguration](API_SlotTypeConfiguration.md)객체 배열 배열 멤버: 최소 항목 수는 0개. 최대 항목 수는 10개. ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) ** Amazon Lex가 슬롯 값을 결정하는 데 사용하는 슬롯 확인 전략입니다. 자세한 내용은 [PutSlotType](#API_PutSlotType) 단원을 참조하십시오. 타입: 문자열 유효 값: `ORIGINAL_VALUE | TOP_RESOLUTION` ** [version](#API_PutSlotType_ResponseSyntax) ** 슬롯 유형의 버전. 새 슬롯 유형의 경우 버전은 항상 `$LATEST`입니다. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `\$LATEST|[0-9]+` ## Errors ** BadRequestException ** 요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요. HTTP 상태 코드: 400 ** ConflictException ** 요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요. HTTP 상태 코드: 409 ** InternalFailureException ** 내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요. HTTP 상태 코드: 500 ** LimitExceededException ** 요청이 한도를 초과했습니다. 다시 요청해 보세요. HTTP 상태 코드: 429 ** PreconditionFailedException ** 변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요. HTTP 상태 코드: 412 ## 참고 언어별 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)