ListMediaProducingJobs - 列出符合条件的剪辑合成任务_智能媒体服务(IMS)-阿里云帮助中心

列出符合条件的合成任务，可根据任务状态、类型查询。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ice:ListMediaProducingJobs	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
Status	string	否	合成任务状态枚举值： Init：任务初始化。 Failed：合成失败。 Success：合成成功。 Processing：合成中。	Success
JobType	string	否	任务类型枚举值： LiveEditingJob：直播剪辑任务。 EditingJob：普通剪辑任务。 VETemplateJob：高级模板剪辑任务。	EditingJob
StartTime	string	否	开始时间。UTC 时间，格式：yyyy-MM-ddTHH:mm:ssZ。	2017-01-11T12:00:00Z
EndTime	string	否	查询结束时间，与 StartTime 相差不超过 30 天。格式为 yyyy-mm-ddthh:mm:ssz（UTC 时间）。	2022-02-02T23:59:59Z
Keyword	string	否	搜索关键词，可以根据任务 ID 搜索。	**20b48fb04483915d4f2cd8ac**
ProjectId	string	否	云剪辑工程 id	****927cfb53d05b96c1bfe1****
MasterJobId	string	否	一键成片任务 Id，当此条件不为空时，为查询一键成片任务的子任务。	****8750b54e3c976a47da6f****
NextToken	string	否	当前开始读取的位置	8EqYpQbZ6Eh7+Zz8DxVYoQ==
MaxResults	integer	否	本次请求所返回的最大记录条数。最大值：100，默认值：10	100
SortBy	string	否	排序参数，默认按创建时间倒序。枚举值： CreationTime:Asc：按照创建时间正序。 CreationTime:Desc：按照创建时间倒序。	CreationTime:Desc

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	****11-DB8D-4A9A-875B-275798****
MediaProducingJobList	array<object>	剪辑任务列表
MediaProducingJob	object	剪辑任务列表
JobId	string	云剪辑任务 id	****8750b54e3c976a47da6f****
ProjectId	string	云剪辑工程 id	****faa3b542f5a6135217e3****
MediaId	string	输出成品的资源 id	0ce4ea70f52471edab61f7e7d6786302
MediaURL	string	输出成品的资源文件 URL	http://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video.mp4
TemplateId	string	云剪辑模板 ID	cb786a39c5d44cecb23d8c864facffc1
ClipsParam	string	模板素材参数	{"Text1":"text","Text0":"text","Media1":"mediaId","Media0":"mediaId"}
Duration	float	输出成品的时长，单位：秒。	15.5
CreateTime	string	任务创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ 。	2022-03-21T16:40:00Z
CompleteTime	string	剪辑合成作业完成时间，格式为 utc 时间。	2022-03-21T16:40:30Z
ModifiedTime	string	最后更新时间。	2022-03-21T16:41:00Z
Status	string	剪辑合成作业状态	Sucess
Code	string	剪辑合成作业失败错误码	Success
Message	string	剪辑合成作业错误信息注：作业失败时关注该字段	The resource operated InputFile is bad
UserData	string	用户自定义设置	{"key":"value"}
MaxResults	string	本次请求所返回的最大记录条数。最大值：100，默认值：10	100
NextToken	string	当前开始读取的位置	8EqYpQbZ6Eh7+Zz8DxVYoQ==

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaProducingJobList": [
    {
      "JobId": "******8750b54e3c976a47da6f******",
      "ProjectId": "******faa3b542f5a6135217e3******",
      "MediaId": "0ce4ea70f52471edab61f7e7d6786302",
      "MediaURL": "http://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video.mp4",
      "TemplateId": "cb786a39c5d44cecb23d8c864facffc1",
      "ClipsParam": "{\"Text1\":\"text\",\"Text0\":\"text\",\"Media1\":\"mediaId\",\"Media0\":\"mediaId\"}",
      "Duration": 15.5,
      "CreateTime": "2022-03-21T16:40:00Z",
      "CompleteTime": "2022-03-21T16:40:30Z",
      "ModifiedTime": "2022-03-21T16:41:00Z",
      "Status": "Sucess",
      "Code": "Success",
      "Message": "The resource operated InputFile is bad",
      "UserData": "{\"key\":\"value\"}"
    }
  ],
  "MaxResults": "100",
  "NextToken": "8EqYpQbZ6Eh7+Zz8DxVYoQ=="
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-08-14	OpenAPI 入参发生变更	查看变更详情