调用UpdateMediaInfo API使用MediaId或InputURL更新媒资信息-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

根据IMS mediaId或媒资InputURL，更新一个媒资的媒资信息。

接口说明

MediaId 不为空时，优先使用 MediaId。如果 MediaId 为空，则 InputURL 必须非空。返回请求 ID 和媒资 ID。不支持给定 MediaId，修改 InputURL。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:UpdateMediaInfo

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
MediaId	string	否	媒资 Id，若为空，则必须有已在 IMS 内容库中注册过的 InputURL。	**20b48fb04483915d4f2cd8ac**
InputURL	string	否	待注册的媒资在相应系统中的地址，一经注册不可更改，并与 IMS 的 mediaId 绑定。 OSS 地址，支持两种格式： http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 oss://example-bucket/example.mp4 此格式默认 oss region 与服务接入区域一致	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
BusinessType	string	否	媒资业务类型。取值范围： "subtitles" 字幕 "watermark" 水印 "opening" 片头/开场 "ending" 片尾 "general" 通用	video
Title	string	否	标题。长度不超过 128 字节。 UTF8 编码。	defaultTitle
Description	string	否	内容描述。长度不超过 1024 字节。 UTF8 编码。	defaultDescription
Category	string	否	分类。长度不超过 64 字节。 UTF8 编码。	defaultCategory
MediaTags	string	否	标签。最多不超过 16 个标签。多个用逗号分隔。单个标签不超过 32 字节。 UTF8 编码。	updateTags1,updateTags2
CoverURL	string	否	封面地址。长度不超过 128 字节。 UTF8 编码。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
UserData	string	否	用户数据，最大 1024 字节。	userData
AppendTags	boolean	否	默认为 false，取值： appendTags = true，以追加的模式更新 MediaTags 字段。 appendTags = false，以覆盖的模式更新 MediaTags 字段。	true
CateId	integer	否	分类 ID	3048
ReferenceId	string	否	自定义 ID，仅支持小写字母、大写字母、数字、横线、下划线，长度 6-64 位。需保证用户维度唯一。	123-123

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
MediaId	string	IMS 媒资 ID。	**20b48fb04483915d4f2cd8ac**

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

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