检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 视频接入服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 视频接入服务终端节点 区域名称 区域 终端节点(Endpoint)
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token接口来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API。 请求URI 请求URI由如下部分组成。 {URI-scheme}
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 表3 请求Body参数
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 响应参数 状态码:
obs桶策略管理 更新桶授权 获取桶信息列表
视频转储位置,可为“obs”,即存储到云服务OBS上。第一次创建转储信息时必选,不区分大小写。 bucket 否 String OBS桶名,当“store_type”为“obs”时必选。 path 否 String OBS目录,当“store_type”为“obs”时,该参数必选。
在VIS中,凭证包括访问密钥和GB/T28181密码。 GB/T28181密码 GB/T28181密码是指GB/T28181类型设备的鉴权密码,主要用于设备接入到VIS时的安全认证,认证方式由GB/T28181协议规定。 设备注册 在VIS中,设备注册是指GB/T28181设备发送注册请求到VIS中。注册成功后,设备处于在线状态。
0014 创建资源数量已超过规格限制。 404 VIS.0015 未找到用户注册信息。 403 VIS.0016 用户未申请公测,无法使用服务。 403 VIS.0017 无法访问OBS数据(如:OBS桶未授权)。 400 VIS.0018 用户已经开通过服务。 500 VIS.0019
AK/SK签名认证方式仅支持消息体大小12MB以内,12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。 AK(Access Key ID):访问密钥ID。与私有访问密钥关联的唯一标识符;访问密钥ID和
API概览 表1 VIS API概览 功能 API 说明 服务开通管理 开通服务 此接口用于用户申请开通视频接入服务。 说明:目前"华北-北京一"和"华东-上海二"区域不支持新用户开通。 获取服务开通信息 该接口用于获取服务开通信息。 说明:目前"华北-北京一"和"华东-上海二"区域不支持新用户开通。
访问与使用 视频接入服务提供了Web化的管理控制台,以及基于HTTPS请求的API管理方式,您可以将视频接入服务集成到第三方系统后使用。 管理控制台方式 您在注册华为云后,可直接通过视频接入服务控制台访问视频接入服务。 API方式 如果您需要将视频接入服务的功能集成到第三方系统,
81设备生成设备ID,以及选择关联的GB/T28181凭证。用户在设备注册时使用该设备ID与凭证,作为设备的用户名以及认证ID址。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 表3 请求Body参数
视频流转储到OBS。 OBS桶授权策略 由于VIS进行转储时需要获取用户的OBS桶授权,才能将文件上传到对应的OBS桶中,因此,在进行视频转储前您需要先完成OBS桶的授权策略。 登录VIS管理控制台。 在左侧导航栏中选择“录制管理 > obs授权管理”,找到目标OBS桶名称,单击操作列的“授权”即可。
创建GB/T28181凭证 功能介绍 该接口用于创建GB/T28181凭证,该凭证用于GB/T28181设备注册时使用。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST
Boolean 是否永久保存。 store_type String 转储位置,可为“obs”,即存储到华为云对象存储OBS上。 bucket String OBS桶名。 path String OBS目录。 timezone String 时区信息。 slice_in_minute
Boolean 是否永久保存。 store_type String 转储位置,可为“obs”,即存储到华为云对象存储OBS上。 bucket String OBS桶名。 path String OBS目录。 timezone String 时区信息。 slice_in_minute
获取设备列表 功能介绍 此接口用于获取已经注册成功的GB/T28181设备列表。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/{project_id}/devices
Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 表3 请求Body参数
Server:SIP服务器地址、端口。VIS对外提供的设备注册地址,后面在设备端注册到VIS时需要用到。 图2 设备ID和SIP服务器地址 设备端注册到VIS 设备注册到VIS的过程,需要在设备端的配置管理页面上进行配置。不同厂家的摄像设备的管理页面地址、配置入口和参数可能存在差异,具体请参考对应厂家的设备文档。