检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com
域名映射 功能介绍 将用户已创建的播放域名和推流域名建立域名映射关系 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domains_mapping 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID
获取项目ID 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 图1 管理控制台
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
配置IPv6 开启IPv6开关后,支持IPv6的客户端以IPv6协议访问Live节点。 注意事项 中国大陆大多数节点已支持IPv6,开启IPv6配置后,如果采用IPv6协议访问Live,而最优节点不支持IPv6协议时,仍能以IPv4协议访问Live节点。 操作步骤 登录视频直播控制台
获取直播播放日志 功能介绍 获取直播播放日志,基于域名以5分钟粒度进行打包,日志内容以 "|" 进行分隔。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
修改录制规则 功能介绍 修改录制规则接口,如果规则修改后,修改后的规则对正在录制的流无效,对新的流有效。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
创建录制规则 功能介绍 创建录制规则接口,录制规则对新推送的流生效,对已经推送中的流不生效。使用此功能将产生直播录制费用。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/rules 表1 路径参数 参数 是否必选 参数类型 描述
删除录制规则 功能介绍 删除录制规则接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
删除直播域名 功能介绍 删除域名。只有在域名停用(off)状态时才能删除。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目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。 请求参数
支持审计的关键操作 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,获取方法请参考获取项目
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。