调用ListTranscodeTask根据音视频ID查询音视频历史转码任务信息，本接口不返回具体的作业信息。

使用说明

  • 如需查询详细的转码作业信息，可以调用GetTranscodeTask接口查询。
  • 本接口仅支持查询一年内的转码任务数据。

QPS限制

本接口的单用户QPS限制为15次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListTranscodeTask

系统规定参数。取值：ListTranscodeTask。

VideoId String 是 d4860fcc6a5*****bce9fed52e893824

音/视频ID。可通过以下方式获取：

  • 通过控制台上传的音/视频，可登录点播控制台，选择媒资库 > 音/视频查看音/视频ID。
  • 通过CreateUploadVideo接口获取上传地址和凭证时，音/视频ID为返回参数VideoId的值。
  • 音/视频上传后，可通过SearchMedia接口查询音/视频ID，为请求后返回参数VideoId的值。
StartTime String 否 2019-01-23T12:35:12Z

开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

EndTime String 否 2019-01-23T12:40:12Z

结束时间（需晚于开始时间）。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

PageSize Integer 否 10

查询页数据大小，传入此参数，立刻设置返回数据每页显示的条数。最大值为50，默认值为10。

PageNo Integer 否 1

查询数据的当前页码。传入此参数，可指定查询数据从第几页开始返回。默认值为1。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4A*****F6-D7393642CA58

请求ID。
TranscodeTaskList Array of TranscodeTask

转码处理信息列表。
CreationTime String 2019-01-23T12:35:12Z

转码任务创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

Trigger String Auto

触发类型。取值：

  • Auto：上传视频，自动触发。
  • Manual：SubmitTranscodeJobs接口触发。
TaskStatus String Processing

转码任务状态。

  • Processing：处理中。
  • Partial：部分转码完成。
  • CompleteAllSucc：全部处理完成，且全部转码成功。
  • CompleteAllFail：全部处理完成，且全部转码失败，如果源片有问题，则不会发起任何转码作业，整个转码任务失败。
  • CompletePartialSucc：全部转码完成，但仅部分转码成功。
VideoId String d4860fcc6a5*****bce9fed52e893824

音/视频ID。
CompleteTime String 2019-01-23T12:40:12Z

转码任务完成时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

TranscodeTemplateGroupId String b500c7094bd24*****f3e9900752d7c3

转码使用的模板组ID。
TranscodeTaskId String b1b65ab107*****ba3dbb900f6c1fe0

转码任务ID。

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=ListTranscodeTask
&VideoId=d4860fcc6a5*****bce9fed52e893824
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTranscodeTaskResponse>
    <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	<TranscodeTaskList>
		<TranscodeTaskId>b1b65ab107*****ba3dbb900f6c1fe0</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>Processing</TaskStatus>
		<TranscodeTemplateGroupId>b500c7094bd24*****f3e9900752d7c3</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
	<TranscodeTaskList>
		<TranscodeTaskId>91449a74a9d7*****31e179a1ec1e</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>CompeleteAllSucc</TaskStatus>
		<TranscodeTemplateGroupId>947b9f5b0eb*****3d985df69d76b7</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
</ListTranscodeTaskResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeTaskList" : [ {
    "TranscodeTaskId" : "b1b65ab107*****ba3dbb900f6c1fe0",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "Processing",
    "TranscodeTemplateGroupId" : "b500c7094bd24*****f3e9900752d7c3",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  }, {
    "TranscodeTaskId" : "91449a74a9d7*****31e179a1ec1e",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "CompeleteAllSucc",
    "TranscodeTemplateGroupId" : "947b9f5b0eb*****3d985df69d76b7",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  } ]
}

错误码

访问错误中心查看更多错误码。