API 变更


该部分介绍在 EnOS 2.4.2 中的 API 行为变更。

EnOS 语义 API


以下为 EnOS 2.4.2 中语义 API 的变更。

通用数据服务


API 名称

描述

适用于 EnOS Cloud

适用于 EnOS Edge

Query Accessible Asset TypeQuery Accessible AssetQuery Asset AttributeQuery Asset HierarchyQuery Asset TopologyQuery Asset Topology Rule

查询资产数据时可根据调用方的资产权限来控制可获取的资产信息范围。

Query Asset Hierarchy

在请求参数 filterorderBy 中指定 name 字段的值时,支持指定国际化内容。

Query Meta Measurement Point

新增请求参数 applyDataFilter,指定是否需要在返回结果中过滤无数据上送的资产。

Query Meta Metric

新增请求参数 withSourceMetric,指定是否需要获取原始指标元数据。

Query Latest Measurement Point

支持在请求参数 filterorderBy 中指定 attributes 中的字段,按照属性过滤和排序返回结果中的测点。

EnOS 通用 API


以下为 EnOS 2.4.2 中通用 API 的变更。

应用门户服务


API 名称

描述

适用于 EnOS Cloud

适用于 EnOS Edge

Log in via Authorization CodeChoose Organization

新增 channel 请求参数,用于在“审计记录”中显示用户的登录来源,如通过网页端登录或通过移动端登录。

Get Organization User List

  • 新增 userIDs 请求参数,用于通过 ID 筛选用户信息。

  • 新增以下响应参数:
    • createdTime,用户账号的创建时间

    • joinTime,用户加入组织的时间

    • company,用户的公司

    • depart,用户的部门

    • position,用户的职位

    • nickname,用户的昵称

    • domain,用户所属的域

Get Asset by OrganizationGet Users Asset List

  • 新增 type 响应参数,表示资源的类型。

  • 新增 typeName 响应参数,表示资源类型的名称。

Get User Base Info

新增以下响应参数:
  • company,用户的公司

  • depart,用户的部门

  • position,用户的职位

Get Assets by ApplicationGet Structure Detail

新增 needAssociateAsset 请求参数,用于指定是否返回关联到组织结构节点的资源。