资产服务 API 概述¶
资产是模型的实例。资产可以是一个设备：如电表；也可以是一组设备的物理或逻辑组合：如光伏电站、某个包含多个资产的区域。
通过资产服务 API，资产管理员可以创建、管理、更新组织内资产的详细信息。关于资产服务 API 的完整接口列表及功能说明，参见 API 列表。
前提条件¶
确保已获取服务账号，且服务账号拥有调用该 API 的权限。更多信息，参见 获取 API 调用权限。
确保已阅读资产的 使用限制。
API 列表
¶
你可以通过下表了解可以调用资产服务 API 执行哪些操作，每项操作对应的 URL，以及是否适用于 EnOS Cloud 和 EnOS Edge。
操作名称 |
描述 |
URL |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|---|
根据资产 ID 获取资产数据 |
/asset-service/v2.1/assets?action=get |
√ |
√ |
|
全量或部分更新资产信息 |
/asset-service/v2.1/assets?action=update |
√ |
× |
|
创建一个逻辑资产 |
/asset-service/v2.1/logical-assets?action=create |
√ |
× |
|
更新全部或部分逻辑资产的信息 |
/asset-service/v2.1/logical-assets?action=update |
√ |
× |
|
删除指定的逻辑资产 |
/asset-service/v2.1/logical-assets?action=delete |
√ |
× |
SDK 示例¶
你可以在 Github 上获取资产服务 API 的 SDK 示例：