根据IMS mediaId或媒资InputURL,更新一个媒资的媒资信息。
接口说明
MediaId不为空时,优先使用MediaId。如果MediaId为空,则InputURL必须非空。返回请求ID和媒资ID。不支持给定MediaId,修改InputURL。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 | 否 | 默认为false,取值:
| true |
CateId | long | 否 | 分类ID | 3048 |
ReferenceId | string | 否 | 自定义ID,仅支持小写字母、大写字母、数字、横线、下划线,长度6-64位。需保证用户维度唯一。 | 123-123 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"MediaId": "****20b48fb04483915d4f2cd8ac****"
}
错误码
访问错误中心查看更多错误码。