工 业 互 联 网 产 业 联 盟 标 准
A II/016-2022
边缘计算平台与应用的接口
技术要求
Technical Requ irement for Interface
between Edge Computing Platform and App
in edge comput ing
工业互联网产业联盟
(2022 年 10 月)
目 次
前 言
为适用我国工业互联网新形势需求，推进CT技术与IT技术的深度融合，完善边缘计算新生态模式系列标准的相关标准体系，本标准制定边缘计算平台与应用技术要求。本标准参考国内和国际的相关标准，并结合国内边缘计算的实际情况制定。
本标准按照GB/T1.1-2009给出的规则起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。
随着技术的发展，还将制定后续的相关标准。
本标准起草单位： 中国移动通信集团有限公司、中国信息通信研究院、广州英码信息科技有限公司、腾讯云计算(北京)有限责任公司、浪潮通信技术有限公司、北京研华兴业电子科技有限公司、深圳艾灵网络有限公司、西门子(中国)有限公司、红帽软件(北京)有限公司、中国移动通信集团云南有限公司。
本标准主要起草人：张昊、刘景磊、张婷婷、师晓卉、王哲、胡钟颢、梁红波、区英杰、谭焯康、李侃、王晔彤、李强、任茜、汪辉、路浩伟、俞一帆、王美婷、赵锡漪、李宇、周星宇、王之帆。
边缘计算平台与应用的接口技术要求
1 范围
标准规定了边缘计算平台与应用之间的接口要求，包括应用使能接口、带宽管理接口、位置服务接口、UE身份标识接口、应用移动服务接口、边缘智能接口、边缘数据接口、边缘运维接口、边缘应用管理接口、边缘存储接口等。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
T/CCSA 332-2021 工业互联网边缘计算 边缘节点模型与要求 边缘控制器
YD/T 3962-2021 5G核心网边缘计算总体技术要求
SR 357-2022 人工智能终端产品标准体系研究
ETSI GS MEC 003 Mobile Edge Computing (MEC) ;Framework and Reference Architecture
ETSI GS MEC 009 Multi-access Edge Computing (MEC) ; General principles for MEC Service APIs
ETSI GS MEC 010-2 Mobile Edge Computing (MEC) ;Mobile Edge Management ;Part 2 : Application lifecycle, rules and requirements management
ETSI GS MEC 011 Mobile Edge Computing (MEC) ;Mobile Edge Platform Application Enablement
ETSI GS MEC 016 Multi-access Edge Computing (MEC) ;UE application interface
ETSI GS MEC 010-1 Mobile Edge Management ; Part 1 : System, host and platform management
ETSI GS MEC 013 Location API
ETSI GS MEC 014 UE Identity API
ETSI GS MEC 015 Bandwidth Management API
ETSI GS MEC 016 UE application interface
3 术语和定义
3.1
数据预处理 Data Preprocessing
在工业互联网系统上建立物理实体、流程或者系统等的虚拟映射，虚实之间能够实现双向控制和模拟的模型。
3.2
协议转换 Protocol Conversion
协议转换是指边缘计算平台支持多种总线协议的转换，实现不同设备域系统之间的数据交互。
3.3
数据转发 Data Forwarding
数据转发是指边缘平台将采集的数据转发给其他的边缘网关、边缘平台或中心云等系统和设备。
4 缩略语
下列缩略语适用于本文件。
MEC 多接入边缘计算 (Multi-access Edge computing)
HTTP 超文本传输协议 (Hyper Text Transfer Protocol)
TLS 安全传输层协议 (Transport Layer Security)
DNS 域名系统 (Domain Name System)
IP 网际互连协议 (Internet Protocol)
UE 用户设备 (User Equipment)
GPU 图形处理器 (Graphics Processing Unit)
CPU 中央处理器 (Central Processing Unit)
FGPA 现场可编程门阵列 (Field Programmable Gate Array)
MPU 微处理器 (Microprocessor Unit)
VM 虚拟机 (Virtual Machine)
MQTT 消息队列遥测传输 (Message Queuing Telemetry Transport)
MAC 媒体存取控制 (Media Access Control)
NFS 网络文件系统 (Network File System)
NAS 网络附属存储 (Network Attached Storage)
SCSI小型计算机系统接口 (Small Computer System Interface)
5 接口概述
边缘计算应用在其运行的生命周期内，可通过访问边缘计算平台的开放接口，调用其能力来满足应用自身的需求。
6 接口描述
6.1 通信协议
边缘计算平台与应用之间的通信协议建议基于HTTP1.1或更高版本，需要通过加密传输增强端到端的安全性时，建议采用TLS 1.2或更高版本。接口风格是Rest API接口，用于应用注册发现和边缘网络能力以及边缘行业能力调用。
6.2 接口能力要求
边缘计算平台与应用之间的接口能够提供服务注册、服务发现和服务间通信的能力。它还能提供其他的功能，如边缘应用可用性检测、分流规则和DNS规则的激活和去活、时间信息查询等。需要支持应用注册发现、带宽管理、位置服务、UE身份标识、无线网络信息、移动性管理等CT网络能力，还需支持通用行业能力接口要求， 向边缘计算应用提供边缘智能能力、边缘数据能力、边缘运维能力、边缘应用管理能力和边缘存储能力。
6.3 请求参数
每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。
公共参数可包含接口的认证鉴权，如token等
6.4 响应参数
响应参数可包括两部分，响应状态和响应内容。响应状态为平台与应用之间约定的自定义状态码，标识请求的处理结果。响应内容为该状态所对应的请求处理结果的信息。其他响应参数可参照具体的接口介绍。
7 接口定义
7.1 应用使能接口
7.1.1 分流规则
7.1.1.1 查询多个分流规则
该接口用于查询分流规则列表。请求及响应参数宜包含表中参数：
表1查询分流规则列表
7.1.1.2 查询指定分流规则
该接口用于查询指定分流规则。请求及响应参数宜包含表中参数：
表2 查询指定分流规则
7.1.1.3 更新指定分流规则
该接口用于更新指定分流规则状态。请求及响应参数宜包含表中参数：
表3 更新指定分流规则状态
7.1.2 DNS 规则
7.1.2.1 查询多个 DNS 规则
该接口用于查询DNS规则列表。请求及响应参数宜包含表中参数：
表4 查询DNS规则列表
7.1.2.2 查询指定 DNS 规则
该接口用于查询指定DNS规则。请求及响应参数宜包含表中参数：
表5 查询指定DNS规则
7.1.2.3 更新指定 DNS 规则状态
该接口用于更新指定DNS规则。请求及响应参数宜包含表中参数：
表6 更新指定DNS规则
7.1.3 系统时间
7.1.3.1 查询系统当前时间
该接口用于查询系统当前时间。请求及响应参数宜包含表中参数：
表7 查询系统当前时间
7.1.4 服务注册
7.1.4.1 新增服务注册
该接口用于向边缘计算平台注册新增服务。请求及响应参数宜包含表中参数：
表8 新增服务注册
7.1.4.2 查询应用实例的服务注册
该接口用于查询应用实例的服务注册。请求及响应参数宜包含表中参数：
表9 查询应用实例的服务注册
7.1.4.3 查询指定服务注册信息
该接口用于查询指定服务注册信息。请求及响应参数宜包含表中参数：
表10 查询指定服务注册信息
7.1.4.4 更新服务注册信息
该接口用于更新服务注册信息。请求及响应参数宜包含表中参数：
表11 更新指定服务注册信息
7.1.4.5 删除服务注册信息
该接口用于删除服务注册信息。请求及响应参数宜包含表中参数：
表12 删除指定服务注册信息
7.1.5 服务订阅
7.1.5.1 新增服务订阅
该接口用于新增服务订阅信息。请求及响应参数宜包含表中参数：
表13 新增服务订阅信息
7.1.5.2 查询应用实例的服务订阅信息
该接口用于查询应用实例的服务订阅信息。请求及响应参数宜包含表中参数：
表14 新增服务订阅信息
7.1.5.3 查询指定的服务订阅信息
该接口用于查询指定的服务订阅信息。请求及响应参数宜包含表中参数：
表15 查询指定的服务订阅信息
7.1.5.4 删除服务订阅
该接口用于删除服务订阅信息。请求及响应参数宜包含表中参数：
表16 删除指定服务订阅信息
7.1.6 服务信息
7.1.6.1 查询服务信息
该接口用于查询服务信息。请求及响应参数宜包含表中参数：
表17 查询服务信息
7.1.6.2 查询指定服务信息
该接口用于查询指定服务信息。请求及响应参数宜包含表中参数：
表18 查询指定服务信息
7.1.7 服务状态信息
7.1.7.1 查询单个服务状态信息
该接口用于查询单个服务状态信息。请求及响应参数宜包含表中参数：
表19 查询单个服务状态信息
7.1.7.2 更新服务状态信息
该接口用于更新单个服务状态信息。请求及响应参数宜包含表中参数：
表20 更新单个服务状态信息
7.2 带宽管理接口
7.2.1 带宽管理规则
7.2.1.1 新增带宽管理规则
该接口用于新增带宽管理规则。请求及响应参数宜包含表中参数：
表21 新增带宽管理规则
7.2.1.2 查询所有的带宽管理规则
该接口用于查询所有带宽管理规则。请求及响应参数宜包含表中参数：
表22 查询所有带宽管理规则
7.2.1.3 查询指定带宽管理规则
该接口用于查询指定带宽管理规则。请求及响应参数宜包含表中参数：
表23 查询指定带宽管理规则
7.2.1.4 更新带宽管理规则
该接口用于更新指定带宽管理规则。请求及响应参数宜包含表中参数：
表24 更新指定带宽管理规则
7.2.1.5 删除带宽管理规则
该接口用于删除指定带宽管理规则。请求及响应参数宜包含表中参数：
表25 删除指定带宽管理规则
7.2.1.6 增量更新带宽管理规则
该接口用于增量更新指定带宽管理规则。请求及响应参数宜包含表中参数：
表26 更新指定带宽管理规则
7.3 位置服务接口
7.3.1 UE 位置信息
7.3.1.1 查询 UE 的位置信息
该接口用于查询UE的位置信息。请求及响应参数宜包含表中参数：
表27 查询UE位置信息
7.3.1.2 订阅 UE 位置信息
该接口用于订阅UE位置信息。请求及响应参数宜包含表中参数：
表28 订阅UE位置信息
7.3.1.3 取消订阅 UE 位置信息
该接口用于取消订阅UE位置信息。请求及响应参数宜包含表中参数：
表29 取消订阅UE位置信息
7.4 UE 身份标识接口
7.4.1 UE 的标识
7.4.1.1 查询指定的 UE 标识信息
该接口用于查询指定的UE标识信息。请求及响应参数宜包含表中参数：
表30 查询指定的UE标识信息
7.4.1.2 注册/取消注册 UE 的标识信息
该接口用于注册/取消注册UE的标识信息。请求及响应参数宜包含表中参数：
表31 注册/取消注册UE的标识信息
7.5 应用移动服务接口
7.5.1 应用移动服务
7.5.1.1 新增应用移动服务信息
该接口用于新增应用移动服务信息。请求及响应参数宜包含表中参数：
表32 新增应用移动服务信息
7.5.1.2 查询所有应用移动服务信息
该接口用于查询所有应用移动服务信息。请求及响应参数宜包含表中参数：
表33 查询所有应用移动服务信息
7.5.1.3 查询指定应用移动服务信息
该接口用于查询指定应用移动服务信息。请求及响应参数宜包含表中参数：
表34 查询指定应用移动服务信息
7.5.1.4 更新应用移动服务信息
该接口用于更新应用移动服务信息。请求及响应参数宜包含表中参数：
表35 更新应用移动服务信息
7.5.1.5 删除应用移动服务信息
该接口用于删除应用移动服务信息。请求及响应参数宜包含表中参数：
表36 删除应用移动服务信息
7.5.2 应用移动服务事件
7.5.2.1 新增应用移动服务事件的通知订阅
该接口用于新增应用移动服务事件的通知订阅。请求及响应参数宜包含表中参数：
表37 新增应用移动服务事件的通知订阅
7.5.2.2 查询所有的应用移动服务事件的通知订阅
该接口用于查询所有的应用移动服务事件的通知订阅。请求及响应参数宜包含表中参数：
表38 查询所有的应用移动服务事件的通知订阅
7.5.3 应用移动服务订阅
7.5.3.1 查询指定的应用移动服务的订阅信息
该接口用于查询指定的应用移动服务的订阅信息。请求及响应参数宜包含表中参数：
表39 查询指定的应用移动服务的订阅信息
7.5.3.2 更新应用移动服务事件的通知订阅
该接口用于更新应用移动服务事件的通知订阅。请求及响应参数宜包含表中参数：
表40 更新应用移动服务事件的通知订阅
7.5.3.3 删除应用移动服务事件的通知订阅
该接口用于删除应用移动服务事件的通知订阅。请求及响应参数宜包含表中参数：
表41 删除应用移动服务事件的通知订阅
7.5.4 订阅事件通知
7.5.4.1 订阅事件通知到订阅方
该接口用于订阅事件通知到订阅方。请求及响应参数宜包含表中参数：
表42 订阅事件通知到订阅方
7.6 边缘智能接口
7.6.1 算力
7.6.1.1 查询处理器列表
该接口作用于查询处理器(包括GPU、CPU、FGPA、MPU等)的列表。 CPU查询
表43 查询CPU处理器列表的响应参数
GPU查询
表44 查询GPU处理器列表的响应参数
7.6.1.2 查询指定处理器详细信息
该接口作用于查询指定处理器的详细信息。请求参数及返回的响应参数宜包含表中参数：
表45 查询指定处理器详细信息的请求参数及响应参数
7.6.1.3 查询处理器占用情况和剩余空间
该接口作用于查询指定处理器的占用情况和剩余空间。返回的响应参数宜包含表中参数：
表46 查询处理器占用情况和剩余空间的响应参数
7.6.1.4 申请空闲处理器和限定显存
该接口作用于申请空闲处理器和限定显存。请求参数和返回的响应参数宜包含表中参数：
表47 申请空闲处理器和限定显存的请求参数及响应参数
7.6.1.5 释放对处理器和显存的占用
该接口作用于释放处理器和显存占用。返回的响应参数宜包含表中参数：
表48 释放处理器和显存占用的响应参数
7.6.1.6 查询内存(显存)占用和详细信息
该接口作用于查询内存/显存占用情况和详细信息。返回的响应参数宜包含表中参数：
表49 查询内存(显存) 占用的响应参数
7.6.1.7 申请内存(显存)占用
该接口作用于申请内存/显存占用。请求参数及返回的响应参数宜包含表中参数：
表50 申请内存(显存) 占用的请求参数及响应参数
7.6.1.8 释放内存(显存)占用
该接口作用于释放内存/显存占用。返回的响应参数宜包含表中参数：
表51 释放内存(显存) 占用的响应参数
7.6.2 模型
7.6.2.1 导入模型
该接口作用于导入可供边缘智场景能使用模型服务。请求参数及返回的响应参数宜包含表中参数：
表52 导入模型的响应参数
7.6.2.2 查询模型列表
该接口作用于查询可供边缘智能场景使用模型服务的列表。返回的响应参数宜包含表中参数：
表53 查询模板列表的响应参数
7.6.2.3 查询模型详情
该接口作用于查询指定模型服务的详细信息。请求参数及返回的响应参数宜包含表中参数：
表54 查询模板详情的请求参数及响应参数
7.6.2.4 删除模型
该接口作用于删除指定模型服务。返回的响应参数宜包含表中参数：
表55 删除模型的响应参数
7.6.3 算法
7.6.3.1 创建算法
该接口作用于创建算法。返回的响应参数宜包含表中参数：
表56 创建算法请求参数和响应参数表
7.6.3.2 查询算法列表
该接口作用于查询算法。返回的响应参数宜包含表中参数：
表57 查询算法请求参数和响应参数表
7.6.3.3 查询算法详情
该接口作用于查询算法。返回的响应参数宜包含表中参数：
表58 查询算法请求参数和响应参数表
7.6.3.4 更新算法
该接口作用于更新算法。返回的响应参数宜包含表中参数：
表59 更新算法请求参数和响应参数表
7.6.3.5 删除算法
该接口作用于删除算法。返回的响应参数宜包含表中参数：
表60 删除算法请求参数和响应参数表
7.7 边缘数据接口
7.7.1 数据采集
7.7.1.1 查询数据采集任务列表
该接口作用于查询数据采集任务的列表。请求和响应可包含表中参数：
表66 查询数据采集任务列表的示例参数
7.7.1.2 查询指定数据采集任务信息
该接口用于查询指定ID的数据采集任务的详细信息。请求和响应可包含表中参数：
表67 查询指定ID的数据采集任务的示例参数
7.7.1.3 创建数据采集任务
应用调用该接口创建数据采集任务。请求和响应可包含表中参数：
表68 创建数据采集任务的示例参数
7.7.1.4 删除数据采集任务
应用调用该接口删除数据指定的采集任务。该接口的请求消息及应答消息所携带的参数如表所示。
表69 删除数据采集任务的参数
7.7.2 数据预处理
7.7.2.1 查询数据预处理任务列表
该接口用于查询数据预处理任务列表。返回的响应参数宜包含表中参数：
表70 查询数据预处理任务列表的响应参数
7.7.2.2 查询指定数据预处理任务信息
该接口用于查询指定ID的数据预处理任务的详细信息。返回的响应参数宜包含表中参数：
表71 查询指定ID的数据预处理任务的响应参数
7.7.3 协议转换
7.7.3.1 查询协议转换任务列表
该接口用于查询协议转换任务列表。返回的响应参数宜包含表中参数：
表72 查询协议转换任务列表的响应参数
7.7.3.2 查询指定协议转换任务信息
该接口用于查询指定ID的协议转换任务的详细信息。返回的响应参数宜包含表中参数：
表73 查询指定ID的协议转换任务的响应参数
7.7.4 数据转发
7.7.4.1 查询数据转发任务列表
该接口用于查询数据转发任务列表。返回的响应参数宜包含表中参数：
表74 查询数据转发任务列表的响应参数
7.7.4.2 查询指定数据转发任务信息
该接口用于查询指定ID的数据转发任务的详细信息。返回的响应参数宜包含表中参数：
表75 查询指定ID的数据转发任务的响应参数
7.7.5 数据分析
7.7.5.1 查询数据分析规则列表
该接口用于查询数据分析规则列表。返回的响应参数宜包含表中参数：
表76 查询数据分析规则列表的响应参数
7.7.5.2 查询指定数据分析规则详细信息
该接口用于查询指定ID的数据分析规则的详细信息。返回的响应参数宜包含表中参数：
表77 查询指定ID的数据分析规则的响应参数
7.8 边缘运维接口
7.8.1 设备管理
7.8.1.1 添加设备
应用调用该接口添加要进行管理的设备。该接口的请求消息及应答消息所携带的参数如表所示。
表78 添加设备接口的参数
7.8.1.2 删除设备
应用调用该接口删除要进行管理的设备。该接口的请求消息及应答消息所携带的参数如表所示。
表79 删除设备接口的参数
7.8.1.3 查看设备列表
该接口用于查询设备列表。返回的响应参数宜包含表中参数：
表80 查询设备列表的响应参数
7.8.1.4 查看指定设备信息
该接口作用于查询边缘平台下挂设备的列表。请求参数及返回的响应参数宜包含表中参数：
表81 查看指定设备信息的请求参数及响应参数
7.8.1.5 查看指定设备统计信息
该接口用于查询指定边缘设备的统计信息。请求/响应参数宜包含表中参数：
表82 查看指定设备统计信息的接口参数
7.8.2 消息订阅
7.8.2.1 查看订阅列表
该接口作用于查询消息订阅列表。返回的响应参数宜包含表中参数：
表83 查看消息订阅列表的响应参数
7.8.2.2 查看指定订阅话题(节点)及历史消息
该接口作用于查询指定订阅话题(节点)及历史消息。请求参数及返回的响应参数宜包含表中参数：
表84 查看指定订阅话题(节点)及历史消息的请求参数及响应参数
7.8.3 日志管理
7.8.3.1 查询设备日志列表
该接口用于查询设备日志列表。返回的响应参数宜包含表中参数：
表85 查询设备日志列表的响应参数
7.8.3.2 查询设备指定日志详细信息
该接口用于查询指定ID的设备日志的详细信息。返回的响应参数宜包含表中参数：
表86 查询指定ID的设备日志的响应参数
7.8.3.3 查询系统日志列表
该接口作用于查询系统日志详细信息。返回的响应参数宜包含表中参数：
表87 查询系统日志列表的响应参数
7.8.3.4 查询指定系统日志详细信息
该接口作用于查询指定系统的日志详细信息。请求参数及返回的响应参数宜包含表中参数：
表88 查询指定系统日志详细信息的请求参数及响应参数
7.8.3.5 查询应用日志列表
该接口作用于查询应用的日志列表。请求参数及返回的响应参数宜包含表中参数：
表89 查询应用日志列表的响应参数
7.8.4 设备网络
7.8.4.1 新增工业设备网络
该接口作用于新增工业设备网络。请求参数及返回的响应参数宜包含表中参数：
表91 新增工业设备网络的请求参数及响应参数
7.8.4.2 删除工业设备网络
该接口作用于删除工业设备网络。请求参数及返回的响应参数宜包含表中参数：
表92 删除工业设备网络的请求参数及响应参数
7.8.4.3 查询所有工业设备网络
该接口作用于查询所有工业设备网络。返回的响应参数宜包含表中参数：
表93 查询所有工业设备网络的响应参数
7.8.4.4 查询指定工业设备网络
该接口作用于查询指定工业设备网络的详细信息。请求参数及返回的响应参数宜包含表中参数：
表94 查询指定工业设备网络的请求参数及响应参数
7.8.4.5 更新工业设备网络
该接口作用于更新工业设备网络。请求参数及返回的响应参数宜包含表中参数：
表95 更新工业设备网络的响应参数
7.9 边缘应用管理接口
7.9.1 应用管理
7.9.1.1 查询可安装应用列表
该接口用于查询可供边缘设备安装的应用列表。请求/响应参数宜包含表中参数：
表96 查询可供设备安装的的应用列表的接口参数
7.9.1.2 查询指定应用配置信息
该接口用于查询指定应用的配置列表。请求/响应参数宜包含表中参数：
表97 查询指定应用配置列表的接口参数
7.9.1.3 查看平台安装的应用列表
该接口用于查询指定边缘设备上安装的应用程序列表。请求/响应参数宜包含表中参数：
表98 查看指定设备安装的应用列表的接口参数
7.10 边缘存储接口
7.10.1 存储服务
7.10.1.1 新增存储服务
该接口用于新增存储服务，请求参数和响应参数参见表：
表104 新增存储服务请求参数和响应参数
7.10.1.2 删除存储服务
该接口用于删除存储服务，请求参数和响应参数参见表：
表105 删除存储服务请求参数和响应参数
7.10.1.3 修改存储服务
该接口用于删除存储服务，请求参数和响应参数参见表：
表106 删除存储服务请求参数和响应参数
7.10.1.4 查询存储服务
该接口用于删除存储服务，请求参数和响应参数参见表：
表107 删除存储服务请求参数和响应参数
评论