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

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

생성일을 기준으로 정렬된 SpeechSynthesisTask 객체 목록을 반환합니다. 이 작업을 통해 상태를 기준으로 작업을 필터링할 수 있습니다. 예를 들어 완료된 작업만 표시되도록 할 수 있습니다.

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

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

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

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

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
목록 작업에서 반환되는 스피치 합성 작업의 최대 수입니다.  
유효 범위: 최소값 1. 최댓값은 100입니다.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
스피치 합성 작업 목록을 계속 나열하기 위해 다음 요청에서 사용할 페이지 매김 토큰입니다.  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
목록 작업에서 반환된 스피치 합성 작업의 상태입니다.  
유효한 값: `scheduled | inProgress | completed | failed` 

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

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

## Response Syntax
<a name="API_ListSpeechSynthesisTasks_ResponseSyntax"></a>

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

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

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

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

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
이 요청의 이전 목록 작업에서 반환된 불투명한 페이지 매김 토큰입니다. 존재하는 경우 이는 목록을 계속해야 할 위치를 나타냅니다.  
유형: 문자열  
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

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

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

 ** InvalidNextTokenException **   
NextToken이 유효하지 않습니다. 철자가 정확한지 확인한 다음 다시 시도하세요.  
HTTP 상태 코드: 400

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

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

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