根据IMS mediaId或媒资InputURL,更新一个媒资的媒资信息。
接口说明
MediaId不为空时,优先使用MediaId。如果MediaId为空,则InputURL必须非空。默认模式为overwrite(字段不为空时覆盖),如果需要在原有信息基础上append,需要将对应的append字段设为true。返回请求ID和媒资ID。不支持给定MediaId,修改InputURL。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
MediaId | string | 否 |
媒资Id,若为空,则必须有已在IMS内容库中注册过的InputURL。 |
****20b48fb04483915d4f2cd8ac**** |
InputURL | string | 否 |
待注册的媒资在相应系统中的地址,一经注册不可更改,并与IMS的mediaId绑定。 - OSS地址,支持两种格式 1.http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 2.oss://example-bucket/example.mp4 此格式默认oss region与服务接入区域一致 |
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 |
BusinessType | string | 否 |
媒资业务类型。取值范围:
|
video |
Title | string | 否 |
标题。
|
defaultTitle |
Description | string | 否 |
内容描述。
|
defaultDescription |
Category | string | 否 |
分类。
|
defaultCategory |
MediaTags | string | 否 |
标签。
|
updateTags1,updateTags2 |
CoverURL | string | 否 |
封面地址。
|
http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png |
UserData | string | 否 |
用户数据,最大1024字节。 |
userData |
AppendTags | boolean | 否 |
是否以append的形式更新Tags字段,默认为overwrite。 |
true |
CateId | long | 否 |
分类ID |
3048 |
ReferenceId | string | 否 |
自定义ID,仅支持小写字母、大写字母、数字、横线、下划线,长度6-64位。需保证用户维度唯一。 |
123-123 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"MediaId": "****20b48fb04483915d4f2cd8ac****"
}
错误码
访问错误中心查看更多错误码。