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á.

# CreateMedicalVocabulary
<a name="API_CreateMedicalVocabulary"></a>

Cria um novo vocabulário médico personalizado.

Antes de criar um novo vocabulário médico personalizado, você deve primeiro carregar um arquivo de texto que contenha suas novas entradas, frases e termos em um bucket do Amazon S3. Observe que isso é diferente de[CreateVocabulary](API_CreateVocabulary.md), onde você pode incluir uma lista de termos em sua solicitação usando o`Phrases` sinalizador;`CreateMedicalVocabulary` não suporta o`Phrases` sinalizador.

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 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.

Para obter mais informações, consulte [Vocabulários personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html).

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

```
{
   "LanguageCode": "{{string}}",
   "Tags": [ 
      { 
         "Key": "{{string}}",
         "Value": "{{string}}"
      }
   ],
   "VocabularyFileUri": "{{string}}",
   "VocabularyName": "{{string}}"
}
```

## Parâmetros de solicitação
<a name="API_CreateMedicalVocabulary_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.

 ** [LanguageCode](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-LanguageCode"></a>
O código do idioma que representa o idioma das entradas em seu vocabulário personalizado. O inglês dos EUA (`en-US`) é o único idioma compatível com o Amazon Transcribe Medical.  
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`   
Obrigatório: Sim

 ** [Tags](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-Tags"></a>
Adiciona uma ou mais tags personalizadas, cada uma na forma de um par chave:valor, a um novo vocabulário médico personalizado no momento em que você cria esse novo vocabulário personalizado.  
Para saber mais sobre como usar tags com o Amazon Transcribe, consulte [Recursos de tags](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html).  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 1 item. Número máximo de 200 itens.  
Obrigatório: não

 ** [VocabularyFileUri](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyFileUri"></a>
A localização (URI) do Amazon S3 do arquivo de texto que contém seu vocabulário médico personalizado. O URI deve estarRegião da AWS igual ao recurso que você está chamando.  
Veja um exemplo de caminho de URI:`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt`   
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2000.  
Padrão: `(s3://|http(s*)://).+`   
Obrigatório: Sim

 ** [VocabularyName](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyName"></a>
Um nome exclusivo, escolhido por você, para seu novo vocabulário médico personalizado.  
Esse nome diferencia maiúsculas de minúsculas, não pode conter espaços e deve ser exclusivo em umConta da AWS. Se você tentar criar um novo vocabulário médico personalizado com o mesmo nome de um vocabulário médico personalizado existente, você receberá um`ConflictException` erro.  
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
<a name="API_CreateMedicalVocabulary_ResponseSyntax"></a>

```
{
   "FailureReason": "string",
   "LanguageCode": "string",
   "LastModifiedTime": number,
   "VocabularyName": "string",
   "VocabularyState": "string"
}
```

## Elementos de resposta
<a name="API_CreateMedicalVocabulary_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.

 ** [FailureReason](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-FailureReason"></a>
Em caso`VocabularyState``FAILED` afirmativo,`FailureReason` contém informações sobre por que a solicitação de trabalho de transcrição médica falhou. Veja também: [Erros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html).  
Tipo: String

 ** [LanguageCode](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-LanguageCode"></a>
O código do idioma que você selecionou para seu vocabulário médico personalizado. O inglês dos EUA (`en-US`) é o único idioma compatível com o Amazon Transcribe Medical.  
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_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-LastModifiedTime"></a>
A data e a hora em que você criou seu vocabulário médico personalizado.  
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

 ** [VocabularyName](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyName"></a>
O nome que você escolheu para seu vocabulário médico personalizado.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+` 

 ** [VocabularyState](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyState"></a>
O estado de processamento do seu vocabulário médico personalizado. Se o estado for`READY`, você pode usar o vocabulário personalizado em uma`StartMedicalTranscriptionJob` solicitação.  
Tipo: String  
Valores válidos:` PENDING | READY | FAILED` 

## Erros
<a name="API_CreateMedicalVocabulary_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

 ** ConflictException **   
Já existe um recurso com esse nome. Os nomes dos 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 fazer sua solicitação 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

## Consulte também
<a name="API_CreateMedicalVocabulary_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/CreateMedicalVocabulary) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateMedicalVocabulary)