Asset Service Overview¶
An asset is an instance of a model. An asset can be a device, such as a meter. It can also be a physical or logical combination of a group of devices, such as a photovoltaic power plant, or an area where there are multiple assets. With the asset service APIs, you can update and get information for these assets. For more information on models and assets, see Device Connectivity & Management Service.
The APIs in the asset service are some of the APIs EnOS provides that cover the core business processes of the system. For more information on EnOS APIs and the different APIs that EnOS provides, see About EnOS API.
For more information on how to invoke EnOS APIs, see Get Started with EnOS API.
Prerequisites¶
Ensure that you have read the limitations for logical assets. See Limitations.
API List¶
Refer to the table below for the list of APIs, and whether they can be used by EnOS Cloud and EnOS Edge.
| Operation Name | Description | URL | EnOS Cloud | EnOS Edge |
|---|---|---|---|---|
| Get Asset | Get asset data by Asset ID | /asset-service/v2.1/assets?action=get | √ | √ |
| Update Asset | Update asset information | /asset-service/v2.1/assets?action=update | √ | × |
| Create Logical Asset | Create a logical asset | /asset-service/v2.1/logical-assets?action=create | √ | × |
| Update Logical Asset | Update all or selected details of a logical asset | /asset-service/v2.1/logical-assets?action=update | √ | × |
| Delete Logical Asset | Delete a specified logical asset | /asset-service/v2.1/logical-assets?action=delete | √ | × |
API Editions¶
The following table lists the API services included in Asset Service Enterprise and Lightweight editions.
| Operation Name | Enterprise | Lightweight |
|---|---|---|
| Get Asset | √ | √ |
| Update Asset | √ | √ |
| Create Logical Asset | √ | √ |
| Update Logical Asset | √ | √ |
| Delete Logical Asset | √ | √ |