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á.
UpdateVocabulary
Atualiza um vocabulário personalizado existente com novos valores. Essa operação substitui todas as informações existentes por seus novos valores; você não pode acrescentar novos termos a um vocabulário personalizado existente.
Sintaxe da solicitação
{
"LanguageCode": "string",
"Phrases": [ "string" ],
"VocabularyFileUri": "string",
"VocabularyName": "string"
}Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- LanguageCode
-
O código do idioma que representa o idioma das entradas no vocabulário personalizado que você deseja atualizar. Cada vocabulário personalizado deve conter termos em apenas um idioma.
Um vocabulário personalizado só pode ser usado para transcrever arquivos no mesmo idioma do vocabulário personalizado. Por exemplo, se você criar um vocabulário personalizado usando inglês americano (
en-US), só poderá aplicar esse vocabulário personalizado a arquivos que contenham áudio em inglês.Para obter uma lista dos idiomas suportados e seus códigos de idioma associados, consulte a tabela de idiomas suportados.
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-SEObrigatório: Sim
- Phrases
-
Use esse parâmetro se quiser atualizar seu 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 vocabulário personalizado é 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
VocabularyFileUriparâmetro.Observe que, se você incluir
Phrasesem sua solicitação, não poderá usarVocabularyFileUri; 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 para obter o conjunto de caracteres para seu idioma.
Tipo: matriz de strings
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 256.
Padrão:
.+Obrigatório: não
- VocabularyFileUri
-
O local do Amazon S3 do arquivo de texto que contém seu vocabulário personalizado. O URI deve estar localizado doRegião da AWS mesmo local do recurso que você está chamando.
Veja um exemplo de caminho de URI:
s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txtObserve que, se você incluir
VocabularyFileUriem sua solicitação, não poderá usar oPhrasessinalizador; deverá 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
- VocabularyName
-
O nome do vocabulário personalizado que você deseja atualizar. Os nomes de vocabulário personalizado 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
Sintaxe da resposta
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}Elementos de resposta
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
-
O código do idioma que você selecionou para seu 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
-
A data e a hora em que o 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:00representa 12h32 UTC-7 em 4 de maio de 2022.Type: timestamp
- VocabularyName
-
O nome do 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._-]+ - VocabularyState
-
O estado de processamento do seu vocabulário personalizado. Se o estado for
READY, você pode usar o vocabulário personalizado em umaStartTranscriptionJobsolicitação.Tipo: String
Valores válidos:
PENDING | READY | FAILED
Erros
Para obter informações sobre os erros comuns a todas as ações, consulteErros comuns.
- 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 de mensagem de exceção para obter mais informações.Código de status HTTP: 400
- ConflictException
-
Já existe um recurso com esse nome. Os nomes de recursos devem ser exclusivos em umConta da AWS.
Código de status HTTP: 400
- InternalFailureException
-
Ocorreu um erro interno. Verifique a mensagem de erro, corrija 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
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
