调用SubmitTraceM3u8Job接口提交视频溯源水印m3u8作业-媒体处理-阿里云-媒体处理(MPS)-阿里云帮助中心

接口说明

使用本接口前需先调用提交视频溯源水印 ab 流，获取到 ab 流处理后的媒体 ID，再调用本接口进行处理。
目前数字水印相关接口只支持华东 2（上海）、华北 2（北京）地域使用。
该接口为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果将通过回调通知，也可通过查询视频溯源水印 m3u8 作业主动查询任务状态。
经过视频溯源水印 m3u8 作业处理生成的 m3u8 文件签名鉴权有效期为 24 小时（从处理完成开始计时），请尽快查询，签名鉴权过期后将无法查询到该次作业的水印信息。如签名鉴权过期后需要，请重新提交视频溯源水印 m3u8 作业。

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

操作

访问级别

资源类型

条件关键字

关联操作

mts:SubmitTraceM3u8Job

none

*全部资源

*

无

名称	类型	必填	描述	示例值
MediaId	string	是	ab 流处理后的媒体 ID。可以从提交视频溯源水印 ab 流接口的返回参数中获取。	437bd2b516ffda105d07b12a9a82****
Output	string	是	m3u8 文件输出 OSS 地址。说明 OSS 的地域需要与当前 MPS 所在地域保持一致。	{"Bucket":"exampleBucket","Location":"oss-cn-shanghai","Object":"out.m3u8"}
Trace	string	是	溯源水印信息。	今天星期一
KeyUri	string	否	密钥服务器 uri。	https://cipher.abc.com
Params	string	否	水印任务参数，JSONString。目前支持设置参数如下： m3u8Type：算法类型，默认值为 v1。 v1：生成绝对路径的 m3u8，可直接播放。签名鉴权有效期为 24 小时，过期后需重新提交任务获取 m3u8。 v2：生成相对路径的 m3u8，需要和 ts 文件放在相同路径下。	{"m3u8Type":"v1"}

正常返回示例

JSON格式

{
  "RequestId": "DEB915C5-D001-5C17-AF65-FF8A65DFE432",
  "Data": {
    "JobId": "bfb786c639894f4d80648792021e****"
  },
  "Message": "ok"
}

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

更多信息，参考变更详情。