检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
国家名称缩写 表1 国家名称缩写 国家 英文缩写 阿富汗 AF 奥兰群岛 AX 阿尔巴尼亚 AL 阿尔及利亚 DZ 美属萨摩亚 AS 安道尔 AD 安哥拉 AO 安圭拉 AI 安提瓜和巴布达 AG 阿根廷 AR 亚美尼亚 AM 阿鲁巴 AW 澳大利亚 AU 奥地利 AT 阿塞拜疆
捷接入、高清流畅、低延迟、高并发的一站式视频直播解决方案。 您可以使用本文档提供API对视频直播进行相关操作,如视频直播流的转码、管理、录制等。支持的全部操作请参见API概览。 在调用视频直播API之前,请确保已经充分了解视频直播相关概念,详细信息请参见产品介绍。 当前视频直播服
调用说明 媒体直播服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
修改直播截图配置 功能介绍 修改直播截图配置接口 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/stream/snapshot 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
域名映射 功能介绍 将用户已创建的播放域名和推流域名建立域名映射关系 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domains_mapping 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
修改频道转码模板信息 功能介绍 修改频道转码模板信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v1/{project_id}/ott/channe
禁止直播推流 功能介绍 禁止直播推流 用户请求响应成功后,无返回参数,返回状态码204。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
删除直播截图配置 功能介绍 删除直播截图配置接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/snapshot 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
maintenance state. 本版本内不支持此接口或该接口处于维护状态 请稍后重试或者联系客服人员帮忙解决 400 LIVE.100011008 The API is in the maintenance state. 当前接口处于停服维护状态 请稍后重试,或提交工单,申请技术客服协助解决问题
maintenance state. 本版本内不支持此接口或该接口处于维护状态 请稍后重试或者联系客服人员帮忙解决 400 LIVE.100011008 The API is in the maintenance state. 当前接口处于停服维护状态 请稍后重试,或提交工单,申请技术客服协助解决问题
流管理 禁止直播推流 查询禁止直播推流列表 禁推恢复 修改禁推属性 查询直播中的流信息
日志管理 获取直播播放日志
获取直播播放日志 功能介绍 获取直播播放日志,基于域名以5分钟粒度进行打包,日志内容以 "|" 进行分隔。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
场景描述 若您需要在直播过程中,对直播流进行录制,并将录制文件存储至OBS服务中,您可以在直播开始前,调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息,并获取该区域的Endpoint,您可以从地区和终端节点获取。
示例3:禁止直播推流 场景描述 若您发现您直播业务中存在直播内容不合法或推流地址被非法盗用,您可以调用直播API对直播流进行禁止推流操作,从而保障直播资源的安全。 本章节指导用户如何使用API调用的方式禁推某个直播流。 前提条件 已明确需要被禁推的推流域名所在区域信息,并获取该区域的End
查询录制回调配置 功能介绍 查询录制回调配置接口 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/record/callbacks/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
修改录制回调配置 功能介绍 修改录制回调配置接口 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/callbacks/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
身份认证与访问控制 身份认证 您可以通过Live控制台、API、SDK访问Live,无论访问方式封装成何种形式,其本质都是通过Live提供的REST风格的API接口进行请求。 Live的接口请求需要经过认证后才可以访问成功。其中,调用接口有以下两种认证方式,您可以选择其中一种进行认证鉴权。
状态码 调用视频直播API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。