• 文档
• 版本发行说明
• 行为变更

行为变更

该部分介绍了在本次发布中产品及服务的行为变更。

API

有关API的行为变更详情，登录EnOS管理门户，从导航菜单中点击 EnOS API > 更新说明。

模型服务

API名称	更新内容
Search Thing Model	请求参数（URI）中的查询表达式（expression）所支持的查询字段 tags 新增支持算术运算符exists和not exists。

接入服务

API名称	更新内容
Get Device	Device结构体中新增四个参数： measurepointLastUpdate、eventLastUpdate、attributeLastUpdate 、和 featureLastUpdate，用以表示设备的最近更新时间。
Search Device	请求参数（Body）中的查询表达式（expression）新增支持查询 deviceTags 字段。
Search Product	请求参数（Body）中的查询表达式（expression）新增支持查询 productTags 字段。

告警服务

API名称	更新内容
Create Alert Rule	请求参数（Body）中新增参数 triggeringDelayTimer， 用于设定延后告警触发时间。
Search Active Alert	响应参数 ActiveAlert 结构体中的参数 value 支持记录 triggeringDelayTimer 开始计时时测点的值。请求参数（Body）中的查询表达式（expression）所支持的查询字段 tag 新增支持算术运算符exists和not exists。
Search Alert Rule	响应参数 AlertRule 结构体中新增参数 triggeringDelayTimer，表示告警被延后触发的时间。
Search History Alert	功能变更为查询**最近三个月内**的历史告警。响应参数 HistoryAlert 结构体中的参数 value 支持记录 triggeringDelayTimer 开始计时时测点的值。请求参数（Body）中的查询表达式（expression）所支持的查询字段 tag 新增支持算术运算符exists和not exists。
Update Alert Rule	请求参数（Body） alertRule 结构体中新增参数 triggeringDelayTimer， 用于设定延后告警触发时间。
Aggregate Active Alerts	请求参数（Body）中的查询表达式（expression）所支持的查询字段 tag 新增支持算术运算符exists和not exists。

资产树服务

API名称	更新内容
Search Asset Node	在请求参数（Body）中，新增 expression 参数，代替原先的`filter`参数。

TSDB数据服务

API名称	更新内容
Get Asset AI Raw Data	在请求参数（URI）中，新增 withQuality 参数，用于获取数据质量位。
Get Asset Generic Data	在请求参数（URI）中，新增 withQuality 参数，用于获取数据质量位。
Get Asset Raw Data by Time Range	在请求参数（URI）中，新增 withQuality 参数，用于获取数据质量位。
Get Asset DI Data	DI数据获取接口增加首值插补功能。若查询起始时间点无数据，则向前追溯查询30天内的最后一个状态值，并使用查询起始时间的时间戳返回数据。
Get Asset Raw Data by Time Range	请求参数新增 orderBy，用于将返回结果按照某字段排序

EnOS Edge

服务/功能模块	变更前	变更后	影响分析
模板配置	无法让某个测点相关的数据不上传到EnOS Cloud	可以在上送模式中选择该测点相关数据不上送到EnOS Cloud	需要在 EnOS Edge > 模板配置 > 模板编辑 > 点映射 中设置
模板配置	测点只能使用系统的时间戳	支持优先使用OEM时间戳，如果没有OEM时间戳，则使用系统时间戳	需要在 EnOS Edge > 模板配置 > 模板编辑 > 点映射 中设置
DPF	用户无法对接入数据、即活动状态字进行去重复处理	支持用户对接入数据、即活动状态字，进行去重复处理	N/A
DPF	只支持接收测点的系统时间戳	支持接收测点的OEM时间戳	N/A

设备接入

一型一密认证协议优化

更新前	更新后
EnOS向设备颁发 deviceSecret 后，不管设备有没有通过该 deviceSecret 进行激活，不再颁发 deviceSecret。	EnOS向设备颁发 deviceSecret 后，如果设备尚未携带该 deviceSecret 进行激活，则设备仍然可以在此申请和获取 deviceSecret。该改进主要应用于 deviceSecret 遗失的场景。

搜索功能变更

服务/功能模块	变更前	变更后
产品管理	用户只能通过Product key搜索设备	支持通过模型和产品名称进行搜索
设备管理	用户只能通过Device key搜索设备	用户可以通过模型筛选、再通过Device key、Asset ID、设备名称搜索设备
资产树	只支持通过Device key和模型精确搜索	支持通过Device key和模型进行模糊搜索

其他功能变更

服务/功能模块	变更前	变更后	影响分析
模型管理、产品管理、设备管理、资产树	模型、产品、设备、资产树、资产的名称对特殊符号仅支持连字符（ - ）、下划线（ _ )、英文句号（.）和英文冒号（:）	模型、产品、设备、资产树、资产的名称增加对正斜杠（/）、星号（*）、加号（+）、井号（#）、空格（ ）的支持	无
设备管理	用户只能通过模型、设备名称、Device Key、Asset ID来搜索设备	支持用户通过产品搜索并批量导出设备	无
设备管理	用户必须逐个定义设备模拟器数据样本，逐个启停、删除设备模拟器	支持为同类模型的设备批量定义数据样本，批量启停、删除模拟器	无
设备管理、资产管理	设备、资产、资产树信息分开存储。使用API搜索设备和资产信息，搜索的数据量大时，体验不佳	将设备信息（Product key、Device key、设备状态等）、资产（Asset ID、根据模型定义的属性等）以及资产所在资产树信息存储在单一源。并提升了`Search Device`、`Search Asset Node`API的搜索性能，在搜索结果数据量较大时，用户体验更好。	无
告警服务	用户必须逐条创建告警级别、类型、内容、规则	支持通过编辑模板并上传的方式批量创建告警级别、类型、内容、规则，单次最多导入10000条	无
告警服务	用户必须通过告警内容、规则的编号来搜索内容、规则	新增支持通过模型搜索告警内容、规则，并在搜索结果中选择规则批量导出	无

数据资产管理

流数据处理

• 从本次发布起，AI窗口聚合模板 更名为 时间窗口聚合模板，支持所有数值类型数据的聚合处理。

数据清理

TSDB数据清理任务，增加了“清理失败”状态。数据清理任务运行失败后，可点击 操作 列中的 重新执行 图标重启任务，但已清理的数据无法恢复。

应用使能

API管理

• 新增API挂载流程中断退出信息提示。

• 删除了返回参数的信息框。

• 在API批量导入过程中，导入API组文件后，APIM自动判断导入的API是否已存在，已存在的API将不会被导入，提高API迁移效率。

企业容器平台

• 原 EnOS服务托管中心 更名为 企业容器平台。详见 企业容器平台。

• 新建应用时，容器 Deployment 和 Stateful Set 二者只能选择创建其中一种，不可同时创建。

• 新建 Deployment 和 Stateful Set 时，资源限额 的 CPU最大值 与 Memory最大值 的默认值修改为“1.0核”与“1.0G”。

• 新建 Storage 容器时，最大文件数 改为1000万。

• 新建流水线时，镜像仓库地址 默认被选定。

• 服务目录中密码显示操作优化，新建密码规则修改，支持英文大小写，数字和!@#$%^&*/-，编辑时不展示密码。

• 新建 Service 时，类型 被默认选定。

• 新建 Redis、Mongo、MySQL 时，类型 被默认选定。

• Redis、Mongo、MySQL 在完成健康检查之前不显示 Pod IP。