检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
调用说明 媒体直播服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取项目ID 调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”,其中{Endpoint}为IAM的终端节点可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
查询观众趋势接口 功能介绍 查询观众趋势。 最大查询跨度31天,最大查询周期一年。 该接口仅支持查询FLV和RTMP流的在线人数。 查询数据会延迟10分钟左右。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。
查询转码用量接口 功能介绍 查询直播域名每小时的转码时长数据。 最大查询跨度31天,最大查询周期1年。 转码用量的数据是延时1小时。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
删除直播域名 功能介绍 删除域名。只有在域名停用(off)状态时才能删除。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
查询直播域名 功能介绍 查询直播域名 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数
数据统计分析 查询播放带宽趋势接口 500次/分钟 5000次/分钟 数据统计分析 查询转码用量接口 查询录制用量接口 查询截图用量接口 查询播放画像信息接口 60次/分钟 5000次/分钟 查询播放流量趋势接口 查询播放带宽峰值接口 查询播放流量汇总接口 查询观众趋势接口 查询直播拉流HTTP状态码接口
查询播放带宽趋势接口 查询播放流量趋势接口 查询播放带宽峰值接口 查询播放流量汇总接口 查询观众趋势接口 查询直播拉流HTTP状态码接口 查询转码用量接口 查询录制用量接口 查询截图用量接口 查询上行带宽数据接口 查询域名维度推流路数接口 查询历史推流列表接口 查询播放画像信息接口 查询直播各区域指标分布接口
修改禁推属性 功能介绍 修改禁推属性 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 请求参数
数据统计分析 查询播放带宽趋势接口 500次/分钟 5000次/分钟 数据统计分析 查询转码用量接口 查询录制用量接口 查询截图用量接口 查询播放画像信息接口 60次/分钟 5000次/分钟 查询播放流量趋势接口 查询播放带宽峰值接口 查询播放流量汇总接口 查询观众趋势接口 查询直播拉流HTTP状态码接口
新建OTT频道 功能介绍 创建频道接口,支持创建OTT频道。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/{project_id}/ott/channels
约束与限制 媒体直播服务对服务端API设置了调用次数限制,避免出现短时间内重复调用API,服务中断的情况。 表1 API流控限制 接口分类 接口名称 用户流量限制 API流量限制 OTT频道管理 新建OTT频道 查询频道信息 删除频道信息 修改频道打包信息 修改频道入流信息 修改频道录制信息
直播流结束推流的时间, 格式:YYYY-MM-DD hh:mm:ss,如2020-11-06 14:39:44。 类型 直播流的推送类型,包含主播推流和第三方CDN回源两种类型。 主播IP 推流端的IP地址。 音频编码 音频编码格式。 视频编码 视频编码格式。 推拉流记录 选择需要查看的时间、域
查询推流码率数据接口 功能介绍 查询推流监控码率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的码率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
场景描述 若您需要在直播过程中,对直播流进行录制,并将录制文件存储至OBS服务中,您可以在直播开始前,调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息,并获取该区域的Endpoint,您可以从地区和终端节点获取。
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。 详细信息请参见
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型