检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 媒体直播为广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 您可以使用本文档提供API对媒体直播进行相关操作,如媒体直播转码模板管理、创建频道等。支持的全部操作请参见API概览。 在调用媒体直播API之前,请确保已经充分了解媒体直播相关概念,详细信息请参见
OTT频道管理 新建OTT频道 查询频道信息 删除频道信息 修改频道打包信息 修改频道入流信息 修改频道录制信息 修改频道通用信息 修改频道状态 修改频道转码模板信息
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数,或者参数值格式不正确
状态码 调用视频直播API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数,或者参数值格式不正确
域名映射 功能介绍 将用户已创建的播放域名和推流域名建立域名映射关系 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domains_mapping 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID
转码模板管理 创建直播转码模板 删除直播转码模板 修改直播转码模板 查询直播转码模板
地区名称缩写 表1 地区名称缩写 地区 英文缩写 其他 OT 北京 BJ 天津 TJ 重庆 CQ 上海 SH 广东 GD 海南 HI 广西 GX 云南 YN 山西 SX 河北 HE 内蒙古 NM 宁夏 NX 辽宁 LN 吉林 JL 黑龙江 HL 江苏 JS 浙江 ZJ 江西 JX
国家名称缩写 表1 国家名称缩写 国家 英文缩写 阿富汗 AF 奥兰群岛 AX 阿尔巴尼亚 AL 阿尔及利亚 DZ 美属萨摩亚 AS 安道尔 AD 安哥拉 AO 安圭拉 AI 安提瓜和巴布达 AG 阿根廷 AR 亚美尼亚 AM 阿鲁巴 AW 澳大利亚 AU 奥地利 AT 阿塞拜疆
HTTPS证书管理 修改指定域名的https证书配置 查询指定域名的https证书配置 删除指定域名的https证书配置
创建录制规则 功能介绍 创建录制规则接口,录制规则对新推送的流生效,对已经推送中的流不生效。使用此功能将产生直播录制费用。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/rules 表1 路径参数 参数 是否必选 参数类型 描述
删除录制规则 功能介绍 删除录制规则接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
修改录制规则 功能介绍 修改录制规则接口,如果规则修改后,修改后的规则对正在录制的流无效,对新的流有效。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
禁止直播推流 功能介绍 禁止直播推流 用户请求响应成功后,无返回参数,返回状态码204。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
新建OTT频道 功能介绍 创建频道接口,支持创建OTT频道。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/{project_id}/ott/channels
生成URL鉴权串 功能介绍 生成URL鉴权串 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/auth/chain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
获取项目ID 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 图1 管理控制台
数据统计分析 查询播放带宽趋势接口 查询播放流量趋势接口 查询播放带宽峰值接口 查询播放流量汇总接口 查询观众趋势接口 查询直播拉流HTTP状态码接口 查询转码用量接口 查询录制用量接口 查询截图用量接口 查询上行带宽数据接口 查询域名维度推流路数接口 查询历史推流列表接口 查询播放画像信息接口