기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

TaskID를 기반으로 특정 SpeechSynthesisTask 객체를 검색합니다. 이 객체에는 작업 상태, 작업 출력물의 S3 버킷의 링크 등 주어진 스피치 합성 작업에 대한 정보가 포함되어 있습니다.

## Request Syntax
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

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

## URI 요청 파라미터
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Amazon Polly에서 생성한 스피치 합성 작업의 고유 식별자입니다.  
패턴: `^[a-zA-Z0-9_-]{1,100}$`   
필수 여부: 예

## Request Body
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<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"
   }
}
```

## 응답 요소
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
출력 형식, 생성 시간, 작업 상태 등을 포함하여 요청된 작업의 정보를 제공하는 SynthesisTask 객체입니다.  
타입: [SynthesisTask](API_SynthesisTask.md) 객체

## 오류
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
제공한 작업 ID가 유효하지 않습니다. 유효한 작업 ID를 제공하고 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ServiceFailureException **   
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.  
HTTP 상태 코드: 500

 ** SynthesisTaskNotFoundException **   
요청된 작업 ID가 있는 스피치 합성 작업을 찾을 수 없습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_GetSpeechSynthesisTask_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask)