模型服务 API 概述¶
模型是对物理世界中的实体对象的抽象与数字化。模型通过定义资产的特征和行为,将物理世界与数字平台连接起来,支持数据管理与应用开发。
通过模型服务 API,设备接入和管理人员可以查询、更新模型,获取模型详细信息。关于模型服务 API 的完整接口列表及功能说明,参见 API 列表。
备注
在 EnOS 模型管理 中创建模型时,只有 模型用途 为 设备接入 的模型,才能在 EnOS 设备连接与管理中用于设备接入,才能通过模型服务 API 进行查询和更新。
前提条件¶
确保当前 OU 已存在模型用途为 设备接入 的模型。
确保已获取服务账号,且服务账号拥有调用该 API 的权限。更多信息,参见 获取 API 调用权限。
确保已阅读模型的使用限制。参见 使用限制。
API 列表
¶
你可以通过下表了解可以调用模型服务 API 执行哪些操作,每项操作对应的 URL,以及是否适用于 EnOS Cloud 和 EnOS Edge。
操作名称 |
描述 |
URL |
适用于 EnOS Cloud |
适用于 EnOS Edge |
---|---|---|---|---|
根据 modelId 获取模型 |
/model-service/v2.1/thing-models?action=get |
√ |
√ |
|
搜索模型 |
/model-service/v2.2/thing-models?action=search |
√ |
√ |
|
更新模型 |
/model-service/v2.1/thing-models?action=update |
√ |
× |
SDK 示例¶
你可以在 Github 上获取模型服务的 SDK 示例: