检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token接口来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API。 请求URI 请求URI由如下部分组成。 {URI-scheme}
GB/T28181设备注册成功后，无法获取到视频流的常见原因有哪些？ GB/T28181设备注册成功后，若无法获取到视频流，建议您从以下几方面进行初步排查： 检查设备是否在线且处于邀约成功状态。 检查设备端环境网络是否正常。 检查防火墙是否屏蔽端口，或是否设置了黑白名单屏蔽。 确认设备是否支持国标协议2016。
S对外提供的设备注册地址，后面在设备端注册到VIS时需要用到。 图2 设备ID和SIP服务器地址 设备端注册到VIS 设备注册到VIS的过程，需要在设备端的配置管理页面上进行配置。不同厂家的摄像设备的管理页面地址、配置入口和参数可能存在差异，具体请参考对应厂家的设备文档。 这里以IPC摄像头为例，介绍注册流程：
密码，后面设备端注册到VIS时需要输入。 根据不同的设备类型，GB/T28181密码可以选择匿名或非匿名类型： 匿名时：系统会随机生成用户名，不需要您设置，在后面设备端注册到VIS时会以设备ID作为“SIP用户认证ID”。 非匿名时：需要您设置用户名，在后面设备端注册到VIS时填写该用户名作为“SIP用户认证ID”。
按照设备ID过滤。支持模糊查询。 type 否 String 按照设备类型过滤。可选参数为IPC。 state 否 String 按照设备状态过滤，取值范围。 UNREGISTERED：未注册。 ONLINE：未邀约。 OFFLINE：已下线。 不区分大小写。 请求参数 表3 请求Header参数 参数
GB/T28181类型设备邀约成功后，如果设备故障并恢复，是否需要重新注册和邀约？ GB/T28181类型设备短时间内故障恢复，不需要重新注册和邀约。 若设备故障时间过长，超过3分钟仍无法恢复视频流，故障恢复后需要重新注册并邀约。
GB/T28181类型设备注册失败怎么处理？ 请检查GB/T28181类型设备的配置信息，保证相关配置参数正确，例如：平台接入方式为GB/T28181、传输协议为UDP。 除此之外，其余信息，如SIP服务器地址以及端口、密码等也需配置正确。SIP服务器地址可在VIS控制台的“设备管理”界面获取。
创建GB/T28181设备通道 功能介绍 此接口用于创建GB/T28181设备（摄像头、网络硬盘录像机等）通道。创建成功之后，自动为GB/T28181设备生成设备ID，以及选择关联的GB/T28181凭证。用户在设备注册时使用该设备ID与凭证，作为设备的用户名以及认证ID址。 调试
如何调用API 构造请求 认证鉴权 返回结果
更新GB/T28181设备通道接入策略 功能介绍 该接口用于设置GB/T28181设备的视频接入策略。用户可以通过设置接入策略定时自动进行设备的接入。 定时接入策略分为随机接入和连续接入两种采集类型。 随机接入：在开始时间和结束时间内，随机采集总时长为total_length参数值的视频。
设备管理 创建GB/T28181设备通道 获取设备列表 更新GB/T28181设备通道信息 获取NVR设备通道列表 删除GB/T28181设备 更新NVR设备通道列表 更新GB/T28181设备通道接入策略
Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证 。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK
channels_query String 设备通道更新状态。 IDEL：表示设备通道列表未进行更新，或者更新失败。 QUERYING：表示设备通道列表更新中。 QUERIED：表示设备通道列表更新成功。 device_id String 设备ID。 state String 设备状态。 type String
"error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息，具体请参见错误码。 父主题： 如何调用API
channels_query String 设备通道更新状态。 IDEL：表示设备通道列表未进行更新，或者更新失败。 QUERYING：表示设备通道列表更新中。 QUERIED：表示设备通道列表更新成功。 device_id String 设备ID。 state String 设备状态。 type String
节点中查询所有服务的终端节点。 视频接入服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 视频接入服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京一 cn-north-1 vis.cn-north-1.myhuaweicloud
转储失败时如何处理？ 转储失败可能有以下几个原因： OBS授权委托未创建或者被删除，请重新创建委托。 账号欠费，请及时充值。 视频流中断，请尝试重新接入以恢复视频流。 OBS桶开启了KMS加密，请在视频转储前授予VIS账号KMS Administrator权限。具体授权方法请参见给用户授权。
GB/T28181设备注册成功后，需要对设备通道进行视频邀约，视频邀约成功后，设备的视频会持续接入到VIS中，直到取消邀约。 在“设备管理”界面，选择目标设备操作列的“更多 > 视频邀约”。 图1 已注册设备 邀约成功后，在“视频流管理”界面可查看已激活的关联视频流，此时设备可以通过该视频流进行推流。
设备指标统计 获取新上线设备列表 获取新掉线设备列表 获取长期不在线设备列表 获取近期掉线的设备列表 获取在线未推流设备列表 获取视频包接收率 获取曾经上线的设备列表
描述 channels_query String 设备通道更新状态。 device_id String 设备ID。 state String 设备状态。 type String 设备类型。 username String 设备注册时所使用的GB/T28181用户名。 suffix
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
