使用前必读
视频直播服务（Live）是在华为云提供的可信，开放，全球服务直播内容接入与分发网络的基础上，将华为公司在视频领域的多年技术积累和电信级运营和运维能力开放出来，构建了便捷接入、高清流畅、低延迟、高并发的一站式视频直播解决方案。
您可以使用本文档提供API对视频直播进行相关操作，如视频直播流的转码、管理、录制等。支持的全部操作请参见API概览。
在调用视频直播API之前，请确保已经充分了解视频直播相关概念，详细信息请参见产品介绍。
当前视频直播服务仅支持通过控制台配置直播播放的Refer防盗链、Key防盗链和IP黑白名单，对访问者的身份进行识别和过滤，符合规则的可以顺利播放直播资源，具体操作请参见配置直播鉴权。
视频直播服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。
约束与限制
接口分类 | 接口名称 | 用户流量限制 | API流量限制 |
|---|---|---|---|
域名管理 |
| 300次/分钟 | 3000次/分钟 |
| 100次/分钟 | 1000次/分钟 | |
| 30次/分钟 | 100次/分钟 | |
| 30次/分钟 | 300次/分钟 | |
域名管理 | 查询IP归属信息 | 5次/秒 | 5次/秒 |
转码模板管理 |
| 100次/分钟 | 1000次/分钟 |
流管理 |
| 4000次/分钟 | 12000次/分钟 |
| 3000次/分钟 | 6000次/分钟 | |
禁推闪断 | 300次/分钟 | 3000次/分钟 | |
通知管理 |
| 300次/分钟 | 3000次/分钟 |
鉴权管理 |
| 300次/分钟 | 3000次/分钟 |
查询播放域名的地域限制列表 | 30次/分钟 | 300次/分钟 | |
修改播放域名的地域限制配置 | 30次/分钟 | 100次/分钟 | |
| 150次/分钟 | 300次/分钟 | |
截图管理 |
| 150次/分钟 | 300次/分钟 |
拉流管理 |
| 300次/分钟 | 3000次/分钟 |
日志管理 | 获取直播播放日志 | 300次/分钟 | 3000次/分钟 |
录制管理 |
| 300次/分钟 | 3000次/分钟 |
创建录制视频索引文件 | 1200次/分钟 | 3000次/分钟 | |
录制回调管理 |
| 300次/分钟 | 300次/分钟 |
HTTPS证书管理 | 查询HTTPS证书信息 | 300次/分钟 | 3000次/分钟 |
| 150次/分钟 | 300次/分钟 | |
OBS桶管理 | OBS桶授权及取消授权 | 150次/分钟 | 300次/分钟 |
直播水印管理 | 创建水印模板 修改水印模板 删除水印模板 创建水印规则 修改水印规则 删除水印规则 查询水印规则配置 | 50次/分钟 | 200次/分钟 |
查询水印模板列表 查询水印模板配置 查询水印规则列表 | 300次/分钟 | 3000次/分钟 | |
数据统计分析 | 查询播放带宽趋势接口 | 100次/秒 | 600次/秒 |
查询播放流量趋势接口 | 20次/秒 | 200次/秒 | |
查询观众趋势接口 | 20次/秒 | 200次/秒 | |
数据统计分析 | 查询播放带宽峰值接口 | 20次/秒 | 200次/秒 |
查询播放流量汇总接口 | 20次/秒 | 300次/秒 | |
查询直播拉流HTTP状态码接口 | 30次/秒 | 300次/秒 | |
查询转码用量接口 | 20次/秒 | 200次/秒 | |
查询上行带宽数据接口 | 20次/秒 | 300次/秒 | |
查询域名维度推流路数接口 | 20次/秒 | 300次/秒 | |
查询历史推流列表接口 | 30次/秒 | 300次/秒 | |
查询播放画像信息接口 | 10次/秒 | 100次/秒 | |
查询直播各区域指标分布接口 | 50次/秒 | 150次/秒 | |
数据统计分析 | 查询录制用量接口 | 20次/秒 | 200次/秒 |
查询截图用量接口 | 20次/秒 | 200次/秒 | |
查询播放域名下的流数据 | 20次/秒 | 50次/秒 | |
查询推流域名转码路数 | 10次/秒 | 50次/秒 | |
查询转码明细 | 3次/秒 | 30次/秒 | |
流监控 | 查询推流帧率数据接口 | 10次/秒 | 200次/秒 |
查询推流码率数据接口 | 10次/秒 | 200次/秒 | |
查询推流监控数据接口 | 10次/秒 | 200次/秒 | |
查询CDN上行推流质量数据接口 | 30次/秒 | 300次/秒 | |
查询直播中的流信息 | 20次/秒 | 60次/秒 |
基本概念
- 账号
用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。
- 用户
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。
在“我的凭证”下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
- 区域
指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。
- 可用区
一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
- 项目
区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。
图1 项目隔离模型
