检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 调用视频直播API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。
开停播通知 视频直播提供了直播流开停播通知功能，您可以在直播控制台中为推流域名添加接收直播推流或断流通知的地址，通过HTTP接口向用户服务器发送POST请求，将直播流推送成功或中断的状态实时反馈到用户服务器，用户服务器通过200响应返回接口结果。 注意事项 启用开停播通知功能后，
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 Token认证：通过Token认证调用请求。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。具体获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 在“API凭证”页面，即可获取对应的账号ID信息。 图1 获取账号ID 父主题： 附录
配置IPv6 开启IPv6开关后，支持IPv6的客户端以IPv6协议访问Live节点。 注意事项 中国大陆大多数节点已支持IPv6，开启IPv6配置后，如果采用IPv6协议访问Live，而最优节点不支持IPv6协议时，仍能以IPv4协议访问Live节点。 操作步骤 登录视频直播控制台。
域名映射 功能介绍 将用户已创建的播放域名和推流域名建立域名映射关系 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domains_mapping 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名，每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
查询域名HLS配置 功能介绍 查询域名HLS配置。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain/hls 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
修改直播域名 功能介绍 修改直播播放、RTMP推流加速域名相关信息 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
查询推流帧率数据接口 功能介绍 查询推流帧率数据接口。 最大查询跨度1天，最大查询周期7天。 返回的帧率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据（不包含“华北-北京一”）。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
删除录制规则 功能介绍 删除录制规则接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/record/rules/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
禁止直播推流 功能介绍 禁止直播推流 用户请求响应成功后，无返回参数，返回状态码204。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
直播截图文件名是否支持自定义？ 不支持自定义，按系统预置格式生成。 存储方式为覆盖截图的文件名格式如下： {domain}/{app_name}/{stream_name}.jpg 存储方式为实时截图的文件名格式如下： {domain}/{app_name}/{stream_name}/{UTCTimestamp}
删除直播截图配置 功能介绍 删除直播截图配置接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/snapshot 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。
查询录制回调配置 功能介绍 查询录制回调配置接口 调用方法 请参见如何调用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。
示例3：禁止直播推流 场景描述 若您发现您直播业务中存在直播内容不合法或推流地址被非法盗用，您可以调用直播API对直播流进行禁止推流操作，从而保障直播资源的安全。 本章节指导用户如何使用API调用的方式禁推某个直播流。 前提条件 已明确需要被禁推的推流域名所在区域信息，并获取该区
获取直播播放日志 功能介绍 获取直播播放日志，基于域名以5分钟粒度进行打包，日志内容以 "|" 进行分隔。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
示例2：创建录制配置 场景描述 若您需要在直播过程中，对直播流进行录制，并将录制文件存储至OBS服务中，您可以在直播开始前，调用直播API为对应的播放域名配置录制规则。 本章节指导用户如何使用API调用的方式配置录制规则。 前提条件 已明确需要配置录制规则的播放域名所在区域信息，
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
