Skip to content

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

NameDescription
em_ip_address_or_hostnameThe Manage IP address or hostname.
area_idArea 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

NameDescription
idPlugload identifier.
xaxisScaled measurement of distance in the horizontal dimension from the lower-left corner of the uploaded floor plan.
yaxisScaled measurement of distance in the vertical dimension from the lower-left corner of the uploaded floor plan.
macaddressPlugload 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”.
groupidProfile 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",
    }
  ]
}