Asset Service API 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.

Through the Asset Service API, asset administrators can create, manage, and update detailed information about assets within the organization, See API List。

Prerequisites¶

Ensure that you have obtained a service account, and the service account has the permission to call the Asset Service APIs. For more information, see Getting API Calling Permissions。
Ensure that you have read the limitations for logical assets. See Limitations.

API List ¶

You can learn from the table below which operations can be performed by calling the Asset Service API, the corresponding URLs for each operation, and whether they apply to 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	√	×

SDK Samples¶

You can access the SDK samples for Asset Service on GitHub:

Java
Python