Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Crea un vocabulario médico personalizado.

Antes de crear un nuevo vocabulario médico personalizado, primero debe cargar un archivo de texto que contenga las nuevas entradas, frases y términos en un bucket de Amazon S3. Tenga en cuenta que esto difiere de[CreateVocabulary](API_CreateVocabulary.md), donde puede incluir una lista de términos en su solicitud utilizando la`Phrases` marca;`CreateMedicalVocabulary` no es compatible con la`Phrases` marca.

Cada idioma tiene un conjunto de caracteres que contiene todos los caracteres permitidos para ese idioma específico. Si utilizas caracteres no compatibles, se producirá un error en tu solicitud de vocabulario personalizado. Consulte [Conjuntos de caracteres para obtener vocabulario personalizado](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) para obtener el conjunto de caracteres de su idioma.

Para obtener más información, consulte [Vocabularios personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html).

## Sintaxis de la solicitud
<a name="API_CreateMedicalVocabulary_RequestSyntax"></a>

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

## Parámetros de solicitud
<a name="API_CreateMedicalVocabulary_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [LanguageCode](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-LanguageCode"></a>
El código de idioma que representa el idioma de las entradas del vocabulario personalizado. El inglés de EE. UU. (`en-US`) es el único idioma admitido en Amazon Transcribe Medical.  
Tipo: cadena  
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`   
Obligatorio: sí

 ** [Tags](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-Tags"></a>
Añade una o más etiquetas personalizadas, cada una en forma de par clave:valor, a un nuevo vocabulario médico personalizado al crear este nuevo vocabulario personalizado.  
Para obtener más información sobre cómo usar etiquetas de para usar etiquetas de para usar Amazon Transcribe etiquetas de para usar etiquetas de para usar etiquetas de para usar [etiquetas de](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html) para usar  
Tipo: Matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 200 elementos.  
Obligatorio: no

 ** [VocabularyFileUri](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyFileUri"></a>
La ubicación de Amazon S3 (URI) del archivo de texto que contiene su vocabulario médico personalizado. El URI debe estar en elRegión de AWS mismo que el recurso al que llamas.  
A continuación se muestra un ejemplo de ruta de URI:`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt`   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2000 caracteres.  
Patrón: `(s3://|http(s*)://).+`   
Obligatorio: sí

 ** [VocabularyName](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyName"></a>
Un nombre único, elegido por usted, para su nuevo vocabulario médico personalizado.  
Este nombre distingue entre mayúsculas y minúsculas, no puede contener espacios y debe ser único dentro de unCuenta de AWS. Si intentas crear un nuevo vocabulario médico personalizado con el mismo nombre que un vocabulario médico personalizado existente,`ConflictException` aparece un error.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.  
Patrón: `^[0-9a-zA-Z._-]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateMedicalVocabulary_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateMedicalVocabulary_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [FailureReason](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-FailureReason"></a>
Si`VocabularyState` es así`FAILED`,`FailureReason` contiene información sobre por qué falló la solicitud de trabajo de transcripción médica. Consulte también: [Errores comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html).  
Tipo: cadena

 ** [LanguageCode](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-LanguageCode"></a>
El código de idioma que seleccionó para su vocabulario médico personalizado. El inglés de EE. UU. (`en-US`) es el único idioma admitido en Amazon Transcribe Medical.  
Tipo: cadena  
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>
La fecha y la hora en que creaste tu vocabulario médico personalizado.  
Las marcas de tiempo están en el formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por ejemplo,`2022-05-04T12:32:58.761000-07:00` representa a las 12:32 p. m., hora peninsular española, del 4 de mayo de 2022.  
Tipo: marca temporal

 ** [VocabularyName](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyName"></a>
El nombre que elegiste para tu vocabulario médico personalizado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.  
Patrón: `^[0-9a-zA-Z._-]+` 

 ** [VocabularyState](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyState"></a>
El estado de procesamiento de su vocabulario médico personalizado. Si el estado lo es`READY`, puedes usar el vocabulario personalizado en una`StartMedicalTranscriptionJob` solicitud.  
Tipo: cadena  
Valores válidos:` PENDING | READY | FAILED` 

## Errores
<a name="API_CreateMedicalVocabulary_Errors"></a>

Para obtener información sobre los errores comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).

 ** BadRequestException **   
Tu solicitud no ha superado una o más pruebas de validación. Esto puede ocurrir cuando la entidad que intentas eliminar no existe o si se encuentra en un estado no terminal (por ejemplo`IN PROGRESS`). Para obtener más información, consulte el campo del mensaje de excepción.  
Código de estado HTTP: 400

 ** ConflictException **   
Ya existe un recurso con este nombre. Los nombres de recursos deben ser únicos dentro deCuenta de AWS.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se produjo un error del para usar. Compruebe el mensaje de error, corrija el problema y vuelva a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Has enviado demasiadas solicitudes o tu archivo de entrada es demasiado largo. Espere antes de volver a intentar la solicitud o utilice un archivo más pequeño y vuelva a intentarlo.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateMedicalVocabulary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK para 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) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateMedicalVocabulary)