기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateVocabularyFilter 새 사용자 지정 어휘 필터를 생성합니다. 사용자 지정 어휘 필터를 사용하여 성적표에서 특정 단어를 숨기거나 삭제하거나 플래그를 지정할 수 있습니다. 사용자 지정 어휘 필터는 일반적으로 성적표의 욕설을 가리는 데 사용됩니다. 각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. [사용자 지정 어휘의 문자 집합을](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오. 자세한 내용은 [어휘 필터링을](https://docs.aws.amazon.com/transcribe/latest/dg/vocabulary-filtering.html) 참조하십시오. ## 요청 구문 ``` { "LanguageCode": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "VocabularyFilterFileUri": "string", "VocabularyFilterName": "string", "Words": [ "string" ] } ``` ## 요청 파라미터 모든 작업에서 사용되는 파라미터에 대한 자세한 내용은 [섹션을](CommonParameters.md) 참조하세요. 요청은 JSON 형식의 다음 데이터를 받습니다. ** [LanguageCode](#API_CreateVocabularyFilter_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` 필수 항목 여부: 예 ** [Tags](#API_CreateVocabularyFilter_RequestSyntax) ** 이 새 어휘 필터를 만들 때 각각 키:값 쌍의 형태로 하나 이상의 사용자 지정 태그를 새 사용자 지정 어휘 필터에 추가합니다. Amazon Transcribe에서 태그를 사용하는 방법에 대한 자세한 내용은 [섹션을 참조하세요](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html). 유형: [Tag](API_Tag.md) 객체 배열 배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다. 필수 항목 여부: 아니요 ** [VocabularyFilterFileUri](#API_CreateVocabularyFilter_RequestSyntax) ** 사용자 지정 어휘 필터 용어가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 곳에 있어야 합니다. 다음은 URI 경로의 예입니다.`s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt` 요청에 포함하는`VocabularyFilterFileUri` 경우 사용할 수 없으므로 둘 중 하나를 선택해야`Words` 합니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다. 패턴: `(s3://|http(s*)://).+` 필수 항목 여부: 아니요 ** [VocabularyFilterName](#API_CreateVocabularyFilter_RequestSyntax) ** 새 사용자 지정 어휘 필터에 사용할 고유한 이름을 직접 선택합니다. 이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 사용자 지정 어휘 필터와 동일한 이름으로 새 사용자 지정 어휘 필터를 만들려고 하면`ConflictException` 오류가 발생합니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다. 패턴: `^[0-9a-zA-Z._-]+` 필수 항목 여부: 예 ** [Words](#API_CreateVocabularyFilter_RequestSyntax) ** 요청에 원하는 모든 용어를 쉼표로 구분된 값으로 포함하여 사용자 지정 어휘 필터를 만들려면 이 매개 변수를 사용하십시오. 어휘 필터를 생성하는 또 다른 옵션은 항목을 텍스트 파일에 저장하고 Amazon S3 버킷에 업로드한 다음`VocabularyFilterFileUri` 파라미터를 사용하여 파일의 위치를 지정하는 것입니다. 요청에 포함하는`Words` 경우 사용할 수 없으므로 둘 중 하나를 선택해야`VocabularyFilterFileUri` 합니다. 각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. [사용자 지정 어휘의 문자 집합을](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오. 유형: 문자열 배열 배열 멤버: 최소 항목 수는 1개입니다. 길이 제약: 최소 길이는 1입니다. 최대 길이 256. Required: No ## 응답 구문 ``` { "LanguageCode": "string", "LastModifiedTime": number, "VocabularyFilterName": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LanguageCode](#API_CreateVocabularyFilter_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_CreateVocabularyFilter_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 ** [VocabularyFilterName](#API_CreateVocabularyFilter_ResponseSyntax) ** 사용자 지정 어휘 필터에 대해 선택한 이름. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다. 패턴: `^[0-9a-zA-Z._-]+` ## 오류 모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오[일반적인 오류](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/CreateVocabularyFilter) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateVocabularyFilter) + [AWSSDK를 위한 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateVocabularyFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateVocabularyFilter)