本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# ListTranscriptionJobs
<a name="API_ListTranscriptionJobs"></a>

提供符合指定条件的转录作业。如果未指定任何条件，则返回所有转录作业。

要获取有关特定转录作业，请使用[GetTranscriptionJob](API_GetTranscriptionJob.md)操作。

## 请求语法
<a name="API_ListTranscriptionJobs_RequestSyntax"></a>

```
{
   "JobNameContains": "string",
   "MaxResults": number,
   "NextToken": "string",
   "Status": "string"
}
```

## 请求参数
<a name="API_ListTranscriptionJobs_RequestParameters"></a>

有关由所有操作共享的参数的信息，请参阅Comon Parameters ([常用参数](CommonParameters.md))。

请求接受采用 JSON 格式的以下数据。

 ** [JobNameContains](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-JobNameContains"></a>
仅返回包含指定字符串的转录作业。搜索不区分大小写。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[0-9a-zA-Z._-]+`  
必需：否

 ** [MaxResults](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-MaxResults"></a>
每页结果中返回的最大转录作业数。如果结果少于您指定的值，则仅返回实际结果。如果您未指定值，则将使用默认值 5。  
类型：整数  
有效范围：最小值为 1。最大值为 100。  
必需：否

 ** [NextToken](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-NextToken"></a>
如果您的`ListTranscriptionJobs`请求返回的结果多于可以显示的结果，`NextToken`则会在响应中显示相关字符串。要获取下一页结果，请复制此字符串并重复您的请求，包括`NextToken`复制的字符串的值。根据需要重复操作以查看所有结果。  
类型：字符串  
长度约束：最大长度为 8192。  
模式：`.+`  
必需：否

 ** [Status](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-Status"></a>
仅返回具有指定状态的转录作业。任务按创建日期排序，最新的作业排在最前面。如果不包括`Status`，则会返回所有转录任务。  
类型：字符串  
有效值:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
必需：否

## 响应语法
<a name="API_ListTranscriptionJobs_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Status": "string",
   "TranscriptionJobSummaries": [ 
      { 
         "CompletionTime": number,
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "CreationTime": number,
         "FailureReason": "string",
         "IdentifiedLanguageScore": number,
         "IdentifyLanguage": boolean,
         "IdentifyMultipleLanguages": boolean,
         "LanguageCode": "string",
         "LanguageCodes": [ 
            { 
               "DurationInSeconds": number,
               "LanguageCode": "string"
            }
         ],
         "ModelSettings": { 
            "LanguageModelName": "string"
         },
         "OutputLocationType": "string",
         "StartTime": number,
         "TranscriptionJobName": "string",
         "TranscriptionJobStatus": "string"
      }
   ]
}
```

## 响应元素
<a name="API_ListTranscriptionJobs_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

 ** [NextToken](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-NextToken"></a>
`NextToken`如果您的回复中存在，则表示未显示所有结果。要查看下一组结果，请在结果输出中复制与`NextToken`参数关联的字符串，然后再次运行请求，包括`NextToken`复制的字符串的值。根据需要重复操作以查看所有结果。  
类型：字符串  
长度约束：最大长度为 8192。  
模式：`.+`

 ** [Status](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-Status"></a>
列出所有具有请求中指定状态的转录任务。任务按创建日期排序，最新的作业排在最前面。  
类型：字符串  
有效值:` QUEUED | IN_PROGRESS | FAILED | COMPLETED` 

 ** [TranscriptionJobSummaries](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-TranscriptionJobSummaries"></a>
提供有关每个结果的信息摘要。  
类型：[TranscriptionJobSummary](API_TranscriptionJobSummary.md) 对象数组

## 错误
<a name="API_ListTranscriptionJobs_Errors"></a>

有关所有操作常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** BadRequestException **   
您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如`IN PROGRESS`）时，可能会发生这种情况。有关更多信息，请参阅 “异常消息” 字段。  
HTTP 状态代码：400

 ** InternalFailureException **   
遇到了内部错误。检查错误消息、更正问题，然后重试请求。  
HTTP 状态代码：500

 ** LimitExceededException **   
您要么发送了太多请求，要么输入文件太长。请稍候，然后再重试您的请求，或者使用较小的文件重试您的请求。  
HTTP 状态代码：400

## 另请参阅
<a name="API_ListTranscriptionJobs_SeeAlso"></a>

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：
+  [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS适用于 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/ListTranscriptionJobs)