ListTranscriptionJobs - Transcribe
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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.

ListTranscriptionJobs

Fournit une liste des tâches de transcription correspondant aux critères spécifiés. Si aucun critère n'est spécifié, toutes les tâches de transcription sont renvoyées.

Pour obtenir des informations détaillées sur une tâche de transcription spécifique, utilisez l'GetTranscriptionJobopération.

Syntaxe de la requête

{
   "JobNameContains": "string",
   "MaxResults": number,
   "NextToken": "string",
   "Status": "string"
}

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, consultez la section Paramètres communs.

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

JobNameContains

Renvoie uniquement les tâches de transcription contenant la chaîne spécifiée. La recherche n'est pas sensible à la casse.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.

Modèle : ^[0-9a-zA-Z._-]+

Obligatoire : non

MaxResults

Le nombre maximum de tâches de transcription à renvoyer sur chaque page de résultats. S'il y a moins de résultats que la valeur que vous spécifiez, seuls les résultats réels sont renvoyés. Si vous ne spécifiez aucune valeur, 5 par défaut est utilisée.

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

Obligatoire : non

NextToken

Si votreListTranscriptionJobs demande renvoie plus de résultats que ce qui peut être affiché, celaNextToken s'affiche dans la réponse avec une chaîne associée. Pour obtenir la page de résultats suivante, copiez cette chaîne et répétez votre demande, y comprisNextToken avec la valeur de la chaîne copiée. Répétez l'opération si nécessaire pour voir tous vos résultats.

Type : String

Contraintes de longueur : Longueur maximum de 8192.

Modèle : .+

Obligatoire : non

Status

Renvoie uniquement les tâches de transcription avec le statut spécifié. Les offres d'emploi sont classées par date de création, en commençant par la plus récente. Si vous n'incluez pasStatus, toutes les tâches de transcription sont renvoyées.

Type : String

Valeurs valides : QUEUED | IN_PROGRESS | FAILED | COMPLETED

Obligatoire : non

Syntaxe de la réponse

{
   "NextToken": "string",
   "Status": "string",
   "TranscriptionJobSummaries": [ 
      { 
         "CompletionTime": number,
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "CreationTime": number,
         "FailureReason": "string",
         "IdentifiedLanguageScore": number,
         "IdentifyLanguage": boolean,
         "IdentifyMultipleLanguages": boolean,
         "LanguageCode": "string",
         "LanguageCodes": [ 
            { 
               "DurationInSeconds": number,
               "LanguageCode": "string"
            }
         ],
         "ModelSettings": { 
            "LanguageModelName": "string"
         },
         "OutputLocationType": "string",
         "StartTime": number,
         "TranscriptionJobName": "string",
         "TranscriptionJobStatus": "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.

NextToken

Si celaNextToken est présent dans votre réponse, cela indique que tous les résultats ne sont pas affichés. Pour afficher l'ensemble de résultats suivant, copiez la chaîne associée auNextToken paramètre dans la sortie des résultats, puis exécutez à nouveau votre demande, y comprisNextToken avec la valeur de la chaîne copiée. Répétez l'opération si nécessaire pour voir tous vos résultats.

Type : String

Contraintes de longueur : Longueur maximum de 8192.

Modèle : .+

Status

Répertorie tous les travaux de transcription dont le statut est spécifié dans votre demande. Les offres d'emploi sont classées par date de création, en commençant par la plus récente.

Type : String

Valeurs valides : QUEUED | IN_PROGRESS | FAILED | COMPLETED

TranscriptionJobSummaries

Fournit un résumé des informations relatives à chaque résultat.

Type : tableau d’objets TranscriptionJobSummary

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, reportez-vous à la sectionErreurs courantes.

BadRequestException

Votre demande n'a pas réussi un ou plusieurs tests de validation. Cela peut se produire lorsque l'entité que vous essayez de supprimer n'existe pas ou si elle n'est pas dans un état terminal (par exempleIN 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, corrigez le problème et réessayez votre demande.

Code d'état HTTP : 500

LimitExceededException

Soit vous avez envoyé trop de demandes, soit votre fichier d'entrée est trop long. Attendez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez 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 :