本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
ListTranscriptionJobs
提供符合指定条件的转录作业。如果未指定任何条件，则返回所有转录作业。
要获取有关特定转录作业，请使用GetTranscriptionJob操作。
请求语法
{
"JobNameContains": "string",
"MaxResults": number,
"NextToken": "string",
"Status": "string"
}请求参数
有关由所有操作共享的参数的信息，请参阅Comon Parameters (常用参数)。
请求接受采用 JSON 格式的以下数据。
- JobNameContains
-
仅返回包含指定字符串的转录作业。搜索不区分大小写。
类型：字符串
长度限制：最小长度为 1。最大长度为 200。
模式：
^[0-9a-zA-Z._-]+必需：否
- MaxResults
-
每页结果中返回的最大转录作业数。如果结果少于您指定的值，则仅返回实际结果。如果您未指定值，则将使用默认值 5。
类型：整数
有效范围：最小值为 1。最大值为 100。
必需：否
- NextToken
-
如果您的
ListTranscriptionJobs请求返回的结果多于可以显示的结果，NextToken则会在响应中显示相关字符串。要获取下一页结果，请复制此字符串并重复您的请求，包括NextToken复制的字符串的值。根据需要重复操作以查看所有结果。类型：字符串
长度约束：最大长度为 8192。
模式：
.+必需：否
- Status
-
仅返回具有指定状态的转录作业。任务按创建日期排序，最新的作业排在最前面。如果不包括
Status，则会返回所有转录任务。类型：字符串
有效值:
QUEUED | IN_PROGRESS | FAILED | COMPLETED必需：否
响应语法
{
"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"
}
]
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- NextToken
-
NextToken如果您的回复中存在，则表示未显示所有结果。要查看下一组结果，请在结果输出中复制与NextToken参数关联的字符串，然后再次运行请求，包括NextToken复制的字符串的值。根据需要重复操作以查看所有结果。类型：字符串
长度约束：最大长度为 8192。
模式：
.+ - Status
-
列出所有具有请求中指定状态的转录任务。任务按创建日期排序，最新的作业排在最前面。
类型：字符串
有效值:
QUEUED | IN_PROGRESS | FAILED | COMPLETED - TranscriptionJobSummaries
-
提供有关每个结果的信息摘要。
类型：TranscriptionJobSummary 对象数组
错误
有关所有操作常见错误的信息，请参阅常见错误。
- BadRequestException
-
您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如
IN PROGRESS）时，可能会发生这种情况。有关更多信息，请参阅 “异常消息” 字段。HTTP 状态代码：400
- InternalFailureException
-
遇到了内部错误。检查错误消息、更正问题，然后重试请求。
HTTP 状态代码：500
- LimitExceededException
-
您要么发送了太多请求，要么输入文件太长。请稍候，然后再重试您的请求，或者使用较小的文件重试您的请求。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：