Get Plugload Energy Consumption by Area API¶
Returns the aggregate managed and unmanaged energy consumed in watt-hour by all plugloads in the area for the last 15 minutes.
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 all plugloads 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/area/{area_id}
Parameters¶
| Name | Description |
|---|---|
| Request | |
em_ip_address_or_hostname | The Manage IP address or hostname. |
area_id | Area Identifier. Use the Area ID returned in the Get All Areas API, or in EM, select Facility > Floor in the left panel, and click the Settings tab to obtain the Floor ID. |
| Response | |
managed energy | Reports aggregate managed energy consumption in watt-hour by all the plugloads in the area. |
unmanaged energy | Reports aggregate unmanaged energy consumption in watt-hour by all the plugloads in the area. |
Sample Request¶
Send a request to the EM using Area ID '9' returned by the Get All Areas API to return the energy consumed in watt-hour for the last 15 minutes by all plugloads in the area.
GET https://192.80.3.2/ems/api/org/plugload/v1/energy/area/9
Sample Response¶
{
"managed-energy": "150.96",
"unmanaged-energy": "15.4"
}