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.
GetVocabulary
Fournit des informations sur le vocabulaire personnalisé spécifié.
Pour voir l'état du vocabulaire personnalisé spécifié, consultez leVocabularyState
champ. Si le statut estREADY
, votre vocabulaire personnalisé peut être utilisé. Si le statut estFAILED
,FailureReason
fournit des informations sur la raison pour laquelle votre vocabulaire personnalisé a échoué.
Pour obtenir la liste de vos vocabulaires personnalisés, utilisez l'ListVocabulariesopération.
Syntaxe de la requête
{
"VocabularyName": "string
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- VocabularyName
-
Le nom du vocabulaire personnalisé sur lequel vous souhaitez obtenir des informations. 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
{
"DownloadUri": "string",
"FailureReason": "string",
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}
Eléments de réponse
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.
- DownloadUri
-
Emplacement S3 où le vocabulaire personnalisé est stocké ; utilisez cet URI pour afficher ou télécharger le vocabulaire personnalisé.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 2000.
Modèle :
(s3://|http(s*)://).+
- FailureReason
-
Si tel
VocabularyState
estFAILED
le cas,FailureReason
contient des informations sur la raison pour laquelle la demande de vocabulaire personnalisé a échoué. Voir également : Erreurs courantes.Type : String
- LanguageCode
-
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
-
Date et heure auxquelles le vocabulaire personnalisé spécifié a été modifié pour la dernière fois.
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
-
Le nom du vocabulaire personnalisé pour lequel vous avez demandé des informations.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.
Modèle :
^[0-9a-zA-Z._-]+
- VocabularyState
-
État de traitement de votre vocabulaire personnalisé. Si l'état l'est
READY
, vous pouvez utiliser le vocabulaire personnalisé dans uneStartTranscriptionJob
demande.Type : String
Valeurs valides :
PENDING | READY | FAILED
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- 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
- InternalFailureException
-
Une erreur interne s'est produite. Vérifiez le message d'erreur, résolvez 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. Patientez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez.
Code d'état HTTP : 400
- NotFoundException
-
Impossible de trouver 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
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 :