API 变更


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

EnOS 语义 API


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

通用数据服务


API 名称 描述 适用于 EnOS Cloud 适用于 EnOS Edge
Query Accessible Asset Type 、Query Accessible Asset 、 Query Asset Attribute 、Query Asset Hierarchy 、Query Asset Topology 和 Query Asset Topology Rule 查询资产数据时可根据调用方的资产权限来控制可获取的资产信息范围。 √ √
Query Asset Hierarchy 在请求参数 filter 和 orderBy 中指定 name 字段的值时，支持指定国际化内容。 √ √
Query Meta Measurement Point 新增请求参数 applyDataFilter，指定是否需要在返回结果中过滤无数据上送的资产。 √ √
Query Meta Metric 新增请求参数 withSourceMetric，指定是否需要获取原始指标元数据。 √ √
Query Latest Measurement Point 支持在请求参数 filter 和 orderBy 中指定 attributes 中的字段，按照属性过滤和排序返回结果中的测点。 √ √

EnOS 通用 API


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

应用门户服务


API 名称 描述 适用于 EnOS Cloud 适用于 EnOS Edge
Log in via Authorization Code 、Choose Organization 新增 channel 请求参数，用于在“审计记录”中显示用户的登录来源，如通过网页端登录或通过移动端登录。 √ √
Get Organization User List
  • 新增 userIDs 请求参数，用于通过 ID 筛选用户信息。
  • 新增以下响应参数：
    • createdTime，用户账号的创建时间
    • joinTime，用户加入组织的时间
    • company，用户的公司
    • depart，用户的部门
    • position，用户的职位
    • nickname，用户的昵称
    • domain，用户所属的域
 √ √
Get Asset by Organization 、Get Users Asset List
  • 新增 type 响应参数，表示资源的类型。
  • 新增 typeName 响应参数，表示资源类型的名称。
 √ √
Get User Base Info
新增以下响应参数：
  • company，用户的公司
  • depart，用户的部门
  • position，用户的职位
 √ √
Get Assets by Application 、Get Structure Detail 新增 needAssociateAsset 请求参数，用于指定是否返回关联到组织结构节点的资源。 √ √