# 使用前必读 视频直播服务（Live）是在华为云提供的可信，开放，全球服务直播内容接入与分发网络的基础上，将华为公司在视频领域的多年技术积累和电信级运营和运维能力开放出来，构建了便捷接入、高清流畅、低延迟、高并发的一站式视频直播解决方案。 您可以使用本文档提供API对视频直播进行相关操作，如视频直播流的转码、管理、录制等。支持的全部操作请参见[API概览](https://support.huaweicloud.com/api-live/topic_live_04_overview_100015.html)。 在调用视频直播API之前，请确保已经充分了解视频直播相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-live/live030001.html)。 当前视频直播服务仅支持通过控制台配置直播播放的Refer防盗链、Key防盗链和IP黑白名单，对访问者的身份进行识别和过滤，符合规则的可以顺利播放直播资源，具体操作请参见[配置直播鉴权](https://support.huaweicloud.com/iLive-live/live_01_0047.html)。 视频直播服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[如何调用API](https://support.huaweicloud.com/api-live/live_03_0001.html)。 #### 终端节点 终端节点即调用API的**请求地址** ，不同服务不同区域的终端节点不同，Live的终端节点如[表1]所示。您也可以从[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/Live)中查询服务的终端节点。 表1Live的终端节点 | 区域名称 | 区域 | 终端节点（Endpoint） | |:---|:---|:---| | 华北-北京一 | cn-north-1 | live.cn-north-1.myhuaweicloud.com | | 华北-北京四 | cn-north-4 | live.cn-north-4.myhuaweicloud.com | | 亚太-新加坡 | ap-southeast-3 | live.ap-southeast-3.myhuaweicloud.com | #### 约束与限制 视频直播服务对服务端API设置了调用次数限制，避免出现短时间内重复调用API，服务中断的情况。 表2API流控限制 | 接口分类 | 接口名称 | 用户流量限制 | API流量限制 | |:---|:---|:---|:---| | 域名管理 | - 创建直播域名 - 查询直播域名 | 300次/分钟 | 3000次/分钟 | | 域名管理 | - 删除直播域名 - 修改直播域名 - 域名映射 - 删除直播域名映射关系 - 配置域名IPV6开关 - 修改域名HLS配置 - 查询域名HLS配置 | 100次/分钟 | 1000次/分钟 | | 域名管理 | - 修改播放域名延时配置 - 修改直播拉流回源配置 | 30次/分钟 | 100次/分钟 | | 域名管理 | - 查询播放域名延时配置 - 查询直播拉流回源配置 | 30次/分钟 | 300次/分钟 | | 域名管理 | 查询IP归属信息 | 5次/秒 | 5次/秒 | | 转码模板管理 | - 创建直播转码模板 - 删除直播转码模板 - 修改直播转码模板 - 查询直播转码模板 | 100次/分钟 | 1000次/分钟 | | 流管理 | - 禁止直播推流 - 修改禁推属性 | 4000次/分钟 | 12000次/分钟 | | 流管理 | - 查询禁止直播推流列表 - 禁推恢复 | 3000次/分钟 | 6000次/分钟 | | 流管理 | 禁推闪断 | 300次/分钟 | 3000次/分钟 | | 通知管理 | - 新增、修改直播推流通知配置 - 查询直播推流通知配置 - 删除直播推流通知配置 | 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次/分钟 | | 录制管理 | - 创建录制规则 - 查询录制规则列表 - 修改录制规则 - 删除录制规则 - 查询录制规则配置 - 提交录制控制命令 | 300次/分钟 | 3000次/分钟 | | 录制管理 | 创建录制视频索引文件 | 1200次/分钟 | 3000次/分钟 | | 录制回调管理 | - 创建录制回调配置 - 查询录制回调配置列表 - 修改录制回调配置 - 查询录制回调配置 - 删除录制回调配置 | 300次/分钟 | 300次/分钟 | | HTTPS证书管理 | 查询HTTPS证书信息 | 300次/分钟 | 3000次/分钟 | | HTTPS证书管理 | - 修改指定域名的HTTPS证书配置 - 查询指定域名的HTTPS证书配置 - 删除指定域名的HTTPS证书配置 | 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中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 - 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 - 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 - 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1项目隔离模型 ![](https://support.huaweicloud.com/api-live/zh-cn_image_0000002295445884.png)