Cisco Evolved Programmable Network Manager API
Evolved Programmable Network Manager API Documentation

GET maps/{mapId}/rogueAps

Returns list of Rogue access points from the specified site map. This operation is supported only for floor and outdoor area.

Since Product Version: 3.7

Resource Information

Rate Limiting?

No

Sorting?

No

Paging?

No

Filtering?

No

Group Filtering?

No

Aggregation?

No

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Resource URL

/webacs/api/v4/op/maps/{mapId}/rogueAps

Request Parameters

Attribute Source Description

mapId Long

path

Required

Id of the site map

Response Parameters

Attribute Description

coordinates Arrow image CoordinatesDTO

Coordinates of the rogue access point relative to the upper left corner of site map in feets.

macAddress MacAddress

MAC address of the rogue access point

reportedBy String

Name of the location service reported the rogue

reporterType MobilityServiceTypeEnum

Type of the location service reported the rogue

  • MSE
  • CMX

Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

Sample XML Response Payload

https://172.20.127.108/webacs/api/v4/op/maps/123123/rogueAps

<?xml version="1.0" ?>
<mgmtResponse responseType="operation" requestUrl="https://172.20.127.108/webacs/api/v4/op/maps/123123/rogueAps" rootUrl="https://172.20.127.108/webacs/api/v4/op">
  <rogueAccessPointDTO>
    <coordinates>
      <XCoordinate>15.0</XCoordinate>
      <YCoordinate>15.0</YCoordinate>
      <ZCoordinate>15.0</ZCoordinate>
    </coordinates>
    <macAddress>
      <octets>000a959d6816</octets>
    </macAddress>
    <reportedBy>String value</reportedBy>
    <reporterType>MSE</reporterType>
  </rogueAccessPointDTO>
  <rogueAccessPointDTO>
    <coordinates>
      <XCoordinate>25.0</XCoordinate>
      <YCoordinate>25.0</YCoordinate>
      <ZCoordinate>25.0</ZCoordinate>
    </coordinates>
    <macAddress>
      <octets>000a959d6817</octets>
    </macAddress>
    <reportedBy>Another string value</reportedBy>
    <reporterType>CMX</reporterType>
  </rogueAccessPointDTO>
</mgmtResponse>

Sample JSON Response Payload

https://172.20.127.108/webacs/api/v4/op/maps/123123/rogueAps.json

{
  "mgmtResponse" : {
    "@requestUrl" : "https://172.20.127.108/webacs/api/v4/op/maps/123123/rogueAps",
    "@responseType" : "operation",
    "@rootUrl" : "https://172.20.127.108/webacs/api/v4/op",
    "rogueAccessPointDTO" : [ {
      "coordinates" : {
        "XCoordinate" : 15.0,
        "YCoordinate" : 15.0,
        "ZCoordinate" : 15.0
      },
      "macAddress" : {
        "octets" : "000a959d6816"
      },
      "reportedBy" : "String value",
      "reporterType" : "MSE"
    }, {
      "coordinates" : {
        "XCoordinate" : 25.0,
        "YCoordinate" : 25.0,
        "ZCoordinate" : 25.0
      },
      "macAddress" : {
        "octets" : "000a959d6817"
      },
      "reportedBy" : "Another string value",
      "reporterType" : "CMX"
    } ]
  }
}