本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
ListTranscriptionJobs
提供与指定条件匹配的转录任务列表。如果未指定任何条件，则返回所有转录任务。
要获取有关特定转录任务的详细信息，请使用GetTranscriptionJoboperation.
请求语法
{
"JobNameContains": "string",
"MaxResults": number,
"NextToken": "string",
"Status": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅常见参数.
请求接受采用 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 的更多信息，请参阅以下内容：