Get All Plugloads by Area¶
The API returns plugload location for all plugloads in an area. The data is returned as X, Y coordinates of the measured and scaled-down distance from the lower-left corner of the uploaded floor plan.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/plugload/v1/location/list/area/{area_id}/1
Parameters¶
Request¶
Name | Description |
---|---|
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 Area ID. |
Response¶
Name | Description |
---|---|
id | Plugload identifier. |
xaxis | Scaled measurement of distance in the horizontal dimension from the lower-left corner of the uploaded floor plan. |
yaxis | Scaled measurement of distance in the vertical dimension from the lower-left corner of the uploaded floor plan. |
macaddress | Plugload MAC address. NOTE: Manage does not store leading zeros when saving or returning MAC/SNAP addresses. For example, "00:c0:17" will be stored as "0:c0:17”. |
groupid | Profile group identifier. The ID of the profile associated with the plugload. |
Sample Request¶
For example, the Get All Areas API returned two areas: Hardware area with ID ‘9’ and Software area with ID ‘27’. Request the EM for the x- and y- coordinates of the scaled-down distance of the floor plan for all plugloads in the area with area ID ‘9’.
GET https://192.80.3.2/ems/api/org/plugload/v1/location/list/area/9/1
Sample Response¶
{
"plugload": [
{
"id": "361",
"name": "Plugload00c017",
"status": "0",
"xaxis": "966",
"yaxis": "391",
"macaddress": "0:c0:17",
"groupid": "185",
},
{
"id": "1364",
"name": "Plugload0629dd",
"status": "1",
"xaxis": "270",
"yaxis": "90",
"macaddress": "6:29:dd",
"groupid": "196",
},
{
"id": "835",
"name": "Plugload013ec0",
"status": "0",
"xaxis": "756",
"yaxis": "462",
"macaddress": "1:3e:c0",
"groupid": "55",
}
]
}