ListSpeechSynthesisTasks - Amazon Polly

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.

ListSpeechSynthesisTasks

Renvoie une liste d' SpeechSynthesisTask objets classés par date de création. Cette opération permet de filtrer les tâches en fonction de leur statut, par exemple en permettant aux utilisateurs de répertorier uniquement les tâches terminées.

Syntaxe de la demande

GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

MaxResults

Nombre maximal de tâches de synthèse vocale renvoyées lors d'une opération de liste.

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

NextToken

Le jeton de pagination à utiliser dans la prochaine demande pour continuer à répertorier les tâches de synthèse vocale.

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

Status

État des tâches de synthèse vocale renvoyées dans une opération de liste

Valeurs valides : scheduled | inProgress | completed | failed

Corps de la requête

La demande n’a pas de corps de requête.

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "SynthesisTasks": [ { "CreationTime": number, "Engine": "string", "LanguageCode": "string", "LexiconNames": [ "string" ], "OutputFormat": "string", "OutputUri": "string", "RequestCharacters": number, "SampleRate": "string", "SnsTopicArn": "string", "SpeechMarkTypes": [ "string" ], "TaskId": "string", "TaskStatus": "string", "TaskStatusReason": "string", "TextType": "string", "VoiceId": "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

Un jeton de pagination opaque renvoyé par l'opération List précédente dans cette demande. Le cas échéant, cela indique où continuer la liste.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 4096.

SynthesisTasks

Liste des SynthesisTask objets fournissant des informations relatives à la tâche spécifiée dans la demande de liste, notamment le format de sortie, l'heure de création, le statut de la tâche, etc.

Type : tableau d’objets SynthesisTask

Erreurs

InvalidNextTokenException

Le NextToken n'est pas valide. Vérifiez qu'il est correctement orthographié, puis réessayez.

Code d’état HTTP : 400

ServiceFailureException

Une situation inconnue a provoqué une panne de service.

Code d’état HTTP : 500

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :