检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 调用视频直播API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
获取项目ID 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 图1 管理控制台
支持审计的关键操作 Live已对接云审计服务。通过云审计服务,您可以记录与云服务器相关的操作事件,便于日后的查询、审计和回溯。 前提条件 已开通云审计服务。 支持审计的关键操作列表 表1 表1 云审计服务支持的云服务器操作列表 操作名称 资源类型 事件名称 创建直播域名 domain
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
修改直播域名 功能介绍 修改直播播放、RTMP推流加速域名相关信息 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求。
删除直播域名 功能介绍 删除域名。只有在域名停用(off)状态时才能删除。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
查询直播域名 功能介绍 查询直播域名 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数
修改禁推属性 功能介绍 修改禁推属性 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 请求参数
查询域名HLS配置 功能介绍 查询域名HLS配置。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain/hls 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
示例3:禁止直播推流 场景描述 若您发现您直播业务中存在直播内容不合法或推流地址被非法盗用,您可以调用直播API对直播流进行禁止推流操作,从而保障直播资源的安全。 本章节指导用户如何使用API调用的方式禁推某个直播流。 前提条件 已明确需要被禁推的推流域名所在区域信息,并获取该区
查询直播转码模板 功能介绍 查询直播转码模板 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
查询推流帧率数据接口 功能介绍 查询推流帧率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的帧率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
直播录制周期最多支持录制多长时间? 目前直播录制支持录制文件存储至OBS,支持的最大录制周期为12小时,超过12小时将按照录制命名规则生成新文件,具体请参见录制至OBS。 父主题: 直播录制
禁止直播推流 功能介绍 禁止直播推流 用户请求响应成功后,无返回参数,返回状态码204。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
域名映射 功能介绍 将用户已创建的播放域名和推流域名建立域名映射关系 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domains_mapping 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
修改域名HLS配置 功能介绍 修改域名HLS配置。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain/hls 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
修改直播转码模板 功能介绍 修改直播转码模板 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
创建直播转码模板 功能介绍 创建直播转码模板。使用此功能将产生直播转码费用。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是