DB3502 T 072.2-2021 公共安全视频图像系统运维技术规范 第2部分:接口.pdf
《DB3502 T 072.2-2021 公共安全视频图像系统运维技术规范 第2部分:接口.pdf》由会员分享,可在线阅读,更多相关《DB3502 T 072.2-2021 公共安全视频图像系统运维技术规范 第2部分:接口.pdf(50页珍藏版)》请在麦多课文档分享上搜索。
1、 ICS 35.240 CCS L 77 3502 福建省厦门市地方标准 DB3502/T 072.2 2021 公共安全 视频图像 系统运维 技术规范 第2 部分:接口 Technical specification for operation and maintenance of video and image system for public securityPart2:Interfaces 2021-12-21 发布 2022-01-03 实施 厦门市市 场监督 管 理局 发 布 DB3502/T 072.2 2021 I 目 次 前言.II 引言.III 1 范围.1 2 规 范性
2、 引用 文件.1 3 术 语和 定义.1 4 缩 略语.1 5 接 口分 类与 协议 结构.1 6 接 口功 能.2 7 接 口资 源描 述.3 8 接口.3 附录A(资 料性)REST 架构协 议模 型.39 附录B(资 料性)告警.42 附录C(资 料性)资源URI.44 DB3502/T 072.2 2021 II 前 言 本文件 按照GB/T 1.1 2020 标 准化 工作 导则 第1 部分:标准 化文 件的 结构 和起草 规则 的 规 定起草。本文件 为DB3502/T 072 公共安 全视 频图 像 系 统运 维技术 规范 的 第2 部分。DB3502/T 072 已发 布了以下
3、 部分:第1 部 分:总体 要求;第2 部 分:接口;第3 部 分:数据 元。请注意 本文 件的 某些 内容 可能涉 及专 利。本文 件的 发布机 构不 承担 识别 专利 的责任。本文件 由厦 门市 安全 技术 防范协 会提 出。本文件 由厦 门市 公安 局归 口。本文件 起草 单位:厦 门市 公安局、厦 门市 安全 技术 防范协 会、厦门 市标 准化 研究院、苏 州科 达科 技股份有 限公 司、厦 门凯 迪 空间电 子有 限公 司、杭 州 海康威 视数 字技 术股 份有 限公司、罗普 特科 技集 团 股份有限 公司。本文件 主要起 草人:李童、覃智 泉、林 三达、张茂 林、庄 毅滨、郭流 流
4、、陆 通、柳 少英、崔晓 琳、李钊茜、夏 莉、李庚、陈 耿斌。DB3502/T 072.2 2021 III 引 言 公共安 全视 频图 像系 统在 打击犯 罪、治 安防 控、社 会 治理以 及服 务民 生方 面发 挥了重 要的 作用,公共 安 全视 频 图像 系 统运 维管 理 平台 建 设的 统 一和 规范,将进 一 步提 升 公共 安全 视 频图 像 系统 运 维的服务水平,有利 于视 频图 像 行业的 专业 化、规 范化 发 展。DB3502/T 072 公 共 安全视 频图 像系 统运 维技 术规范 旨在 确立 公共 安全 视频图 像系 统运 维管 理平 台总体 设计、接 口、数据
5、元的技 术标 准,为视 频 图 像系统运 维管 理平 台的 建设 提供基 础规 范。DB3502/T 072 拟 由三 个部 分构成:第1 部 分:总体 要求。目 的在于 确立 公共 安全 视频 图像系 统运 维管 理平 台关 键技术 路线 和软件系统 的组 织形 式,确保 总体架 构满 足服 务范 围内 公共安 全视 频图 像系 统运 维需求,明 确主要功能 模块 和模 块间 的逻 辑关系,避 免“过度 建设”并确 保“必要 建设”。第2 部 分:接口。目 的在 于将公 共安 全视 频图 像系 统运维 管理 平台 对外 接口 标准化,明 确接口在安 全性、完 备性、一 致性、易用 性、稳定
6、性方 面的要 求,并从 本级 一机 一档管 理系 统、下级公 共安 全视 频图 像系 统运维 管理 平台、前 端智 能箱系 统及 其他 应用 系统 接入等 方面,明确接入 的实 现方 式,为保 障建设 质量 及拓 展应 用范 围提供 技术 支撑。第3 部 分:数据 元。通过 标准化 描述 公共 安全 视频 图像系 统运 维管 理平 台的 数据元 和数 据模型,构 建标 准化 的数 据环 境,为 建设 数据 共享、标 准统一 的公 共安 全视 频图 像运维 管理 体系提供基 础规 范。DB3502/T 072.2 2021 1 公共安全 视频图 像系统运 维技术 规范 第2 部分:接口 1 范围
7、 本文件 规定 了 公 共安 全视 频图像 系统 运维 管理 平台 的接口 分类 与协 议结 构、接口功 能、接口 资源 描述、接 口等 技术 要求。本 文 件 适用 于 公共 安 全视频 图 像 系统 运 维管 理 平台的 规 划 设计、软件 开 发及接 口 协 议的 符 合性 测试。2 规范性 引用 文件 下列文 件中 的内 容通 过文 中的规 范性 引用 而构 成本 文件必 不可 少的 条款。其 中,注日 期的 引用 文件,仅该日 期对 应的 版本 适用 于本文 件;不注 日期 的引 用文件,其 最新 版本(包 括所有 的修 改单)适 用 于 本文件。GB/T 28181 公 共安 全视
8、 频 监控联 网系 统信息 传 输、交换、控制 技术 要求 GA/T 1400.4 公 安视 频图 像信息 应用 系统 第4 部分:接口 协议 要求 DB3502/T 072.1 公 共安 全 视频图 像 系 统运 维技 术规 范 第1 部分:总 体要 求 IETF RFC 2616 超文 本传 输协议-HTTP/1.1(Hypertext Transfer Protocol-HTTP/1.1)3 术语和 定义 GB/T 28181、GA/T 1400.4、DB3502/T 072.1 界 定的 术语和 定义 适用 于本 文件。4 缩略语 下列缩 略语 适用 于本 文件。REST:表述 性状
9、态传 递(Representational State Transfer)SNMP:简单 网络 管理 协议(Simple Network Management Protocol)URI:统一 资源 标识 符(Uniform Resource Identifier)5 接口分 类 与 协议 结构 接口分 类 公共 安 全视频 图像 系统运 维管理 平台接 口为 运维管理 平台 和各应 用系 统专业 运维节 点的对 接接 口。一机一 档 管理 系统 作为资 源汇聚 中心,提供 统一 运 维对象 开放接 口,各类接 口交互 实体关 系见 图1,接口分类 说明 如下:运维系 统对 接接 口用 于 公
10、共安全 视频 图像 系统 运维 管理平 台和 本级 一机 一档 管理系 统专 业运维节点、下 级 公 共安 全视 频图像 系统 运维 管理 平台、前端 智能 箱系 统 专 业运 维节点 及其 他应用系统 专业 运维 节点 之间 的数据 交互;DB3502/T 072.2 2021 2 统一运 维对 象开 放接 口用 于一机 一档 管理 系统 和 公 共安全 视频 图像 系统 运维 管理平 台、前端智能箱 系统 专业 运维 节点 及其他 应用 系统 专业 运维 节点之 间的 数据 交换。视频图像系统运维管理平台前端智能箱系统专业运维节点其它应用系统专业运维节点下级视频图像系统运维管理平台运维系统
11、对接接口本级一机一档运维系统对接接口运维系统对接接口前端智能箱系统对接接口统一 运维对象 开放接口统一运维对象开放接口统一运维对象开放接口下级一机一档下级应用系统专业运维节点统一运维对象 开放接口运维系统对接接口运维系统对接接口 图1 接口交 互实 体关 系图 协议结 构 5.2.1 所有接 口交 互信 息定 义 为REST 架构 下的 资源,使 用URI 唯 一标 识。5.2.2 接口交 互连 接方 式应 支 持 HTTP 长连 接和 短连 接,实 现机制 应符 合 IETF RFC 2616 中的 相关 规定。5.2.3 应用系 统接 口访 问形 式应 符合附 录 A 中的 A.3。6 接
12、口功 能 公共功 能 6.1.1 功能要 求 应用系 统专 业运 维节 点对 接 运维 管理 平台 应支 持注 册、心 跳、告警 通知、状 态 订阅、状态 订阅 通 知等公共 功能。专有 设备 管 理系统 专业 运维 节点、前 端智能 箱系 统 专 业运 维节 点对接 运维 管理 平台,应 支持公共 功能。其 中:注册失 败时,应 延 迟 300s 内的随 机时 间后 重新 注册;注册成 功后,在10s 内未 交互信 息则 进行 心跳 保活;应用系 统专 业运 维节 点汇 聚本系 统相 关的 服务 器、服务实 例、子系 统的 异常 告警及 前端 设备告警,应上 报运 维管理 平 台。DB350
13、2/T 072.2 2021 3 6.1.2 告警 应用系 统专 业运 维节 点,汇 聚对接 应用 系统 的告 警异 常,应 对通 用应 用服 务异 常 告警进 行抽 象定 义,本文件 定义 部分 通用 告警 类型:应用系 统专 业运 维节 点代 理多个 子系 统时,各 子系 统对告 警类 型定 义不 完全 一致情 况下,和运维管理 平 台对 接时,应 用系统 专业 运维 节点 在保 证告警 码在 系统 内唯 一的 前提下,可 上报自定义 的告 警类 型;通用告 警类 型见 附 录 B 中的 B.1;告警属 性见附录 B 中的 B.2;告警级 别见附录 B 中的 B.3;告警来 源分 为应 用
14、系 统专业 运维 节点 内告 警和 邻近 系统告 警。专用功 能 6.2.1 运维系 统对 接接 口 6.2.1.1 应用系 统 专业 运 维 节点应 支持服 务实例 维护,前端 智能箱 系统 专 业运 维节点、专有 设备管 理系统专 业运 维节 点可 不支 持服务 实例 维护。应用 系 统内部 服务 实例 有变 更时,应 调用 服务 实例 增加、删除或修 改接 口。6.2.1.2 可按需 提供 应用 系统 专业 运维节 点之 间系 统 间 告警 订阅、系统 间告 警订 阅通 知 和状 态订 阅。6.2.2 前端智 能箱 系统 对接 接口 6.2.2.1 应支持 设备列 表查 询功能,运维 管
15、理平 台 通 过接口 查询 前 端智能 箱系 统 关联 的 智能 箱 列表,和一机 一档 管理 系统 的 设 备信息 进行 比对 分析,查 找是否 存在 设备 冲突。6.2.2.2 应支持 智能 控制 功能,对 前端智 能箱 系统 管理 的 智 能箱 进 行重 启、开关 电等 操作。6.2.3 统一运 维对 象 开 放接 口 6.2.3.1 应支持 向 一 机一 档 管 理系 统 查询 设备 信息,响 应 一 机一档 管理 系统 状态 结果 通知。7 接口资 源描 述 资源URI 7.1.1 运维系 统资 源URI 见附录C 中的C.1。7.1.2 应用系 统资 源URI 见附录C 中的C.2
16、。7.1.3 一机一 档 管 理系 统资源 URI 见附 录C 中的C.3。8 接口 运维 系 统对 接接 口 8.1.1 注册 8.1.1.1 交互流 程 注册交 互流 程见 图2,信 令 流程描 述如 下:DB3502/T 072.2 2021 4 a)应用系 统专 业运 维节 点向 运维管理 平台 POST 发送/nms/v1/register 请 求。应 用系统 专业 运 维节点可 以是 前端 智能 箱系 统 专业 运维 节点、下级 运 维 管理 平台、专有 设备 管 理系统 专业 运维 节点等运 维节 点;b)运维管 理平 台 将 注册 成功 与否的 响应 返回 给发 起者。专业运维
17、节点 运维管理平台1 POST/nms/v1/register2 response 图2 注册交 互流 程图 8.1.1.2 流程示 意图 注册流 程示 意图 见 图3。专业运维节点向运维管理平台 发送/nms/v1/register进行注册注册处理注册完成专业运维节点注册异常处理注册成功注册失败 图3 注册流 程示 意图 8.1.1.3 注册功 能描 述 注册功 能描 述见 表1。DB3502/T 072.2 2021 5 表1 注册功 能描 述表 URI/nms/v1/register 功能 注册 HTTP 方法 POST 请求消息体 id:35020000001370000218,pas
18、sword:xxxx 请求说明(R)id:一机一档管理系统分 配应用系统专业运维节点国标id(O)password:加密后的ID BASE64 编码 返回结果 code:0,data:token:a.b.c,message:结果说明 Token payload 内容为 exp:1554821260,-过期 时间 iat:1547608753-生成 时间 在过期时间之前调用方需要重新调用register 接口获取新的token Token 值放入后续请求header 的authorization 字段中标记已经 登录过 Authorization:Bearer a.b.c 注:R 为必选项,O
19、为可选项。8.1.2 心跳 8.1.2.1 交互流 程 心跳交 互流 程见 图4,信 令 流程描 述如 下:a)应用系 统 专 业运 维节 点 定 时向 运 维管 理平 台 GET 发送/nms/v1/heartbeat/id 请求;b)运维管 理平 台 将 心跳 成功 与否的 响应 返回 给发 起者。DB3502/T 072.2 2021 6 专业运维节点 运维管理平台1 GET/nms/v1/heartbeat/id2 response 图4 心跳交 互流 程图 8.1.2.2 流程示 意图 心跳流 程示 意图 见图5。专业运维节点向运维管理平台 发送/nms/v1/heartbeat/i
20、d运维管理平台接收心跳数据情况结束专业运维节点心跳保活异常处理心跳成功未接收到心跳数据或心跳失败 图5 心跳流 程示 意图 8.1.2.3 心跳功 能描 述 心跳功 能描 述见 表2。DB3502/T 072.2 2021 7 表2 心跳功 能描 述表 URI/nms/v1/heartbeat/id 功能 应用系统专业运维节点心跳接口 HTTP 方法 GET 请求参数 id 请求消息体 无 请求说明(R)id:一机一档管理系统分配 应用系统专业运维节点国标 id 返回结果 code:0,message:结果说明 注册后,定时向 运维管理平台发送心跳保活消息,建议 10 秒 一次 注:R 为必选
21、项,O 为可选项。8.1.3 服务实 例维 护 8.1.3.1 交互流 程 服务实 例维 护交 互流 程见 图6,信令 流程 描述 如下:a)应用系 统 专 业运 维节 点 向 运维管 理平 台发送/nms/v1/serviceInstance 增加、修改、删 除请 求;b)运维管 理平 台 将 操作 成功 与否的 响应 返回 给发 起者。专业运维节点 运维管理平台1 POST/PUT/DELETE/nms/v1/serviceInstance2 response 图6 服务实 例维 护交 互流 程图 8.1.3.2 流程示 意图 服务实 例维护 流 程示 意图 见图7。DB3502/T 07
22、2.2 2021 8 专业运维节点向运维管理平台 发送/nms/v1/serviceInstance增删改请求运维管理平台接收服务实例维护处理结束专业运维节点服务实例维护异常处理处理成功处理失败 图7 服务实 例维 护流 程示 意图 8.1.3.3 增加服 务实 例功 能描 述 增加服 务实 例功 能描 述见 表3。表3 增加服 务实 例功 能描 述表 URI/nms/v1/serviceInstance 功能 增加服务实例,可批量添加 HTTP 方法 POST 请求消息体 hardwareID:xxxx,systemID:xxxx,name:流媒体微服务 请求说明(R)hardwareID:
23、服务所属设备 ID(O)systemID:服务所属系 统ID(R)name:服务名称 返回结果 code:0,data:hardwareID:xxxx,systemID:xxxx,id:xxxxxxxx DB3502/T 072.2 2021 9 表3(续)返回结果,message:结果说明(R)id:一机一档管理系统分配 ID(R)hardwareID:服务所属设 备ID(O)systemID:服务所属系 统ID 注:R 为必选项,O 为可选项。8.1.3.4 修改服 务实 例功 能描 述 修改服 务实 例功 能描 述见 表4。表4 修改服 务实 例功 能描 述表 URI/nms/v1/se
24、rviceInstance 功能 修改服务实例,只允许修改 hardwareID(即服务和硬件设备 对应关系)HTTP 方法 PUT 请求消息体 id:xxxx,hardwareID:xxxx,systemID:xxxx,name:流媒体微服务 请求说明(R)id:服务实例 ID(一机 一档管理系统 分配)(R)hardwareID:服务所属设 备ID(O)systemID:服务所属系 统ID(R)name:服务名称 返回结果 code:0,message:结果说明 注:R 为必选项,O 为可选项。8.1.3.5 删除服 务实 例功 能描 述 删除服 务实 例功 能描 述见 表5。DB3502
25、/T 072.2 2021 10 表5 删除服 务实 例功 能描 述表 URI/nms/v1/serviceInstance/id 功能 删除服务实例 HTTP 方法 DELETE 请求消息体 id 请求说明(R)id:服务实 例 ID(一机 一档管理系统 分配)返回结果 code:0,data:id:xxxxxxxx,message:结果说明 注:R 为必选项,O 为可选项。8.1.4 告警通 知 8.1.4.1 交互流 程 告警通 知交 互流 程见 图8,信令流 程描 述如 下:a)应用系 统 专 业运 维节 点 向 运维管 理平 台发送/nms/v1/alarm 告 警通 知;b)运维管
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB3502 072.2-2021 公共安全视频图像系统运维技术规范 第2部分:接口 072.2 2021 公共安全 视频 图像 系统 技术规范 部分 接口
