调用UpdateMediaPublishState更新媒体发布状态。
使用说明
本接口中所指发布的含义是媒体播放资源、截图文件的访问权限设置为继承所属Bucket的访问权限。不发布的含义是将媒体播放资源、截图文件的访问权限设置为私有。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateMediaPublishState |
操作接口名,系统规定参数。取值:UpdateMediaPublishState。 |
MediaId | String | 是 | 3e6149d5a8c944c09b1a8d2dc3e4**** |
需更新发布状态的媒体ID。可以从新增媒体的返回参数中获取,也可以登录媒体处理控制台,通过媒体管理 > 媒体列表找到目标视频,单击管理,从目标视频的基础信息页签获取。 |
Publish | Boolean | 否 | true |
发布状态。默认值:Initialed(初始)。可选范围:
|
默认状态:
媒体发布状态的默认值是Initialed(初始)。有两种媒体类型处于这种状态:
- 新的媒体:第一次生成一个媒体(第一次触发媒体工作流执行)时,工作流还处于执行中,这个时候媒体就处于“初始“状态。只要媒体工作流执行完成,就会变更为一个确切状态(根据媒体工作流的配置来设置)。
- 删除后的媒体:媒体删除后,发布状态就没有意义了,这个时候也是处于“初始”状态。如果把删除的媒体重新添加回媒体库,就从“新的媒体”开始重新执行。
迁移规则:
调用者 |
当前状态 |
迁移后状态 |
是否允许 |
---|---|---|---|
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"
}
错误码
访问错误中心查看更多错误码。