调用UpdateMediaPublishState更新媒体发布状态。

使用说明

本接口中所指发布的含义是媒体播放资源、截图文件的访问权限设置为继承所属Bucket的访问权限。不发布的含义是将媒体播放资源、截图文件的访问权限设置为私有。

QPS限制

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

调试

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

请求参数

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

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

MediaId String 3e6149d5a8c944c09b1a8d2dc3e4****

需更新发布状态的媒体ID。可以从新增媒体的返回参数中获取,也可以登录媒体处理控制台,通过媒体管理 > 媒体列表找到目标视频,单击管理,从目标视频的基础信息页签获取。

Publish Boolean true

发布状态。默认值:Initialed(初始)。可选范围:

  • true:发布。
  • false:不发布。
媒体发布默认状态与迁移规则

默认状态:

媒体发布状态的默认值是Initialed(初始)。有两种媒体类型处于这种状态:

  • 新的媒体:第一次生成一个媒体(第一次触发媒体工作流执行)时,工作流还处于执行中,这个时候媒体就处于“初始“状态。只要媒体工作流执行完成,就会变更为一个确切状态(根据媒体工作流的配置来设置)。
  • 删除后的媒体:媒体删除后,发布状态就没有意义了,这个时候也是处于“初始”状态。如果把删除的媒体重新添加回媒体库,就从“新的媒体”开始重新执行。

迁移规则:

说明 迁移指媒体发布状态在初始、发布、不发布三种状态之间的迁移。通过API调用和通过工作流执行调用的媒体迁移规则不同。

调用者

当前状态

迁移后状态

是否允许

API

初始

发布

不允许

API

初始

不发布

不允许

API

发布

不发布

允许

API

不发布

发布

允许

工作流执行

初始

发布

允许

工作流执行

初始

不发布

允许

工作流执行

发布

不发布

不允许

工作流执行

不发布

发布

不允许

返回数据

名称 类型 示例值 描述
RequestId String 91B6CAB9-034C-4E4E-A40B-E7F5C81E688C

请求ID。

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaPublishState
&MediaId=3e6149d5a8c944c09b1a8d2dc3e4****
&Publish=true
&<公共请求参数>

正常返回示例

XML格式

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

<UpdateMediaPublishStateResponse>
    <RequestId>91B6CAB9-034C-4E4E-A40B-E7F5C81E688C</RequestId>
</UpdateMediaPublishStateResponse>

JSON格式

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

{
  "RequestId" : "91B6CAB9-034C-4E4E-A40B-E7F5C81E688C"
}

错误码

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