ListSpeechSynthesisTasks - Amazon Polly

ListSpeechSynthesisTasks

Restituisce un elenco di oggetti SpeechSynthesisTask ordinati in base alla data di creazione. Questa operazione consente di filtrare le attività in base al relativo stato, ad esempio consentendo agli utenti di elencare solo le attività completate.

Sintassi della richiesta

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

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

MaxResults

Numero massimo di attività di sintesi vocale restituite in un'operazione List.

Intervallo valido: valore minimo di 1. valore massimo pari a 100.

NextToken

Il token di impaginazione da utilizzare nella richiesta successiva per continuare l'elenco delle attività di sintesi vocale.

Vincoli di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

Status

Stato delle attività di sintesi vocale restituite in un'operazione List

Valori validi: scheduled | inProgress | completed | failed

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

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" } ] }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

Un token di impaginazione opaco restituito dall'operazione List precedente in questa richiesta. Se presente, indica dove continuare l'inserzione.

Tipo: string

Vincoli di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

SynthesisTasks

Elenco di oggetti SynthesisTask che fornisce informazioni dall'attività specificata nella richiesta elenco, inclusi il formato di output, l'ora di creazione, lo stato dell'attività e così via.

Tipo: matrice di oggetti SynthesisTask

Errori

InvalidNextTokenException

Il NextToken non è valido. Verificare che sia stato digitato correttamente, quindi riprovare.

Codice di stato HTTP: 400

ServiceFailureException

Una condizione sconosciuta ha causato un errore di servizio.

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: