기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateVocabularyFilter
기존 사용자 지정 어휘 필터를 새 단어 목록으로 업데이트합니다. 입력한 새 목록은 이전 항목을 모두 덮어씁니다. 기존 사용자 지정 어휘 필터에는 새 용어를 추가할 수 없습니다.
요청 구문
{
"VocabularyFilterFileUri": "string
",
"VocabularyFilterName": "string
",
"Words": [ "string
" ]
}
요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
- VocabularyFilterFileUri
-
사용자 지정 어휘 필터 용어가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 위치에 있어야 합니다.
다음은 URI 경로의 예입니다:
s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt
요청에 포함하는
VocabularyFilterFileUri
경우 사용할 수 없으므로 둘 중 하나를 선택해야Words
합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다.
패턴:
(s3://|http(s*)://).+
필수 항목 여부: 아니요
- VocabularyFilterName
-
업데이트할 사용자 정의 어휘 필터의 이름입니다. 사용자 정의 어휘 필터의 이름은 대/소문자를 구분합니다.
유형: 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
- InternalFailureException
-
에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
- NotFoundException
-
요청한 리소스를 찾을 수 없습니다. 지정한 이름이 올바른지 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.