QueryJobList_媒体处理_API文档-阿里云OpenAPI开发者门户

接口说明

本接口一次最多查询 10 个转码作业。
如果不传入 JobIds，则会返回InvalidParameter（参数无效）错误码。

QPS 限制

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

mts:QueryJobList	Get	全部资源 *	无	无

请求参数

字段名称	字段详情
JobIdsstring	转码作业 ID。展开详情示例值:bb558c1cc25b45309aab5be44d19**,d1ce4d3efcb549419193f50f1fcd**参考取值来源: ListJob SubmitJobs

返回参数

字段名称	字段详情
NonExistJobIdsobject
RequestIdstring	请求 ID。示例值:197ADF44-104C-514C-9F92-D8924CB34E2A
JobListobject

返回说明

回调消息格式定义

当转码任务执行状态改变时，mps 会发送消息到用户指定的 queue 中（如何指定回调 queue 详见 mps 的更新管道接口）。消息体是一个 JSON 字符串，包含字段如下：

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}

名称	类型	描述
Type	String	固定字符串“Transcode”，表示转码任务。
JobId	String	任务唯一 ID。
State	String	任务当前状态，与 QueryJobList 中的 State 一致。
UserData	String	用户在 SubmitJobs 中传入的 UserData。

返回示例

变更历史

	变更时间	变更内容概要	操作
	2023-09-21	变更返回参数
	2023-08-03	变更返回参数
	2023-06-13	变更返回参数
	2023-06-13	删除请求参数IncludePipelineInfo