ListSpeechSynthesisTasks - Amazon Polly

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ListSpeechSynthesisTasks

Retorna uma lista de SpeechSynthesisTask objetos ordenados pela data de criação. Essa operação pode filtrar as tarefas pelo status. Por exemplo, permitindo que os usuários listem somente as tarefas concluídas.

Sintaxe da Solicitação

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

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

MaxResults

Número máximo de tarefas de síntese de voz retornadas em uma operação de lista.

Intervalo válido: valor mínimo de 1. Valor máximo de 100.

NextToken

O token de paginação a ser usado na próxima solicitação para continuar a listagem das tarefas de síntese de fala.

Restrições de tamanho: o tamanho mínimo é 0. Comprimento máximo de 4.096.

Status

Status das tarefas de síntese de fala retornadas em uma operação de Lista

Valores Válidos: scheduled | inProgress | completed | failed

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da Resposta

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

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

NextToken

Um token de paginação opaco retornado da operação de Lista anterior nessa solicitação. Se presente, indica onde continuar a listagem.

Tipo: string

Restrições de tamanho: tamanho mínimo 0. Comprimento máximo de 4.096.

SynthesisTasks

Lista de SynthesisTask objetos que fornece informações da tarefa especificada na solicitação de lista, incluindo formato de saída, hora de criação, status da tarefa e assim por diante.

Tipo: matriz de objetos SynthesisTask

Erros

InvalidNextTokenException

O NextToken é inválido. Verifique se ele está escrito corretamente e tente de novo.

Código de Status HTTP: 400

ServiceFailureException

Uma condição desconhecida causou uma falha no serviço.

Código de Status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: