路径: 主页 > GB/T > 第225页 > GB/T 42569-2023 | 标准编号 | GB/T 42569-2023 (GB/T42569-2023) | | 中文名称 | 工业互联网平台 开放应用编程接口功能要求 | | 英文名称 | Industrial internet platform - Functional requirements for open application programming interface | | 行业 | 国家标准 (推荐) | | 中标分类 | L70 | | 国际标准分类 | 35.240.01 | | 字数估计 | 12,193 | | 发布日期 | 2023-05-23 | | 实施日期 | 2023-12-01 | | 发布机构 | 国家市场监督管理总局、中国国家标准化管理委员会 | GB/T 42569-2023: 工业互联网平台 开放应用编程接口功能要求
GB/T 42569-2023 英文名称: Industrial internet platform -- Functional requirements for open application programming interface
中华人民共和国国家标准
工业互联网平台
开放应用编程接口功能要求
国 家 市 场 监 督 管 理 总 局
国 家 标 准 化 管 理 委 员 会 发 布
1 范围
本文件确立了工业互联网平台开放应用编程接口框架,规定了接口的功能要求。
本文件适用于工业互联网平台或工业应用的开发方、使用方及第三方组织对工业互联网平台和接
口开展设计、开发及测试评估工作。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文
件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于
本文件。
GB/T 11457-2006 信息技术 软件工程术语
3 术语和定义
GB/T 11457-2006界定的以及下列术语和定义适用于本文件。
4 开放应用编程接口
4.1 接口框架
工业互联网平台开放应用编程接口指用于管控工业应用、工业装备,并为其他工业互联网平台提供
能力的接口。开放应用编程接口要求,用于指导开展工业应用、工业装备和工业互联网平台间的互联互
通、互操作接口设计、开发及测试评估工作。
开放应用编程接口包括:工业应用接口、工业装备接口和工业互联网平台间接口。工业互联网平台
开放应用编程接口框架见图1。其中,工业应用接口为工业应用及其开发者提供了工业应用开发过程
中所需的资源、数据及支撑服务的访问及操作的能力;工业装备接口为工业装备及其开发者提供了工业
装备的接入、监控、配置、运维的能力;工业互联网平台间接口为工业应用及其开发者提供了平台间互
联、互通、互操作的能力;“”为与工业装备接口处于同一层级包括如资源与能力接口等在内的其他
接入工业互联网平台的接口。
4.2 工业应用接口
工业应用接口应包含:
a) 资源管理类接口;
b) 数据操作类接口;
c) 安全辅助类接口;
d) 应用管理类接口;
e) 支撑服务类接口;
f) 运维管理类接口。
4.3 工业装备接口
工业装备接口应包含:
a) 接入管理类接口;
b) 监控管理类接口;
c) 数据管理类接口;
d) 安全辅助类接口;
e) 运维管理类接口。
4.4 工业互联网平台间接口
工业互联网平台间接口应包含:
a) 互通管理类接口;
b) 数据操作类接口;
c) 安全辅助类接口;
d) 运维管理类接口。
5 工业应用接口要求
5.1 资源管理类接口
资源管理类接口应:
a) 提供对计算资源、存储资源、网络资源的申请功能;
b) 提供对已申请资源的使用功能;
c) 提供对已注销资源的释放功能;
d) 提供对运行中资源的监控功能。
5.2 数据操作类接口
数据操作类接口应:
a) 针对不同的数据存储要求,提供全量、增量的写入功能;
b) 依据业务处理要求,对状态变更的数据提供逐条、批量的逻辑删除功能;
c) 在过程数据发生变更时,提供满足不同结构数据的全量、增量更新功能;
d) 对各种结构化数据、非结构化数据和半结构化数据的读取查询功能;
e) 针对报表呈现的数据要求,提供业务数据的统计分析功能。
5.3 安全辅助类接口
安全辅助类接口应:
a) 具备验证用户真实身份和权限范围的能力;
b) 具备访问速率限制、访问次数限制及峰值保护等能力;
c) 对具有写入权限的接口,提供验证输入、输出内容的能力;
d) 具备安全审计功能,如,访问异常检测能力、接口访问行为检测能力等;
e) 接口鉴权应具备时效性,对于异常访问应限制最高错误次数。
5.4 应用管理类接口
应用管理类接口应提供:
a) 应用创建功能,实现应用实例的创建过程,包含应用上传、应用调试、应用验证、应用部署、应用
配置和应用发布;
b) 应用操作功能,对已创建的应用实例,实现实例统计、实例查询、实例启动、实例更新、实例停止
和实例销毁;
c) 应用关联功能,对应用实例关联的数据源和服务提供绑定与解除绑定的功能;
d) 应用监控功能,实现对运行的应用进行监控,包括运行状态、会话控制、异常告警、日志审计和
阈值监控。
5.5 支撑服务类接口
支撑服务类接口应提供第三方支撑服务的操作能力,支撑服务类接口提供的服务应包括但不限于:
a) 消息队列服务支持:
1) 队列的创建、配置、读取、删除、查看、监控启动和停止的功能;
2) 消息的发送、获取、删除的功能。
b) 算法服务支持:
1) 算法服务实例创建、销毁和状态查询功能;
2) 算法服务模型声明及服务调用的功能。
c) 数据库服务支持:
1) 数据库实例的创建、修改、销毁的功能;
2) 表索引的创建、修改、销毁的功能;
3) 表分区的创建、修改、销毁的功能;
4) 实例运行时监控的能力,以及配置数据集权限的功能。
5.6 运维管理类接口
运维管理类接口:
a) 应针对已有应用实例,提供备份与迁移、快速恢复、应用重启等功能;
b) 应实现应用依赖的各种数据结构的数据备份,按照时间节点或业务要求进行的数据恢复功能;
c) 应按照数据存储时间周期,定期实现数据的清理或迁移功能;
d) 应具备数据操作、传输日志的记录功能,并提供数据存储的能力;
e) 可具备应用实例的异常诊断及其自恢复功能。
6 工业装备接口要求
6.1 接入管理类接口
接入管理类接口应满足如下要求:
a) 支持工业装备直连接入,包括:
1) 具备工业装备识别能力,提供工业装备识别、鉴权功能,根据预设规则主动扫描网络内待
接入装备并建立接入连接;
2) 具备工业装备注册能力,提供工业装备鉴权及信息收集功能;
3) 具备工业装备接入复位能力,提供快速恢复前次配置的功能。
b) 支持工业装备网关类产品接入,包括:
1) 具备工业装备网关识别能力,提供工业装备网关的识别、鉴权功能,可根据预设规则主动
扫描工业装备网关并建立接入连接;
2) 具备工业装备网关注册能力,提供工业装备网关的鉴权及信息收集功能;
3) 具备工业装备网关接入复位能力,提供快速恢复前次配置的功能。
6.2 监控管理类接口
监控管理类接口功能包括:
a) 应支持监控工业装备的综合利用信息、故障信息、计划时间、平均故障间隔期和有效生产数据
信息;
b) 应支持监控工业装备的工况状态;
c) 可支持监控工业装备的能耗资源分配使用情况,如,水、电、气等;
d) 应支持监控工业装备的生产数据;
e) 应支持监控工业装备的异常信息、报警事件;
f) 可支持监控工业装备网络状况。
6.3 数据管理类接口
数据管理类接口功能应:
a) 支持模型构建,包括:
1) 具备对于几何模型、物理特征、数据模型和处理模型的建模功能;
2) 支持模型变更,根据工业装备信息的变化,对几何模型、物理特征、数据模型和处理模型的
数据进行同步变更;
3) 支持模型移除,将取消或弃用的模型进行移除操作。
b) 支持数据处理,包括:
1) 支持数据获取,获取装备的注册台账信息、装备运行状态信息和装备生产工艺信息;
2) 支持数据解析,提供识别装备采集数据的能力,实现数据解析;
3) 支持数据加工,提供支持数据采集的边缘计算能力,基于数据模型和处理模型中的配置信
息,对已采集的数据进行清洗、转换及规则感知计算等处理;
4) 支持数据存储,将经加工处理的数据写入工业互联网平台进行持久化存储。
c) 支持命令下发,包括:
1) 支持装备控制,接收装备运行控制命令,下发装备运行控制命令至工业装备;
2) 支持固件升级,为固件程序提供版本升级功能。
6.4 安全辅助类接口
安全辅助类接口功能应包括:
a) 提供对工业装备接入进行身份鉴别的功能;
b) 提供通信链路加密功能,实现对工业装备上行数据和下行数据的安全防护;
c) 提供非可逆算法生成会话签名,保障通信通道链路中传输的信息不被篡改或窃取;
d) 支持预设通信链路的会话时间,降低工业装备接口被攻击/仿冒的风险;
e) 提供支持工业装备终端敏感数据的脱敏功能,实现安全启动和安全能力升级。
6.5 运维管理类接口
运维管理类接口功能包括:
a) 应支持工业装备的工单操作,记录处理工单的过程信息;
b) 应支持对工业装备采集的数据进行定期维护,实现定时、定量的数据清理与迁移;
c) 可支持通过对工业装备工况信息的数据分析,实现为工业装备预测性维护提供数据支撑;
d) 应支持通过对工业装备的日常巡检和点检,完成对工业装备的保护性检查,记录排查信息并提
供工业装备的健康数据;
e) 应支持获取并管理工业装备上存储的日志信息,实现日志信息的审计维护功能。
7 工业互联网平台间接口要求
7.1 互通管理类接口
互通管理类接口应包括:
a) 支持工业互联网平台配置,具备工业互联网平台间的互联操作及配置平台实例的能力;
b) 支持服务配置,具备对工业互联网平台开放服务实现配置调整的能力;
c) 具备工业互联网平台间的网络诊断功能;
d) 具备工业互联网平台间开放服务的访问功能;
e) 具备长连接资源的释放操作,提供应答确认功能。
7.2 数据操作类接口
数据操作类接口应包括:
a) 支持通过符合相关规定的请求/响应模式实现同步信息......
|