As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Atualiza um filtro de vocabulário personalizado existente com uma nova lista de palavras. A nova lista que você fornece substitui todas as entradas anteriores; você não pode acrescentar novos termos a um filtro de vocabulário personalizado existente.

## Sintaxe da solicitação
<a name="API_UpdateVocabularyFilter_RequestSyntax"></a>

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

## Parâmetros de solicitação
<a name="API_UpdateVocabularyFilter_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [VocabularyFilterFileUri](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-VocabularyFilterFileUri"></a>
A localização do arquivo de texto no Amazon S3 que contém seus termos de filtro de vocabulário personalizados. O URI deve estar localizado daRegião da AWS mesma forma que o recurso que você está chamando.  
Veja um exemplo de caminho de URI:`s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt`   
Observe que, se você incluir`VocabularyFilterFileUri` em sua solicitação, não poderá usar`Words`; você deve escolher um ou outro.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2000.  
Padrão: `(s3://|http(s*)://).+`   
Obrigatório: não

 ** [VocabularyFilterName](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-VocabularyFilterName"></a>
O nome do filtro de vocabulário personalizado que você deseja atualizar. Os nomes de filtro de vocabulário personalizados diferenciam letras maiúsculas de minúsculas.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+`   
Obrigatório: Sim

 ** [Words](#API_UpdateVocabularyFilter_RequestSyntax) **   <a name="transcribe-UpdateVocabularyFilter-request-Words"></a>
Use esse parâmetro se quiser atualizar seu filtro de vocabulário personalizado incluindo todos os termos desejados, como valores separados por vírgula, em sua solicitação. A outra opção para atualizar seu filtro de vocabulário é salvar suas entradas em um arquivo de texto e enviá-las para um bucket do Amazon S3 e, em seguida, especificar a localização do seu arquivo usando o`VocabularyFilterFileUri` parâmetro.  
Observe que, se você incluir`Words` em sua solicitação, não poderá usar`VocabularyFilterFileUri`; você deve escolher um ou outro.  
Cada idioma tem um conjunto de caracteres que contém todos os caracteres permitidos para esse idioma específico. Se você usar caracteres não suportados, sua solicitação de filtro de vocabulário personalizado falhará. Consulte [Conjuntos de caracteres para vocabulários personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) para obter o conjunto de caracteres para seu idioma.  
Tipo: matriz de strings  
Membros da matriz: número mínimo de 1 item.  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_UpdateVocabularyFilter_ResponseSyntax"></a>

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

## Elementos de resposta
<a name="API_UpdateVocabularyFilter_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [LanguageCode](#API_UpdateVocabularyFilter_ResponseSyntax) **   <a name="transcribe-UpdateVocabularyFilter-response-LanguageCode"></a>
O código do idioma que você selecionou para seu filtro de vocabulário personalizado.  
Tipo: String  
Valores válidos:` 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>
A data e hora em que o filtro de vocabulário personalizado especificado foi atualizado pela última vez.  
Os carimbos de data e hora estão no formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por exemplo,`2022-05-04T12:32:58.761000-07:00` representa 12h32 UTC-7 em 4 de maio de 2022.  
Type: timestamp

 ** [VocabularyFilterName](#API_UpdateVocabularyFilter_ResponseSyntax) **   <a name="transcribe-UpdateVocabularyFilter-response-VocabularyFilterName"></a>
O nome do filtro de vocabulário personalizado atualizado.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+` 

## Erros
<a name="API_UpdateVocabularyFilter_Errors"></a>

Para obter informações sobre os erros comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** BadRequestException **   
Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou se está em um estado não terminal (como`IN PROGRESS`). Consulte o campo da mensagem de exceção para obter mais informações.  
Código de status HTTP: 400

 ** InternalFailureException **   
Ocorreu um erro interno. Verifique a mensagem de erro, resolva o problema e tente novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Espere antes de repetir sua solicitação ou use um arquivo menor e tente novamente.  
Código de status HTTP: 400

 ** NotFoundException **   
Não conseguimos encontrar o recurso solicitado. Verifique se o nome especificado está correto e tente sua solicitação novamente.  
Código de status HTTP: 400

## Consulte também
<a name="API_UpdateVocabularyFilter_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [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 para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/UpdateVocabularyFilter) 
+  [AWS SDK para 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)