根据ICE mediaId或媒资InputURL,更新一个媒资的媒资信息。MediaId不为空时,优先使用MediaId。如果MediaId为空,则InputURL必须非空。默认模式为overwrite (字段不为空时覆盖),如果需要在原有信息基础上append,需要将对应的append字段设为true。返回请求ID和媒资ID。不支持给定MediaId, 修改InputURL。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateMediaInfo

系统规定参数。取值:UpdateMediaInfo

MediaId String ****20b48fb04483915d4f2cd8ac****

媒资Id,若为空,则必须有已在ICE内容库中注册过的InputURL。

InputURL String http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

待注册的媒资在相应系统中的地址,一经注册不可更改,并与ICE的mediaId绑定

- OSS地址,支持两种格式

1.http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

2.oss://example-bucket/example.mp4 此格式默认oss region与服务接入区域一致

BusinessType String video

媒资业务类型。取值范围:

- "subtitles" 字幕

- "watermark" 水印

- "opening" 片头/开场

- "ending" 片尾

- "general" 通用

Title String defaultTitle

标题

- 长度不超过128字节。

- UTF8编码。

Description String defaultDescription

内容描述

- 长度不超过1024字节

- UTF8编码。

Category String defaultCategory

分类

- 长度不超过64字节。

- UTF8编码。

MediaTags String updateTags1,updateTags2

标签。

- 最多不超过16个标签。

- 多个用逗号分隔。

- 单个标签不超过32字节。

- UTF8编码。

CoverURL String http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png

封面地址。

- 长度不超过128字节。

- UTF8编码。

DynamicMetaDataList String [{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":10.0,"out":20.3,"type":"user-defined"},{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":20.0,"out":29.9,"type":"user-defined"}]

用户自定义元数据。

- 长度不超过2048字节。

- UTF8编码。

- DynamicMetaData -> Json String

UserData String userData

用户数据,最大1024字节。

AppendTags Boolean true

是否以append的形式更新Tags字段,默认为overwrite。

AppendDynamicMeta Boolean true

是否以append的形式更新DynamicMetaDataList字段,默认为overwrite。

返回数据

名称 类型 示例值 描述
RequestId String ******11-DB8D-4A9A-875B-275798******

请求ID

MediaId String ****20b48fb04483915d4f2cd8ac****

ICE媒资ID

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateMediaInfo
&MediaId=****20b48fb04483915d4f2cd8ac****
&InputURL=http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
&BusinessType=video
&Title=defaultTitle
&Description=defaultDescription
&Category=defaultCategory
&MediaTags=updateTags1,updateTags2
&CoverURL=http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
&DynamicMetaDataList=[{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":10.0,"out":20.3,"type":"user-defined"},{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":20.0,"out":29.9,"type":"user-defined"}]
&UserData=userData
&AppendTags=true
&AppendDynamicMeta=true
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateMediaInfoResponse>
    <RequestId>2FDE2411-DB8D-4A9A-875B-275798F14A5E</RequestId>
    <MediaId>****20b48fb04483915d4f2cd8ac****</MediaId>
</UpdateMediaInfoResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2FDE2411-DB8D-4A9A-875B-275798F14A5E",
  "MediaId" : "****20b48fb04483915d4f2cd8ac****"
}

错误码

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

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