文档

UpdateMedia - 更新媒体基本信息

更新时间:

更新媒体基本信息。

接口说明

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

QPS 限制

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
MediaIdstring

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

3e1cd21131a94525be55acf65888****
Titlestring

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

  • 若不设置则清空此字段。
  • UTF8 编码,最大 128 字节。
hello
Descriptionstring

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

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

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

  • 不超过 3200 字节。
  • URL 遵循 RFC 2396(UTF-8 编码,并进行 URLEncode)。更多信息,请参见 URLEncode 说明
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
CateIdlong

类目 ID,整数。

  • 若不设置则清空此字段。
  • 不能为负数。
1
Tagsstring

标签列表。

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

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

6A88246F-C91F-42BD-BABE-DB0DF993F960
Mediaobject

媒体信息。

CreationTimestring

创建时间。

2016-09-14T08:30:33Z
CateIdlong

类目 ID。

1
Heightstring

媒体文件高。

1080
CensorStatestring

视频审核状态。取值:

  • Initiated:初始(上传成功审核未完成)。

  • Pass:通过(上传成功审核已通过)。

Initiated
Tagsarray

标签信息。

string

标签列表。

tag1,tag2
Bitratestring

码率。

2659.326
MediaIdstring

媒体 ID。

3e1cd21131a94525be55acf65888****
Fileobject

原文件。

Statestring

文件状态。取值范围:

  • Normal:正常。

  • Deleted:已删除。

Normal
URLstring

输入文件的 OSS Bucket。

http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4
PublishStatestring

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

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

媒体文件描述。

example description
Widthstring

媒体文件宽。

1920
Sizestring

媒体文件大小。

2647692
CoverURLstring

封面 URL。

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

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

string

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

{"RunId":["47b42486019c4f688bf144c1a6ba****"]}
Durationstring

时长。

7.965000
Fpsstring

帧率。

25.0
Titlestring

标题。

hello
Formatstring

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

mov

示例

正常返回示例

JSON格式

{
  "RequestId": "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media": {
    "CreationTime": "2016-09-14T08:30:33Z",
    "CateId": 1,
    "Height": "1080",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "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": [
        "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}"
      ]
    },
    "Duration": "7.965000",
    "Fps": "25.0",
    "Title": "hello",
    "Format": "mov"
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈