检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除直播域名 功能介绍 删除域名。只有在域名停用(off)状态时才能删除。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
查询直播域名 功能介绍 查询直播域名 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数
约束与限制 视频直播服务对服务端API设置了调用次数限制,避免出现短时间内重复调用API,服务中断的情况。 表1 API流控限制 接口分类 接口名称 用户流量限制 API流量限制 域名管理 创建直播域名 查询直播域名 300次/分钟 3000次/分钟 删除直播域名 修改直播域名 域名映射
数据统计分析 查询播放带宽趋势接口 查询播放流量趋势接口 查询播放带宽峰值接口 查询播放流量汇总接口 查询观众趋势接口 查询直播拉流HTTP状态码接口 查询转码用量接口 查询录制用量接口 查询截图用量接口 查询上行带宽数据接口 查询域名维度推流路数接口 查询历史推流列表接口 查询播放画像信息接口
修改禁推属性 功能介绍 修改禁推属性 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 请求参数
修订记录 发布日期 修订记录 2021-07-30 第二次正式发布。 本次更新说明如下: 新增“PHP SDK使用指导”。 2020-10-30 第一次正式发布。
SDK概述 华为云提供了直播服务端SDK,您可以直接集成服务端SDK来调用直播的相关API,从而实现对直播服务的快速操作。目前视频直播提供了Java、Python、Go和PHP四种语言SDK供开发者使用,如表1所示。
hls_ts_count Integer 每个M3U8文件内ts切片个数 hls_min_frags Integer 每个M3U8文件内最小ts分片数 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String
示例3:禁止直播推流 场景描述 若您发现您直播业务中存在直播内容不合法或推流地址被非法盗用,您可以调用直播API对直播流进行禁止推流操作,从而保障直播资源的安全。 本章节指导用户如何使用API调用的方式禁推某个直播流。 前提条件 已明确需要被禁推的推流域名所在区域信息,并获取该区域的
size 否 Integer 每页记录数。 取值范围:1-100。 默认为10。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token,使用Token鉴权方式时必填。
查询录制规则配置 功能介绍 查询录制规则接口 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
查询推流帧率数据接口 功能介绍 查询推流帧率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的帧率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API
belongs Boolean 是否是华为云CDN节点。 true:是华为云CDN节点 false:不是华为云CDN节点 region String IP归属地省份。Unknown:表示未知归属地 isp String 运营商名称。如果IP归属地未知,该字段返回null。
查询推流码率数据接口 功能介绍 查询推流监控码率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的码率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API
示例2:创建录制配置 场景描述 若您需要在直播过程中,对直播流进行录制,并将录制文件存储至OBS服务中,您可以在直播开始前,调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息,并获取该区域的
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。
hls_ts_count 否 Integer 每个M3U8文件内ts切片个数 hls_min_frags 否 Integer 每个M3U8文件内最小ts分片数 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 push_domain String 推流域名
修改直播转码模板 功能介绍 修改直播转码模板 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
创建直播转码模板 功能介绍 创建直播转码模板。使用此功能将产生直播转码费用。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
删除直播转码模板 功能介绍 删除直播转码模板 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目