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

更新时间:
复制为 MD 格式

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

调试

您可以在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>

剪辑任务列表

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

number

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

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=="
}

错误码

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

变更历史

更多信息,参考变更详情