Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée un vocabulaire médical personnalisé.

Avant de créer un nouveau vocabulaire médical personnalisé, vous devez d'abord charger un fichier texte contenant vos nouvelles entrées, expressions et termes dans un compartiment Amazon S3. Notez que cela diffère du[CreateVocabulary](API_CreateVocabulary.md) fait que vous pouvez inclure une liste de termes dans votre demande à l'aide de l'`Phrases`indicateur ;`CreateMedicalVocabulary` il ne prend pas en charge l'`Phrases`indicateur.

Chaque langue possède un jeu de caractères qui contient tous les caractères autorisés pour cette langue spécifique. Si vous utilisez des caractères non pris en charge, votre demande de vocabulaire personnalisé échoue. Reportez-vous à la [section Jeux de caractères pour les vocabulaires personnalisés](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) pour obtenir le jeu de caractères correspondant à votre langue.

Pour de plus amples informations, veuillez consulter [Vocabulaires personnalisés](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html).

## Syntaxe de la requête
<a name="API_CreateMedicalVocabulary_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_CreateMedicalVocabulary_RequestParameters"></a>

Pour plus d'informations sur les paramètres communs à toutes les actions, voir [Paramètres communs](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [LanguageCode](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-LanguageCode"></a>
Code de langue qui représente la langue des entrées de votre vocabulaire personnalisé. L'anglais américain (`en-US`) est la seule langue prise en charge par Amazon Transcribe Medical.  
Type : String  
Valeurs valides :` 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`   
Obligatoire : oui

 ** [Tags](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-Tags"></a>
Ajoute une ou plusieurs balises personnalisées, chacune sous la forme d'une paire clé:valeur, à un nouveau vocabulaire médical personnalisé au moment où vous créez ce nouveau vocabulaire personnalisé.  
Pour en savoir plus sur l'utilisation des balises avec Amazon Transcribe, consultez [Ressources sur le balisage](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html).  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

 ** [VocabularyFileUri](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyFileUri"></a>
Emplacement Amazon S3 (URI) du fichier texte contenant votre vocabulaire médical personnalisé. L'URI doit êtreRégion AWS identique à celui de la ressource que vous appelez.  
Voici un exemple de chemin d'URI :`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt`   
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 2000.  
Modèle : `(s3://|http(s*)://).+`   
Obligatoire : oui

 ** [VocabularyName](#API_CreateMedicalVocabulary_RequestSyntax) **   <a name="transcribe-CreateMedicalVocabulary-request-VocabularyName"></a>
Un nom unique, choisi par vous, pour votre nouveau vocabulaire médical personnalisé.  
Ce nom distingue les majuscules, ne peut pas contenir d'espaces et doit être unique au sein d'unCompte AWS. Si vous essayez de créer un nouveau vocabulaire médical personnalisé portant le même nom qu'un vocabulaire médical personnalisé existant, vous obtenez une`ConflictException` erreur.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.  
Modèle : `^[0-9a-zA-Z._-]+`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateMedicalVocabulary_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_CreateMedicalVocabulary_ResponseElements"></a>

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [FailureReason](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-FailureReason"></a>
Si`VocabularyState` c'est`FAILED` le cas,`FailureReason` contient des informations sur les raisons pour lesquelles la demande de transcription médicale a échoué. Voir également : [Erreurs courantes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html).  
Type : String

 ** [LanguageCode](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-LanguageCode"></a>
Le code de langue que vous avez sélectionné pour votre vocabulaire médical personnalisé. L'anglais américain (`en-US`) est la seule langue prise en charge par Amazon Transcribe Medical.  
Type : String  
Valeurs valides :` 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>
Date et heure auxquelles vous avez créé votre vocabulaire médical personnalisé.  
Les horodatages sont au format`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Par exemple,`2022-05-04T12:32:58.761000-07:00` représente 12 h 32 UTC-7 le 4 mai 2022.  
Type : horodatage

 ** [VocabularyName](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyName"></a>
Le nom que vous avez choisi pour votre vocabulaire médical personnalisé.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.  
Modèle : `^[0-9a-zA-Z._-]+` 

 ** [VocabularyState](#API_CreateMedicalVocabulary_ResponseSyntax) **   <a name="transcribe-CreateMedicalVocabulary-response-VocabularyState"></a>
État de traitement de votre vocabulaire médical personnalisé. Si l'état l'est`READY`, vous pouvez utiliser le vocabulaire personnalisé dans une`StartMedicalTranscriptionJob` demande.  
Type : String  
Valeurs valides :` PENDING | READY | FAILED` 

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

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** BadRequestException **   
Votre demande n'a pas passé un ou plusieurs tests de validation. Cela peut se produire lorsque l'entité que vous essayez de supprimer n'existe pas ou si elle est dans un état non terminal (par exemple`IN PROGRESS`). Consultez le champ du message d'exception pour plus d'informations.  
Code d'état HTTP : 400

 ** ConflictException **   
Une ressource portant ce nom existe déjà. Les noms de ressource doivent être uniques dans unCompte AWS.  
Code d'état HTTP : 400

 ** InternalFailureException **   
Une erreur interne s'est produite. Vérifiez le message d'erreur, corrigez le problème et réessayez votre demande.  
Code d'état HTTP : 500

 ** LimitExceededException **   
Vous avez envoyé trop de demandes ou votre fichier d'entrée est trop long. Attendez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_CreateMedicalVocabulary_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [Kit AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateMedicalVocabulary) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateMedicalVocabulary)