기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateVocabulary
기존 사용자 지정 어휘를 새 값으로 업데이트합니다. 이 작업은 기존의 모든 정보를 새 값으로 덮어씁니다. 기존 사용자 지정 어휘에는 새 용어를 추가할 수 없습니다.
요청 구문
{
"LanguageCode": "string
",
"Phrases": [ "string
" ],
"VocabularyFileUri": "string
",
"VocabularyName": "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
필수 항목 여부: 예
- Phrases
-
요청에 원하는 모든 용어를 쉼표로 구분된 값으로 포함하여 사용자 지정 어휘를 업데이트하려면 이 매개 변수를 사용하십시오. 사용자 지정 어휘를 업데이트하는 또 다른 옵션은 항목을 텍스트 파일에 저장하고 Amazon S3 버킷에 업로드한 다음
VocabularyFileUri
파라미터를 사용하여 파일의 위치를 지정하는 것입니다.요청에 포함하는
Phrases
경우 사용할 수 없으므로 둘 중 하나를 선택해야VocabularyFileUri
합니다.각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. 사용자 지정 어휘의 문자 집합을 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오.
유형: 문자열 배열
길이 제약: 최소 길이 0. 최대 길이 256.
Pattern:
.+
필수 항목 여부: 아니요
- VocabularyFileUri
-
사용자 지정 어휘가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 위치에 있어야 합니다.
다음은 범용 파라미터 파라입니다.
s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt
요청에 포함하는
VocabularyFileUri
경우Phrases
플래그를 사용할 수 없으므로 둘 중 하나를 선택해야 합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다.
패턴:
(s3://|http(s*)://).+
필수 항목 여부: 아니요
- VocabularyName
-
업데이트할 사용자 정의 어휘의 이름입니다. 사용자 지정 어휘 이름은 대/소문자를 구분합니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
Required: Yes
응답 구문
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "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
- VocabularyName
-
업데이트된 사용자 정의 어휘의 이름입니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
- VocabularyState
-
사용자 지정 어휘의 처리 상태입니다.
READY
상태인 경우StartTranscriptionJob
요청에 사용자 지정 어휘를 사용할 수 있습니다.유형: String
유효한 값:
PENDING | READY | FAILED
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- BadRequestException
-
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:
IN PROGRESS
) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.HTTP 상태 코드: 400
- ConflictException
-
이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다.
HTTP 상태 코드: 400
- InternalFailureException
-
에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 수정한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
- NotFoundException
-
요청한 리소스를 찾을 수 없습니다. 지정한 이름이 올바른지 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.