기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# UpdateVocabularyFilter
<a name="API_UpdateVocabularyFilter"></a>

기존 사용자 지정 어휘 필터를 새 단어 목록으로 업데이트합니다. 입력한 새 목록은 이전 항목을 모두 덮어씁니다. 기존 사용자 지정 어휘 필터에는 새 용어를 추가할 수 없습니다.

## 요청 구문
<a name="API_UpdateVocabularyFilter_RequestSyntax"></a>

```
{
   "VocabularyFilterFileUri": "string",
   "VocabularyFilterName": "string",
   "Words": [ "string" ]
}
```

## 요청 파라미터
<a name="API_UpdateVocabularyFilter_RequestParameters"></a>

[모든 작업에서 범용 파라미터에 대한 세부 정보입니다.](CommonParameters.md)

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [VocabularyFilterFileUri](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-VocabularyFilterFileUri"></a>
사용자 지정 어휘 필터 용어가 포함된 텍스트 파일의 Amazon S3 위치입니다. URI는 호출하는AWS 리전 리소스와 같은 위치에 있어야 합니다.  
다음은 URI 경로의 예입니다:`s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt`   
요청에 포함하는`VocabularyFilterFileUri` 경우 사용할 수 없으므로 둘 중 하나를 선택해야`Words` 합니다.  
유형: String  
길이 제약: 최소 길이는 1입니다. 최대 길이는 2000입니다.  
패턴: `(s3://|http(s*)://).+`   
필수 항목 여부: 아니요

 ** [VocabularyFilterName](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-VocabularyFilterName"></a>
업데이트할 사용자 정의 어휘 필터의 이름입니다. 사용자 정의 어휘 필터의 이름은 대/소문자를 구분합니다.  
유형: String  
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.  
패턴: `^[0-9a-zA-Z._-]+`   
필수 항목 여부: 예

 ** [Words](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-Words"></a>
요청에 원하는 모든 용어를 쉼표로 구분된 값으로 포함하여 사용자 지정 어휘 필터를 업데이트하려면 이 매개 변수를 사용하십시오. 어휘 필터를 업데이트하는 또 다른 옵션은 항목을 텍스트 파일에 저장하고 Amazon S3 버킷에 업로드한 다음`VocabularyFilterFileUri` 파라미터를 사용하여 파일의 위치를 지정하는 것입니다.  
요청에 포함하는`Words` 경우 사용할 수 없으므로 둘 중 하나를 선택해야`VocabularyFilterFileUri` 합니다.  
각 언어에는 해당 언어에 허용되는 모든 문자가 포함된 문자 집합이 있습니다. 지원되지 않는 문자를 사용하면 사용자 지정 어휘 필터 요청이 실패합니다. [사용자 지정 어휘의 문자 집합을](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) 참조하여 해당 언어에 맞는 문자 집합을 확인하십시오.  
유형: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이 256.  
Required: No

## 응답 구문
<a name="API_UpdateVocabularyFilter_ResponseSyntax"></a>

```
{
   "LanguageCode": "string",
   "LastModifiedTime": number,
   "VocabularyFilterName": "string"
}
```

## 응답 요소
<a name="API_UpdateVocabularyFilter_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [LanguageCode](#API_UpdateVocabularyFilter_ResponseSyntax) **   <a name="transcribe-UpdateVocabularyFilter-response-LanguageCode"></a>
사용자 지정 어휘 필터로 선택한 언어 코드입니다.  
유형: 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_UpdateVocabularyFilter_ResponseSyntax) **   <a name="transcribe-UpdateVocabularyFilter-response-LastModifiedTime"></a>
지정한 사용자 정의 어휘 필터가 마지막으로 업데이트된 날짜 및 시간입니다.  
타임스탬프 형식은 다음과 같습니다`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_UpdateVocabularyFilter_ResponseSyntax) **   <a name="transcribe-UpdateVocabularyFilter-response-VocabularyFilterName"></a>
업데이트된 사용자 정의 어휘 필터의 이름입니다.  
유형: String  
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.  
패턴: `^[0-9a-zA-Z._-]+` 

## 오류
<a name="API_UpdateVocabularyFilter_Errors"></a>

모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오[일반적인 오류](CommonErrors.md).

 ** BadRequestException **   
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:`IN PROGRESS`) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.  
HTTP 상태 코드: 400

 ** InternalFailureException **   
에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.  
HTTP 상태 코드: 500

 ** LimitExceededException **   
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.  
HTTP 상태 코드: 400

 ** NotFoundException **   
요청한 리소스를 찾을 수 없습니다. 지정한 이름이 올바른지 확인하고 요청을 다시 시도하십시오.  
HTTP 상태 코드: 400

## 참고 항목
<a name="API_UpdateVocabularyFilter_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWSSDK를 위한 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/UpdateVocabularyFilter)