资产树服务概述¶
资产树服的接口提供对资产树、资产节点、资产路径的管理操作。有关资产树的信息，参见 资产树概览。
资产树服务中的接口是一些 EnOS 开放涵盖系统各个核心业务流程的 Open API 接口。有关 EnOS API 和 EnOS 提供的接口详细信息，参见 有关 EnOS API。
有关如何调用 EnOS API 的信息，参见 EnOS API 快速入门。
开始前准备¶
确保已阅读资产树的使用限制。参见 使用限制。
API 列表¶
资产树¶
操作名称 |
描述 |
URL |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|---|
创建一棵资产树，并同时创建该资产树的根节点 |
/asset-tree-service/v2.1/asset-trees?action=create |
√ |
× |
|
创建一棵资产树，并关联一个已有的资产作为其根节点 |
/asset-tree-service/v2.1/asset-trees?action=associate |
√ |
× |
|
删除一个资产树 |
/asset-tree-service/v2.1/asset-trees?action=delete |
√ |
× |
|
获取资产树信息 |
/asset-tree-service/v2.1/asset-trees?action=get |
√ |
√ |
|
根据 tags 搜索符合条件的资产树 |
/asset-tree-service/v2.1/asset-trees?action=search |
√ |
√ |
|
更新资产树的信息 |
/asset-tree-service/v2.1/asset-trees?action=update |
√ |
× |
资产树节点¶
操作名称 |
描述 |
URL |
适用于 EnOS Cloud |
适用于 EnOS Edge |
|---|---|---|---|---|
将指定已有资产节点关联到资产树上 |
/asset-tree-service/v2.1/asset-nodes?action=associateAsset |
√ |
× |
|
将指定已有资产节点批量关联到资产树上 |
/asset-tree-service/v2.1/asset-nodes?action=associateAssetBatch |
√ |
× |
|
创建一个逻辑资产，并关联到资产树上 |
/asset-tree-service/v2.1/asset-nodes?action=createAsset |
√ |
× |
|
移动一个资产节点连同其后代节点到一个指定的位置 |
/asset-tree-service/v2.1/asset-nodes?action=move |
√ |
× |
|
从资产树上移除一个资产节点 |
/asset-tree-service/v2.1/asset-nodes?action=delete |
√ |
× |
|
根据一组资产 ID 搜索资产所在的资产树 |
/asset-tree-service/v2.1/asset-nodes?action=getAssetTree |
√ |
√ |
|
查询满足条件的资产 |
/asset-tree-service/v2.1/asset-nodes?action=searchAsset |
√ |
√ |
|
查询指定资产树上的资产 |
/asset-tree-service/v2.1/asset-nodes?action=searchRelatedAsset |
√ |
√ |
|
查询资产树上符合条件的路径 |
/asset-tree-service/v2.1/asset-paths?action=search |
√ |
√ |
API 版本¶
下表列出资产树服务企业版与轻量版包含的 API 服务。
操作名称 |
企业版 |
轻量版 |
|---|---|---|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
|
√ |
√ |
SDK 示例¶
你可以在 Github 上获取资产树服务 API 的 SDK 示例：