Get Plugload Controller Energy Consumption API¶
The API returns managed and unmanaged energy consumed in watt-hour for the last 15 minutes by the Plug Load Controller (PLC).
For example, if the request has been sent between 10:05:00 and 10:19:59 am, energy data is sent for the period from 9:45 to 10:00 am. Likewise, if the request is between 10:20:00 and 10:34:59, data is sent for the period from 10:00 to 10:15 am. The data is aggregated from the PLC at 5-minute intervals and is rounded to the nearest last 15-minute interval set.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/plugload/v1/energy/{plugload_id}
Parameters¶
| Name | Description |
|---|---|
| Request | |
em_ip_address_or_hostname | The Manage IP address or hostname. |
plugload_id | Plug Load identifier. Use the PLC ID returned in the Get All Plugloads by Floor API, or in Enlighted Manage, select Facility > Floor in the left panel, Floor Plan tab, and double-click the Plug Load icon on the floor plan to obtain the Plug Load ID. |
| Response | |
managed-energy | Reports managed energy consumption in watt-hour by the PLC. |
unmanaged-energy | Reports unmanaged energy consumption in watt-hour by the PLC. |
Sample Request¶
Send a request to the EM using the Plug Load ID ‘361’ returned by the Get All Floors API to return the energy consumed in watt-hour for the last 15 minutes by the PLC.
GET https://192.80.3.2/ems/api/org/plugload/v1/energy/46
Sample Response¶
{
"managed-energy": "50.96",
"unmanaged-energy": "5.4"
}