使用前必读

更新时间：2024-12-10 GMT+08:00

查看PDF

视频直播服务（Live）是在华为云提供的可信，开放，全球服务直播内容接入与分发网络的基础上，将华为公司在视频领域的多年技术积累和电信级运营和运维能力开放出来，构建了便捷接入、高清流畅、低延迟、高并发的一站式视频直播解决方案。

您可以使用本文档提供API对视频直播进行相关操作，如视频直播流的转码、管理、录制等。支持的全部操作请参见API概览。

在调用视频直播API之前，请确保已经充分了解视频直播相关概念，详细信息请参见产品介绍。

当前视频直播服务仅支持通过控制台配置直播播放的Refer防盗链和IP黑名单，对访问者的身份进行识别和过滤，符合规则的可以顺利播放直播资源，具体操作请参见配置直播鉴权。

视频直播服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。

终端节点

终端节点即调用API的请求地址，不同区域的终端节点不同，Live的终端节点如表1所示。您也可以从地区和终端节点中查询服务的终端节点。

表1 Live的终端节点
区域名称	区域	终端节点（Endpoint）
华北-北京四	cn-north-4	live.cn-north-4.myhuaweicloud.com
亚太-新加坡	ap-southeast-3	live.ap-southeast-3.myhuaweicloud.com
亚太-曼谷	ap-southeast-2	live.ap-southeast-2.myhuaweicloud.com

约束与限制

视频直播服务对服务端API设置了调用次数限制，避免出现短时间内重复调用API，服务中断的情况。

表2 API流控限制
接口分类	接口名称	用户流量限制	API流量限制
域名管理	创建直播域名查询直播域名	300次/分钟	3000次/分钟
	删除直播域名修改直播域名域名映射删除直播域名映射关系配置域名IPV6开关修改域名HLS配置查询域名HLS配置	100次/分钟	1000次/分钟
	查询IP归属信息	5次/秒	5次/秒
	修改播放域名延时配置修改直播拉流回源配置	30次/分钟	100次/分钟
	查询播放域名延时配置查询直播拉流回源配置	30次/分钟	300次/分钟
转码模板管理	创建直播转码模板删除直播转码模板修改直播转码模板查询直播转码模板	100次/分钟	1000次/分钟
流管理	禁止直播推流修改禁推属性	4000次/分钟	12000次/分钟
	查询禁止直播推流列表禁推恢复	3000次/分钟	6000次/分钟
	查询直播中的流信息	1000次/分钟	2000次/分钟
通知管理	新增、修改直播推流通知配置查询直播推流通知配置删除直播推流通知配置	300次/分钟	3000次/分钟
鉴权管理	设置Referer防盗链黑白名单删除Referer防盗链黑白名单查询Referer防盗链黑白名单查询IP黑/白名单修改IP黑/白名单生成URL鉴权串	300次/分钟	3000次/分钟
	查询播放域名的地域限制列表	30次/分钟	300次/分钟
	修改播放域名的地域限制配置	30次/分钟	100次/分钟
	查询指定域名的Key防盗链配置更新指定域名的Key防盗链配置删除指定域名的Key防盗链配置	150次/分钟	300次/分钟
截图管理	创建直播截图配置修改直播截图配置查询直播截图配置删除直播截图配置	150次/分钟	300次/分钟
日志管理	获取直播播放日志	300次/分钟	3000次/分钟
录制管理	创建录制规则查询录制规则列表修改录制规则删除录制规则查询录制规则配置提交录制控制命令	300次/分钟	3000次/分钟
录制管理	创建录制视频索引文件	1200次/分钟	3000次/分钟
录制回调管理	创建录制回调配置查询录制回调配置列表修改录制回调配置查询录制回调配置删除录制回调配置	300次/分钟	300次/分钟
HTTPS证书管理	修改指定域名的HTTPS证书配置查询指定域名的HTTPS证书配置删除指定域名的HTTPS证书配置	150次/分钟	300次/分钟
OBS桶管理	OBS桶授权及取消授权	150次/分钟	300次/分钟
数据统计分析	查询播放带宽峰值接口	20次/秒	200次/秒
	查询播放流量汇总接口	20次/秒	300次/秒
	查询直播拉流HTTP状态码接口	30次/秒	300次/秒
	查询转码用量接口	20次/秒	200次/秒
	查询录制用量接口	20次/秒	200次/秒
	查询截图用量接口	20次/秒	200次/秒
	查询上行带宽数据接口	20次/秒	300次/秒
	查询域名维度推流路数接口	20次/秒	300次/秒
	查询历史推流列表接口	30次/秒	300次/秒
	查询播放画像信息接口	10次/秒	100次/秒
	查询直播各区域指标分布接口	50次/秒	150次/秒
数据统计分析	查询播放域名下的流数据	20次/秒	50次/秒
流监控	查询推流帧率数据接口	10次/秒	200次/秒
	查询推流码率数据接口	10次/秒	200次/秒
	查询推流监控数据接口	10次/秒	200次/秒
	查询CDN上行推流质量数据接口	30次/秒	300次/秒

基本概念

账号
 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。
用户
 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。

在“我的凭证”下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
区域
 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。
可用区
 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
项目
 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。

图1 项目隔离模型

下一篇：API概览

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消