기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateVocabularyFilter
새 사용자 지정 어휘 필터를 생성합니다.
사용자 지정 어휘 필터를 사용하여 성적표에서 특정 단어를 숨기거나 삭제하거나 플래그를 지정할 수 있습니다. 사용자 지정 어휘 필터는 일반적으로 성적표의 욕설을 가리는 데 사용됩니다.
각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. 사용자 지정 어휘의 문자 집합을 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오.
자세한 내용은 어휘 필터링을 참조하십시오.
요청 구문
{
"LanguageCode": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"VocabularyFilterFileUri": "string",
"VocabularyFilterName": "string",
"Words": [ "string" ]
}요청 파라미터
모든 작업에서 사용되는 파라미터에 대한 자세한 내용은 섹션을 참조하세요.
요청은 JSON 형식의 다음 데이터를 받습니다.
- LanguageCode
-
어휘 필터에 있는 항목의 언어를 나타내는 언어 코드입니다. 각 사용자 지정 어휘 필터에는 한 가지 언어로 된 용어만 포함되어야 합니다.
사용자 지정 어휘 필터는 필터와 동일한 언어로 파일을 변환할 때만 사용할 수 있습니다. 예를 들어 미국 영어 (
en-US) 를 사용하여 사용자 지정 어휘 필터를 만드는 경우 영어 오디오가 포함된 파일에만 이 필터를 적용할 수 있습니다.지원되는 언어 및 관련 언어 코드 목록은 지원되는 언어 표를 참조하십시오.
유형: 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
-
이 새 어휘 필터를 만들 때 각각 키:값 쌍의 형태로 하나 이상의 사용자 지정 태그를 새 사용자 지정 어휘 필터에 추가합니다.
Amazon Transcribe에서 태그를 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요.
유형: Tag 객체 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.
필수 항목 여부: 아니요
- VocabularyFilterFileUri
-
사용자 지정 어휘 필터 용어가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 곳에 있어야 합니다.
다음은 URI 경로의 예입니다.
s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt요청에 포함하는
VocabularyFilterFileUri경우 사용할 수 없으므로 둘 중 하나를 선택해야Words합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다.
패턴:
(s3://|http(s*)://).+필수 항목 여부: 아니요
- VocabularyFilterName
-
새 사용자 지정 어휘 필터에 사용할 고유한 이름을 직접 선택합니다.
이 이름은 대소문자를 구분하며 공백을 포함할 수 없으며, 에서 고유해야 합니다AWS 계정. 기존 사용자 지정 어휘 필터와 동일한 이름으로 새 사용자 지정 어휘 필터를 만들려고 하면
ConflictException오류가 발생합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+필수 항목 여부: 예
- Words
-
요청에 원하는 모든 용어를 쉼표로 구분된 값으로 포함하여 사용자 지정 어휘 필터를 만들려면 이 매개 변수를 사용하십시오. 어휘 필터를 생성하는 또 다른 옵션은 항목을 텍스트 파일에 저장하고 Amazon S3 버킷에 업로드한 다음
VocabularyFilterFileUri파라미터를 사용하여 파일의 위치를 지정하는 것입니다.요청에 포함하는
Words경우 사용할 수 없으므로 둘 중 하나를 선택해야VocabularyFilterFileUri합니다.각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. 사용자 지정 어휘의 문자 집합을 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오.
유형: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다.
길이 제약: 최소 길이는 1입니다. 최대 길이 256.
Required: No
응답 구문
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyFilterName": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- LanguageCode
-
사용자 지정 어휘 필터로 선택한 언어 코드입니다.
유형: 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
-
사용자 지정 어휘 필터를 만든 날짜 및 시간.
타임스탬프 형식은 다음과 같습니다
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
-
사용자 지정 어휘 필터에 대해 선택한 이름.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- BadRequestException
-
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:
IN PROGRESS) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.HTTP 상태 코드: 400
- ConflictException
-
이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다.
HTTP 상태 코드: 400
- InternalFailureException
-
내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 수정한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
