根据IMS 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,若为空,则必须有已在IMS内容库中注册过的InputURL。

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

待注册的媒资在相应系统中的地址,一经注册不可更改,并与IMS的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 1

用户自定义元数据

UserData String userData

用户数据,最大1024字节。

AppendTags Boolean true

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

AppendDynamicMeta Boolean true

是否以append的形式更新DynamicMetaDataList字段

返回数据

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

请求ID。

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

IMS媒资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****"
}

错误码

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