기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateVocabulary 새 사용자 지정 어휘를 생성합니다. 새 사용자 지정 어휘를 만들 때 새 항목, 구문 및 용어가 포함된 텍스트 파일을 Amazon S3 버킷에 업로드하고 요청에 URI를 포함시킬 수 있습니다. 또는`Phrases` 플래그를 사용하여 요청에 직접 용어 목록을 포함시킬 수 있습니다. 각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 요청이 실패합니다. [사용자 지정 어휘의 문자 집합을](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오. 자세한 내용은 [사용자 지정 어휘를](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html) 참조하십시오. ## 요청 구문 ``` { "LanguageCode": "string", "Phrases": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VocabularyFileUri": "string", "VocabularyName": "string" } ``` ## 요청 파라미터 모든 작업에서 사용하는 파라미터 관련 내용은 [단원을](CommonParameters.md) 참조하십시오. 요청은 JSON 형식의 다음 데이터를 받습니다. ** [LanguageCode](#API_CreateVocabulary_RequestSyntax) ** 사용자 지정 어휘의 항목 언어를 나타내는 언어 코드입니다. 각 사용자 지정 어휘에는 한 가지 언어로 된 용어만 포함되어야 합니다. 사용자 지정 어휘는 사용자 지정 어휘와 동일한 언어로 파일을 변환할 때만 사용할 수 있습니다. 예를 들어 미국 영어 (`en-US`) 를 사용하여 사용자 지정 어휘를 만드는 경우 영어 오디오가 포함된 파일에만 이 사용자 지정 어휘를 적용할 수 있습니다. 지원되는 언어 및 관련 언어 코드 목록은 [지원되는 언어](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html) 표를 참조하십시오. 유형: String 유효한 값:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` 필수 항목 여부: 예 ** [Phrases](#API_CreateVocabulary_RequestSyntax) ** 요청에 원하는 모든 용어를 쉼표로 구분된 값으로 포함하여 사용자 지정 어휘를 만들려면 이 매개 변수를 사용하십시오. 사용자 지정 어휘를 만드는 또 다른 옵션은 항목을 텍스트 파일에 저장하고 Amazon S3 버킷에 업로드한 다음`VocabularyFileUri` 파라미터를 사용하여 파일의 위치를 지정하는 것입니다. 요청에 포함하는`Phrases` 경우 사용할 수 없으므로 둘 중 하나를 선택해야`VocabularyFileUri` 합니다. 각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. [사용자 지정 어휘의 문자 집합을](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오. 유형: 문자열 배열 길이 제약: 최소 길이 0. 최대 길이 256. Pattern: `.+` 필수 항목 여부: 아니요 ** [Tags](#API_CreateVocabulary_RequestSyntax) ** 이 새 사용자 지정 어휘를 만들 때 각각 키:값 쌍의 형태로 하나 이상의 사용자 지정 태그를 새 사용자 지정 어휘에 추가합니다. Amazon Transcribe에서 태그를 사용하는 방법에 대한 자세한 내용은 [단원을](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html) 참조하십시오. 유형: [Tag](API_Tag.md) 객체 배열 배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수. 필수 항목 여부: 아니요 ** [VocabularyFileUri](#API_CreateVocabulary_RequestSyntax) ** 사용자 지정 어휘가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 위치에 있어야 합니다. 다음은 URI 경로의 예입니다.`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt` 요청에 포함하는`VocabularyFileUri` 경우`Phrases` 플래그를 사용할 수 없으므로 둘 중 하나를 선택해야 합니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다. 패턴: `(s3://|http(s*)://).+` 필수 항목 여부: 아니요 ** [VocabularyName](#API_CreateVocabulary_RequestSyntax) ** 새로운 사용자 지정 어휘를 위해 사용자가 선택한 고유한 이름입니다. 이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 사용자 지정 어휘와 이름이 같은 새 사용자 지정 어휘를 만들려고 하면`ConflictException` 오류가 발생합니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다. 패턴: `^[0-9a-zA-Z._-]+` Required: Yes ## 응답 구문 ``` { "FailureReason": "string", "LanguageCode": "string", "LastModifiedTime": number, "VocabularyName": "string", "VocabularyState": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [FailureReason](#API_CreateVocabulary_ResponseSyntax) ** `VocabularyState``FAILED`인 경우 사용자 지정 어휘 요청이 실패한 이유에 대한 정보가`FailureReason` 들어 있습니다. 참조: [일반 오류](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html). 유형: String ** [LanguageCode](#API_CreateVocabulary_ResponseSyntax) ** 사용자 지정 어휘용으로 선택한 언어 코드입니다. 유형: String 유효한 값:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` ** [LastModifiedTime](#API_CreateVocabulary_ResponseSyntax) ** 사용자 지정 어휘를 만든 날짜 및 시간입니다. 타임스탬프 형식은 다음과 같습니다`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. 예를 들어, 2022년 5월 4일 UTC-7 오후 12시 32분을`2022-05-04T12:32:58.761000-07:00` 나타냅니다. 유형: Timestamp ** [VocabularyName](#API_CreateVocabulary_ResponseSyntax) ** 사용자 지정 어휘를 위해 선택한 이름입니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다. 패턴: `^[0-9a-zA-Z._-]+` ** [VocabularyState](#API_CreateVocabulary_ResponseSyntax) ** 사용자 지정 어휘의 처리 상태 `READY`상태인 경우`StartTranscriptionJob` 요청에 사용자 지정 어휘를 사용할 수 있습니다. 유형: String 유효한 값:` PENDING | READY | FAILED` ## 오류 모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오[일반적인 오류](CommonErrors.md). ** BadRequestException ** 요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:`IN PROGRESS`) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오. HTTP 상태 코드: 400 ** ConflictException ** 이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다. HTTP 상태 코드: 400 ** InternalFailureException ** 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 수정한 다음 요청을 다시 시도하세요. HTTP 상태 코드: 500 ** LimitExceededException ** 요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요. HTTP 상태 코드: 400 ## 참고 항목 이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요. + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateVocabulary) + [AWSSDK를 위한 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateVocabulary)