ListTranscriptionJobs - Amazon Transcribe
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

ListTranscriptionJobs

列出具有指定状态的转录任务。

请求语法

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

请求参数

有关所有操作通用的参数的信息,请参阅常见参数.

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

JobNameContains

指定后,列表中返回的作业仅限于名称包含指定字符串的作业。

类型: 字符串

长度约束:最小长度为 1。最大长度为 200。

模式:^[0-9a-zA-Z._-]+

:必需 否

MaxResults

每页结果中要返回的作业最大数量。如果结果少于您指定的值,则只返回实际结果。如果未指定值,则使用默认值 5。

类型: 整数

有效范围:最小值为 1。最大值为 100。

:必需 否

NextToken

如果之前的请求的结果ListTranscriptionJobs已截断,请包括NextToken获取下一组任务。

类型: 字符串

长度约束:长度上限为 8192。

模式:.+

:必需 否

Status

如果已指定,则仅返回指定状态的转录任务。作业按创建日期排序,首先返回最新的作业。如果您未指定状态,Amazon Transcribe 将返回按创建日期排序的所有转录作业。

类型: 字符串

有效值: QUEUED | IN_PROGRESS | FAILED | COMPLETED

:必需 否

响应语法

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

响应元素

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

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

NextToken

这些区域有:ListTranscriptionJobs此操作一次,会返回一个任务页面。页面的最大小由MaxResults参数。如果列表中的更多的任务, 那么页面大小, Amazon Transcribe 将返回NextPage令牌。包含令牌的下一个请求ListTranscriptionJobs操作以返回下一页面。

类型: 字符串

长度约束:长度上限为 8192。

模式:.+

Status

作业返回的请求状态。

类型: 字符串

有效值: QUEUED | IN_PROGRESS | FAILED | COMPLETED

TranscriptionJobSummaries

包含汇总信息的一系列对象的转录任务。

类型: 数组TranscriptionJobSummary对象

Errors

有关所有操作中常见的错误的信息,请参阅常见错误.

BadRequestException

您的请求没有通过一个或多个验证测试。例如,如果您尝试删除的实体不存在,或者它处于非终端状态(例如,它 “正在进行中”)。请参见异常Message字段以获取更多信息。

HTTP 状态代码:400

InternalFailureException

发生内部服务器错误。检查错误消息并再次尝试请求。

HTTP 状态代码:500

LimitExceededException

您已经发送过多的请求或您的输入文件中包含过长。等待,然后再重新发送您的请求,或使用较小的文件,然后重新发送请求。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: