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

使用前必读

媒体直播为广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。

您可以使用本文档提供API对媒体直播进行相关操作,如媒体直播转码模板管理、创建频道等。支持的全部操作请参见API概览

在调用媒体直播API之前,请确保已经充分了解媒体直播相关概念,详细信息请参见《媒体直播用户指南》。

媒体直播服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API

终端节点

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

表1 终端节点

区域名称

区域

终端节点(Endpoint)

亚太-香港

ap-southeast-1

live.ap-southeast-1.myhuaweicloud.com

亚太-新加坡

ap-southeast-3

live.ap-southeast-3.myhuaweicloud.com

约束与限制

媒体直播服务对服务端API设置了调用次数限制,避免出现短时间内重复调用API,服务中断的情况。
表2 API流控限制

接口分类

接口名称

用户流量限制

API流量限制

OTT频道管理

  • 新建OTT频道
  • 查询频道信息
  • 删除频道信息
  • 修改频道打包信息
  • 修改频道入流信息
  • 修改频道录制信息
  • 修改频道通用信息
  • 修改频道状态
  • 修改频道转码模板信息

80次/分钟

80次/分钟

基本概念

  • 账号

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

  • 用户

    由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。

    在“我的凭证”下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。

  • 区域

    指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。

  • 可用区

    一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。

  • 项目

    区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中购买资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。

    图1 项目隔离模型