Amazon Transcribe
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

ListTranscriptionJobs

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

Request Syntax

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

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

JobNameContains

Type: String

Length Constraints: Minimum length of 1. Maximum length of 200.

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

Required: No

MaxResults

返回任务响应的最大数量。

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

NextToken

如果因以前的请求 ListTranscriptionJobs 已被截断的消息,包括 NextToken 为了获取下一组任务。

Type: String

Length Constraints: Maximum length of 8192.

Pattern: .+

Required: No

Status

如果已指定,则仅返回指定状态的转录任务。

Type: String

Valid Values: IN_PROGRESS | FAILED | COMPLETED

Required: No

Response Syntax

{ "NextToken": "string", "Status": "string", "TranscriptionJobSummaries": [ { "CompletionTime": number, "CreationTime": number, "FailureReason": "string", "LanguageCode": "string", "OutputLocationType": "string", "TranscriptionJobName": "string", "TranscriptionJobStatus": "string" } ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

ListTranscriptionJobs 操作一次,会返回一个任务页面。MaxResults参数设置的页面大小。如果列表中的更多的任务, 那么页面大小, Amazon Transcribe 将返回 NextPage 的令牌。包含令牌的下一个请求操作ListTranscriptionJobs,以返回下一页面。

Type: String

Length Constraints: Maximum length of 8192.

Pattern: .+

Status

作业返回的请求状态。

Type: String

Valid Values: IN_PROGRESS | FAILED | COMPLETED

TranscriptionJobSummaries

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

Type: Array of TranscriptionJobSummary objects

Errors

For information about the errors that are common to all actions, see Common Errors.

BadRequestException

某个输入字段存在问题。检查 S3 存储桶名称,请确保任务名称不重复,并确认您正在使用正确的文件格式。然后重新发送您的请求。

HTTP Status Code: 400

InternalFailureException

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

HTTP Status Code: 500

LimitExceededException

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

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: