Get Plugload Energy Consumption by Area

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

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 > Area in the left panel, and click the Settings tab to get the Area 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 Code

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

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT
{
  "managed-energy": "150.96"
  "unmanaged-energy": "15.4"
}
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Article is closed for comments.