工业互联网平台接口模型规范

工业互联网产业联盟标准

工业互联网平台接口模型规范Interface Model for Industrial Internet Platform

目录

1范围 (1)

2规范性引用文件 (1)

3缩略语 (1)

4工业互联网平台接口 (2)

4.1接口模型 (2)

4.2接口组成 (2)

4.3功能说明 (3)

4.3.1工业应用接入接口 (3)

4.3.2设备/产品/服务接入接口 (5)

5接口格式要求 (6)

5.1工业应用接入接口 (6)

5.2设备/产品/服务接入接口 (7)

6接口设计要求 (7)

6.1规范性 (7)

6.1.1版本控制 (7)

6.1.2参数说明 (7)

6.1.3数据类型 (7)

6.2实用性 (7)

6.3易用性 (8)

7接口协议要求 (8)

8接口安全要求 (8)

8.1接入安全 (8)

8.2接口认证 (8)

8.3数据安全 (9)

T11/AII 001—2018

工业互联网平台接口模型

1范围

本标准规定了工业互联网平台接口模型及接口组成，并对接口格式、设计、协议及安全提出规范性要求。

本标准适用基于工业互联网平台接口的应用开发、部署、数据采集全过程。2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

《工业互联网平台安全防护要求》

《工业互联网安全接入技术要求》

3缩略语

下列缩略语适用于本文件。

— 1 —

T11/AII 001—2018

4工业互联网平台接口

4.1接口模型

工业互联网平台接口是指基于平台进行应用开发、应用运行及设备/产品/服务接入的API。

工业互联网平台接口模型如图 1 所示：

图1 工业互联网平台接口模型

如上图所示，工业互联网接口模型分为上行的工业应用接入接口层与下行的工业设备/产品/服务接入接口层。

工业应用接入接口层：明确应用接入接口层应包含的接口类型，规定应用开发与应用运行的接口要求，。

工业设备/产品/服务接入接口层：提出了设备、产品、服务的接入规范要求，工业设备、产品通过下行接口接入平台，工业服务通过服务注册接入平台。

4.2接口组成

工业互联网平台接口应由以下几部分组成：

a)模型类

b)数据类

c)服务类

—2 —

T11/AII 001—2018

d)应用管理类

e)安全类

f)标识类

g)事件类

h)运行类

i)控制类

4.3功能说明

4.3.1工业应用接入接口

4.3.1.1模型类接口

应能实现流程、仿真等模型的运行。

流程模型应包含流程运行类、流程定义类、流程监控类等接口类型；其中：流程运行类至少包含：流程实例启动、流程实例跳转、流程实例执行、流程实例结束、流程执行调度等接口。

流程定义类至少包含：流程实例创建、获取流程实例、设置流程参量、流程实例删除等接口。

流程监控类至少包含：获取流程实例状态、获取待办任务状态等接口。

仿真模型应包含仿真定义类、仿真运行类等接口类型；其中：

仿真定义类至少包含：仿真模型实例创建、仿真模型实例删除等接口。

仿真运行类至少包含：仿真执行、获取仿真模型状态、仿真模型创建、仿真模型删除等接口。

仿真监控类至少包含：获取仿真模型实例状态等接口。

4.3.1.2数据类接口

数据类应包含数据获取、数据分析、数据处理、数据存储等类型接口；其中：数据获取类至少包含：获取企业设备/产品/服务、获取设备/设备实例、获取实例网关、获取采集点等接口。

数据分析类至少包含：设备OEE 分析、产品Cpk 分析、设备状态分析、设

— 3 —

T11/AII 001—2018

备故障率分析、设备停机率分析等接口。

数据处理类至少包含：数据清洗、数据交换等接口。

数据存储类至少包含：获取数据源、数据存储等接口。

4.3.1.3服务类接口

服务类应包含统一消息类、统一缓存类、统一搜索类、服务注册类、服务编排类、服务监控类、服务治理类等类型接口，服务类根据要求提供人工智能类接口；其中：

统一消息类至少包含消息订阅、消息发布、消息监控、消息管理等接口。

统一缓存类至少包含缓存数据存储、获取缓存数据、缓存数据过期设置等接口。

统一搜索类至少包含数据源设置、索引创建、分类查询等接口。

人工智能类至少包含：文字识别、图像识别、语音识别等接口。

服务注册类至少包含服务实例注册、服务实例心跳发送等接口。

服务编排类至少包含获取服务实例、服务实例调度等接口。

服务监控类至少包含获取服务实例状态、服务实例注销、获取服务调用链等接口。

服务治理类至少包含服务降级、服务熔断等接口。

4.3.1.4应用管理类接口

应用管理类应包含部署发布类、监控管理类、中间件接入类、持续迭代类等类型接口；其中：

部署发布类至少包含：应用创建、应用上传、服务绑定、服务解绑定、应用启动、应用实例数设置、应用动态伸缩设置、应用停止、获取域名详情、绑定域名、解绑域名、应用销毁等接口。

持续迭代类至少包含：版本库创建、代码上传、代码下载、获取代码分支、持续迭代设置、创建版本等接口。

中间件接入类至少包含：服务接入、创建服务实例、服务实例配置、获取环境变量、删除服务实例、获取服务实例状态等接口。

—4 —