资产服务概述


资产是模型的实例。资产可以是一个设备:如电表;也可以是一组设备的物理或逻辑组合:如光伏电站、某个包含多个资产的区域。通过资产服务的接口,可更新与获取资产信息。有关模型与资产的更多信息,参见 连接与资产管理服务


资产服务中的接口是一些 EnOS 开放涵盖系统各个核心业务流程的 Open API 接口。有关 EnOS API 和 EnOS 提供的接口详细信息,参见 有关 EnOS API


有关如何调用 EnOS API 的信息,参见 EnOS API 快速入门

开始前准备


  • 已获取用于身份授权的服务账号。更多信息,参见 管理服务账号

  • 服务账号已取得系统中相关服务的访问权限。详见具体 API 文档的 操作权限 部分。

  • 确保已阅读资产的 使用限制

API 列表

操作名称

描述

URL

适用于 EnOS Cloud

适用于 EnOS Edge

Get Asset

根据资产 ID 获取资产数据

/asset-service/v2.1/assets?action=get

Update Asset

全量或部分更新资产信息

/asset-service/v2.1/assets?action=update

×

Create Logical Asset

创建一个逻辑资产

/asset-service/v2.1/logical-assets?action=create

×

Update Logical Asset

更新全部或部分逻辑资产的信息

/asset-service/v2.1/logical-assets?action=update

×

Delete Logical Asset

删除指定的逻辑资产

/asset-service/v2.1/logical-assets?action=delete

×

API 版本


下表列出资产服务企业版与轻量版包含的 API 服务。

操作名称

企业版

轻量版

Get Asset

Update Asset

Create Logical Asset

Update Logical Asset

Delete Logical Asset

SDK 示例


你可以在 Github 上获取资产服务 API 的 SDK 示例: