ListMediaProducingJobs - 列出符合条件的剪辑合成任务

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

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
Statusstring

合成任务状态

枚举值:
  • Init任务初始化
  • Failed合成失败
  • Success合成成功
  • Processing合成中
Success
JobTypestring

任务类型

枚举值:
  • LiveEditingJob直播剪辑任务
  • EditingJob普通剪辑任务
  • VETemplateJob高级模板剪辑任务
EditingJob
StartTimestring

开始时间。UTC 时间,格式:yyyy-MM-ddTHH:mm:ssZ。

2017-01-11T12:00:00Z
EndTimestring

查询结束时间,与 StartTime 相差不超过 30 天。格式为 yyyy-mm-ddthh:mm:ssz(UTC 时间)。

2022-02-02T23:59:59Z
Keywordstring

搜索关键词,可以根据任务 ID 搜索。

****20b48fb04483915d4f2cd8ac****
ProjectIdstring

云剪辑工程 id

******927cfb53d05b96c1bfe1******
MasterJobIdstring

一键成片任务 Id,当此条件不为空时,为查询一键成片任务的子任务。

******8750b54e3c976a47da6f******
NextTokenstring

当前开始读取的位置

8EqYpQbZ6Eh7+Zz8DxVYoQ==
MaxResultsinteger

本次请求所返回的最大记录条数。

最大值:100,默认值:10

100
SortBystring

排序参数,默认按创建时间倒序。

枚举值:
  • CreationTime:Asc按照创建时间正序
  • CreationTime:Desc按照创建时间倒序
CreationTime:Desc

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

Id of the request

******11-DB8D-4A9A-875B-275798******
MediaProducingJobListarray<object>

剪辑任务列表

MediaProducingJobobject

剪辑任务列表

JobIdstring

云剪辑任务 id

******8750b54e3c976a47da6f******
ProjectIdstring

云剪辑工程 id

******faa3b542f5a6135217e3******
MediaIdstring

输出成品的资源 id

0ce4ea70f52471edab61f7e7d6786302
MediaURLstring

输出成品的资源文件 URL

http://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video.mp4
TemplateIdstring

云剪辑模板 ID

cb786a39c5d44cecb23d8c864facffc1
ClipsParamstring

模板素材参数

{"Text1":"text","Text0":"text","Media1":"mediaId","Media0":"mediaId"}
Durationfloat

输出成品的时长,单位:秒。

15.5
CreateTimestring

任务创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ 。

2022-03-21T16:40:00Z
CompleteTimestring

剪辑合成作业完成时间,格式为 utc 时间。

2022-03-21T16:40:30Z
ModifiedTimestring

最后更新时间。

2022-03-21T16:41:00Z
Statusstring

剪辑合成作业状态

Sucess
Codestring

剪辑合成作业失败错误码

Success
Messagestring

剪辑合成作业错误信息注:作业失败时关注该字段

The resource operated InputFile is bad
UserDatastring

用户自定义设置

{"key":"value"}
MaxResultsstring

本次请求所返回的最大记录条数。

最大值:100,默认值:10

100
NextTokenstring

当前开始读取的位置

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-14OpenAPI 入参发生变更查看变更详情