

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.

# UpdateVocabulary
<a name="API_UpdateVocabulary"></a>

Met à jour un vocabulaire personnalisé existant avec de nouvelles valeurs. Cette opération remplace toutes les informations existantes par vos nouvelles valeurs ; vous ne pouvez pas ajouter de nouveaux termes à un vocabulaire personnalisé existant.

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

```
{
   "LanguageCode": "string",
   "Phrases": [ "string" ],
   "VocabularyFileUri": "string",
   "VocabularyName": "string"
}
```

## Paramètres de demande
<a name="API_UpdateVocabulary_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_UpdateVocabulary_RequestSyntax) **   <a name="transcribe-UpdateVocabulary-request-LanguageCode"></a>
Code de langue qui représente la langue des entrées du vocabulaire personnalisé que vous souhaitez mettre à jour. Chaque vocabulaire personnalisé doit contenir des termes dans une seule langue.  
Un vocabulaire personnalisé ne peut être utilisé que pour transcrire des fichiers dans la même langue que le vocabulaire personnalisé. Par exemple, si vous créez un vocabulaire personnalisé à l'aide de l'anglais américain (`en-US`), vous ne pouvez appliquer ce vocabulaire personnalisé qu'aux fichiers contenant du son en anglais.  
Pour obtenir la liste des langues prises en charge et leurs codes de langue associés, consultez le tableau des [langues prises en charge](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html).  
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

 ** [Phrases](#API_UpdateVocabulary_RequestSyntax) **   <a name="transcribe-UpdateVocabulary-request-Phrases"></a>
Utilisez ce paramètre si vous souhaitez mettre à jour votre vocabulaire personnalisé en incluant tous les termes souhaités, sous forme de valeurs séparées par des virgules, dans votre demande. L'autre option pour mettre à jour votre vocabulaire personnalisé consiste à enregistrer vos entrées dans un fichier texte et à les télécharger dans un compartiment Amazon S3, puis à spécifier l'emplacement de votre fichier à l'aide du`VocabularyFileUri` paramètre.  
Notez que si vous l'incluez`Phrases` dans votre demande, vous ne pouvez pas utiliser`VocabularyFileUri` ; vous devez choisir l'un ou l'autre.  
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 filtre 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.  
Type : tableau de chaînes  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.  
Modèle : `.+`   
Obligatoire : non

 ** [VocabularyFileUri](#API_UpdateVocabulary_RequestSyntax) **   <a name="transcribe-UpdateVocabulary-request-VocabularyFileUri"></a>
Emplacement Amazon S3 du fichier texte qui contient votre vocabulaire personnalisé. L'URI doit se situer dans le même emplacementRégion AWS que la ressource que vous appelez.  
Voici un exemple de chemin d'URI :`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt`   
Notez que si vous l'incluez`VocabularyFileUri` dans votre demande, vous ne pouvez pas utiliser le`Phrases` drapeau ; vous devez choisir l'un ou l'autre.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 2000.  
Modèle : `(s3://|http(s*)://).+`   
Obligatoire : non

 ** [VocabularyName](#API_UpdateVocabulary_RequestSyntax) **   <a name="transcribe-UpdateVocabulary-request-VocabularyName"></a>
Nom du vocabulaire personnalisé que vous souhaitez mettre à jour. Les noms de vocabulaire personnalisés sont sensibles à la casse.  
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_UpdateVocabulary_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_UpdateVocabulary_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.

 ** [LanguageCode](#API_UpdateVocabulary_ResponseSyntax) **   <a name="transcribe-UpdateVocabulary-response-LanguageCode"></a>
Le code de langue que vous avez sélectionné pour votre vocabulaire personnalisé.  
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_UpdateVocabulary_ResponseSyntax) **   <a name="transcribe-UpdateVocabulary-response-LastModifiedTime"></a>
Date et heure de la dernière mise à jour du vocabulaire personnalisé spécifié.  
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_UpdateVocabulary_ResponseSyntax) **   <a name="transcribe-UpdateVocabulary-response-VocabularyName"></a>
Nom du vocabulaire personnalisé mis à jour.  
Type : String  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.  
Modèle : `^[0-9a-zA-Z._-]+` 

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

## Erreurs
<a name="API_UpdateVocabulary_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 **   
Il existe déjà une ressource portant ce nom. 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, résolvez le problème et réessayez de répondre à votre demande.  
Code d'état HTTP : 500

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

 ** NotFoundException **   
Nous ne trouvons pas la ressource demandée. Vérifiez que le nom indiqué est correct et réessayez de faire votre demande.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_UpdateVocabulary_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/UpdateVocabulary) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/UpdateVocabulary) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/UpdateVocabulary) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/UpdateVocabulary) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/UpdateVocabulary) 
+  [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/UpdateVocabulary) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/UpdateVocabulary) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/UpdateVocabulary) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/UpdateVocabulary) 