检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备指标统计 获取新上线设备列表 获取新掉线设备列表 获取长期不在线设备列表 获取近期掉线的设备列表 获取在线未推流设备列表 获取视频包接收率 获取曾经上线的设备列表
欢迎使用视频接入服务(Video Ingestion Service,简称VIS),该服务提供实时视频数据接入功能,包括摄像头视频数据采集、实时数据分发和视频数据转储等能力。借助视频接入服务,您可以与华为云视频分析服务集成,快速构建基于实时视频数据的智能分析应用。 视频接入服务给用户提供
如何调用API 构造请求 认证鉴权 返回结果
基本概念 视频流 在网络上,视频数据按时间先后次序传输和播放的连续视频数据流。 取流 取流是指通过取流地址,从VIS中获取视频流数据的过程。 拉流 拉流是指通过公网环境中的取流地址,获取HTTP-FLV类型的视频流数据,并将其接入到VIS中。 转储 转储是指根据实时视频流来生成视频文件片段,并存储到OBS中。
约束与限制 RTMP接入功能已下线,若有RTMP视频流接入需求建议您使用视频直播服务。 目前"华北-北京一"和"华东-上海二"区域不支持新用户开通。 VIS支持以下接入类型: 视频流:支持HTTP-FLV类型的视频流接入。 设备:支持GB/T28181摄像设备接入。 VIS最多支
更新AK/SK凭证 功能介绍 该接口用于更新AK/SK凭证,AK/SK用于RTMP推流的鉴权 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v1/{pro
用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。 Token可通过调用获取用户Token接口获取,调用本服务API需要project级别的Token,即调用获取用户Token接口时,请求body中“auth.scope”的取值需要选择“project”,请求示例如下。
删除AK/SK凭证 功能介绍 该接口用于删除AKSK凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v1/{project_id}/crede
更新桶授权 功能介绍 此接口用于用户更新桶授权:授权和取消授权。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v1/{project_id}/buckets/authority
r**** 响应示例 状态码: 200 正常 { "result" : "success" } 状态码: 404 找不到资源或没有开通服务。具体返回错误码请参考错误码说明 { "error_msg" : "The username of GB28181 password is
删除视频流 功能介绍 此接口用于删除指定视频流。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v1/{project_id}/streams/{stream_name}
更新视频流 功能介绍 该接口用于更新视频流的详情,包括RTMP以及HTTP-FLV类型视频流。 接口约束 当视频流处于ACTIVE状态时,不允许修改视频接入类型 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
找不到资源或没有开通服务。具体返回错误码请参考错误码说明 { "error_msg" : "Failed to find the device.", "error_code" : "VIS.0302" } 状态码 状态码 描述 200 正常 404 找不到资源或没有开通服务。具体返回错误码请参考错误码说明
获取项目ID/账号名/AK/SK 在认证鉴权章节,需要填入账号名、用户名或者AK/SK。 在调用API的时候,部分URL中需要填入项目ID(project_id)。 由于获取方法一样,所以这里放在一起介绍操作步骤。 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上,在下拉列表中选择“我的凭证”。
"********" } 响应示例 状态码: 200 正常 { "result" : "success" } 状态码: 404 找不到资源或没有开通服务。具体返回错误码请参考错误码说明 { "error_msg" : "The username of GB28181 password is
终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 视频接入服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 视频接入服务终端节点 区域名称 区域 终端节点(Endpoint)
获取桶信息列表 功能介绍 此接口用于用户获取桶信息列表,桶信息中包含两个字段,分别是桶名称和桶授权信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v
视频流的取流地址会改变吗? 由于重新邀约后取流地址会发生改变,因此您在进行推流或拉流前,需在控制台的“视频预览”页面中获取最新的流信息,确保使用的是最新的视频流地址。您也可以通过调用获取视频流地址接口获取最新的视频流地址。
(可选)定时接入 该操作可选,VIS支持用户对已上线的国标摄像头设置定时接入策略。用户可以设置摄像头在一天中指定的时间范围内,进行随机或连续时间片接入。 登录VIS管理控制台。 在“设备管理”界面,选择设备操作列的“更多 > 配置定时接入”。 图1 配置定时接入 各参数说明如表1所示。
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型