检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
工具库 获取频道回看或时移地址 父主题: 控制台操作
域名管理 域名准入标准 添加域名 配置CNAME域名解析 管理域名 配置IPv6 配置区域访问控制白名单 推流鉴权 播放鉴权 HTTPS证书配置 父主题: 控制台操作
云资源授权 如果频道需要开启DRM加密,且“对接模式”设置为“FunctionGraph代理访问”,需参考本节操作,开启FunctionGraph资源委托授权。 前提条件 默认不展示菜单“云资源授权”,需提交工单申请使用权限。 申请通过后,控制台自动展示“云资源授权”菜单和“开启DRM加密”配置参数。
流管理 禁止直播推流 查询禁止直播推流列表 禁推恢复 修改禁推属性 查询直播中的流信息
概述 媒体直播为广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 您可以使用本文档提供API对媒体直播进行相关操作,如媒体直播转码模板管理、创建频道等。支持的全部操作请参见API概览。 在调用媒体直播API之前,请确保已经充分了解媒体直播相关概念,详细信息请参见《媒体直播用户指南》。
操作前提 前提条件 已注册华为账号并开通华为云,完成实名认证。 具备用于媒体直播的域名,且域名已完成备案。PUSH类型的频道需要一个推流域名和一个播放域名,且两个域名不能相同。PULL类型的频道,不需要推流域名。 若您需要购买自有域名,您可以在华为云的域名注册中购买。您也可以在其它域名服务商处购买。
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
IAM权限管理 创建用户并授权使用Live 父主题: 控制台操作
调用说明 媒体直播服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取项目ID 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。
新建OTT频道 功能介绍 创建频道接口,支持创建OTT频道。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/{project_id}/ott/channels
约束与限制 媒体直播服务对服务端API设置了调用次数限制,避免出现短时间内重复调用API,服务中断的情况。 表1 API流控限制 接口分类 接口名称 用户流量限制 API流量限制 OTT频道管理 新建OTT频道 查询频道信息 删除频道信息 修改频道打包信息 修改频道入流信息 修改频道录制信息
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求。
创建频道 媒体直播需要创建频道后,才能播放频道内容。 前提条件 已添加推流域名。 已创建直播转码模板。 开启DRM加密参数默认不展示,需提交工单开通参数配置权限。 申请通过后,控制台自动展示“云资源授权”菜单和“开启DRM加密”配置参数。 如果频道开启DRM加密,且选择“Func
管理域名 推流域名或播放域名添加后,您可以在域名管理页面,查看已添加域名的基本信息。您也可以根据实际需求停用、启动或删除已添加的域名。 操作步骤 登录视频直播控制台。 在左侧导航栏中,选择“域名管理”,进入域名管理页面。 请根据实际需求选择以下操作。 查看域名信息 在域名列表中,
Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证,与401类似,但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户
查询频道信息 功能介绍 查询频道信息,支持批量查询。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/{project_id}/ott/channels
删除频道信息 功能介绍 删除频道信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v1/{project_id}/ott/channels 表1