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á.

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Recupera um SpeechSynthesisTask objeto específico com base em seu TaskID. Esse objeto contém informações sobre determinada tarefa de síntese de fala, incluindo o status da tarefa e um link para o bucket do S3 contendo a saída da tarefa.

## Sintaxe da Solicitação
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

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

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
O identificador gerado pelo Amazon Polly para uma tarefa de síntese de fala.  
Padrão: `^[a-zA-Z0-9_-]{1,100}$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "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
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

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

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objeto que fornece informações da tarefa solicitada, incluindo formato de saída, hora de criação, status da tarefa e assim por diante.  
Tipo: objeto [SynthesisTask](API_SynthesisTask.md)

## Erros
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
O ID da tarefa fornecido não é válido. Forneça um ID de tarefa válido e tente novamente.  
Código de status HTTP: 400

 ** ServiceFailureException **   
Uma condição desconhecida causou uma falha no serviço.  
Código de status HTTP: 500

 ** SynthesisTaskNotFoundException **   
A tarefa de Síntese de Fala com o ID de tarefa solicitado não foi encontrada.  
Código de Status HTTP: 400

## Consulte também
<a name="API_GetSpeechSynthesisTask_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask)