调用UpdateMedia更新媒体基本信息。

使用说明

本接口更新的媒体基本信息包括标题、描述、类目等。注意是全量更新,每个属性都要设置,未设置的会被空值覆盖。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

操作接口名,系统规定参数。取值:UpdateMedia

MediaId String 3e1cd21131a94525be55acf65888****

需要更新基本信息的媒体ID。可以通过MPS控制台 > 媒体管理 > 媒体列表获取。

Title String hello

媒体标题。支持中英文、数字等。

  • 若不设置则清空此字段。
  • UTF8编码,最大128字节。
Description String example description

媒体描述。支持中英文、数字等。

  • 若不设置则清空此字段。
  • UTF8编码,最大1024字节。
CoverURL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg

封面URL。即您需要设置的封面的存储地址,可以通过MPS控制台 > 工作流管理 > 媒体BucketOSS控制台 > 我的访问路径获取。

  • 不超过3200字节。
  • URL遵循RFC 2396(UTF-8编码,并进行URLEncode)。
CateId Long 1

类目ID,整数。

  • 若不设置则清空此字段。
  • 不能为负数。
Tags String tag1,tag2

标签列表。

  • 用半角逗号(,)分隔,不超过16个标签。
  • 单个标签不超过32字节。
  • UTF8编码。

返回数据

名称 类型 示例值 描述
RequestId String 6A88246F-C91F-42BD-BABE-DB0DF993F960

请求ID。

Media Object

媒体信息。

CreationTime String 2016-09-14T08:30:33Z

创建时间。

CateId Long 1

类目ID。

Height String 1080

媒体文件高。

CensorState String Initiated

视频审核状态。取值:

  • Initiated:初始(上传成功审核未完成)。
  • Pass:通过(上传成功审核已通过)。
Tags Array of String tag1,tag2

标签列表。

Bitrate String 2659.326

码率。

MediaId String 3e1cd21131a94525be55acf65888****

媒体ID。

File Object

原文件。

State String Normal

文件状态。取值范围:

  • Normal:正常。
  • Deleted:已删除。
URL String http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

输入文件的OSS Bucket。

PublishState String Published

媒体发布状态,表示是否对外发布媒体。取值:

  • Initiated:初始。
  • UnPublish:未发布,OSS播放文件权限为Private。
  • Published:已发布,OSS播放文件权限为Default。
  • Deleted:已删除。
Description String example description

媒体文件描述。

Width String 1920

媒体文件宽。

Size String 2647692

媒体文件大小。

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

封面URL。

RunIdList Array of String {"RunId":["47b42486019c4f688bf144c1a6ba****"]}

媒体工作流执行实例ID列表。

Duration String 7.965000

时长。

Fps String 25.0

帧率。

Title String hello

标题。

Format String mov

格式。支持mov,mp4,m4a,3gp,3g2,mj2。

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMedia
&MediaId=3e1cd21131a94525be55acf65888****
&Title=hello
&Description=example description
&CoverURL=http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
&CateId=1
&Tags=tag1,tag2
&<公共请求参数>

正常返回示例

XML格式

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

<UpdateMediaResponse>
    <RequestId>6A88246F-C91F-42BD-BABE-DB0DF993F960</RequestId>
    <Media>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <CateId>1</CateId>
        <Height>1080</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <Bitrate>2659.326</Bitrate>
        <MediaId>3e1cd21131a94525be55acf65888****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <PublishState>Published</PublishState>
        <Description>example description</Description>
        <Width>1920</Width>
        <Size>2647692</Size>
        <CoverURL>http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg</CoverURL>
        <RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba****"]}</RunIdList>
        <Duration>7.965000</Duration>
        <Fps>25.0</Fps>
        <Title>hello</Title>
        <Format>mov</Format>
    </Media>
</UpdateMediaResponse>

JSON格式

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

{
  "RequestId" : "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media" : {
    "CreationTime" : "2016-09-14T08:30:33Z",
    "CateId" : 1,
    "Height" : "1080",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "Bitrate" : "2659.326",
    "MediaId" : "3e1cd21131a94525be55acf65888****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "PublishState" : "Published",
    "Description" : "example description",
    "Width" : "1920",
    "Size" : "2647692",
    "CoverURL" : "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
    "RunIdList" : [ "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}" ],
    "Duration" : "7.965000",
    "Fps" : "25.0",
    "Title" : "hello",
    "Format" : "mov"
  }
}

错误码

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