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

GET RFStats

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Represents the latest statistics information for radio interfaces of lightweight wireless access points collected from WLAN controllers.

Since Product Version: 1.2

Resource URL

/webacs/api/v1/data/RFStats

Response Parameters

Type Attribute Name Description

ChannelNumberEnum

channelNumber

Channel number that the radio is operating on

Allowed values:

  • UNKNOWN
  • _1
  • _2
  • _3
  • _4
  • _5
  • _6
  • _7
  • _8
  • _9
  • _10
  • _11
  • _12
  • _13
  • _14
  • _20
  • _21
  • _22
  • _23
  • _24
  • _25
  • _26
  • _34
  • _36
  • _38
  • _40
  • _42
  • _44
  • _46
  • _48
  • _52
  • _56
  • _60
  • _64
  • _100
  • _104
  • _108
  • _112
  • _116
  • _120
  • _124
  • _128
  • _132
  • _136
  • _140
  • _144
  • _149
  • _153
  • _157
  • _161
  • _165
  • _169
  • _173

int

channelUtilization

Channel Utilization (%)

int

clientCount

Number of associated clients

String

collectionTime

The time collection of this record was finished, measured in milliseconds since the Unix epoch.

RFProfileEnum

coverageProfile

Allowed values:

  • FAILED
  • PASSED

String

ethernetMac

MAC address of the ethernet interface on the AP

String

instanceUuid

This is a uuid for this instance.

RFProfileEnum

interferenceProfile

Interference profile

Allowed values:

  • FAILED
  • PASSED

RFProfileEnum

loadProfile

Load profile

Allowed values:

  • FAILED
  • PASSED

String

macAddress

Base radio MAC address

RFProfileEnum

noiseProfile

Noise profile

Allowed values:

  • FAILED
  • PASSED

RadioOperStatusEnum

operStatus

Operational Status

Allowed values:

  • DOWN
  • UP
  • NOTASSOCIATED
  • UNKNOWN

int

poorCoverageClients

Poor coverage clients

int

powerLevel

power level of the radio

int

rxUtilization

Rx Utilization (%)

String

slotId

Slot ID of the radio

Integer

txPowerOutput

The txPower currently being used to transmit data, in dBm

int

txUtilization

Tx Utilization (%)

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 Payload

https://172.25.123.114/webacs/api/v1/data/RFStats/15

<?xml version="1.0" ?>
<queryResponse type="RFStats" responseType="getEntity" requestUrl="https://172.25.123.114/webacs/api/v1/data/RFStats/15" rootUrl="https://172.25.123.114/webacs/api/v1/data">
  <entity dtoType="rFStatsDTO" type="RFStats" url="https://172.25.123.114/webacs/api/v1/data/RFStats/15">
    <rfStatsDTO displayName="String value" id="15" uuid="String value">
      <channelNumber>UNKNOWN</channelNumber>
      <channelUtilization>1</channelUtilization>
      <clientCount>1</clientCount>
      <collectionTime>String value</collectionTime>
      <coverageProfile>FAILED</coverageProfile>
      <ethernetMac>String value</ethernetMac>
      <interferenceProfile>FAILED</interferenceProfile>
      <loadProfile>FAILED</loadProfile>
      <macAddress>String value</macAddress>
      <noiseProfile>FAILED</noiseProfile>
      <operStatus>DOWN</operStatus>
      <poorCoverageClients>1</poorCoverageClients>
      <powerLevel>1</powerLevel>
      <rxUtilization>1</rxUtilization>
      <slotId>String value</slotId>
      <txPowerOutput>15</txPowerOutput>
      <txUtilization>1</txUtilization>
    </rfStatsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://172.25.123.114/webacs/api/v1/data/RFStats/15.json

{
  "queryResponse" : {
    "@type" : "RFStats",
    "@responseType" : "getEntity",
    "@requestUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/RFStats\/15",
    "@rootUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data",
    "entity" : {
      "@dtoType" : "rFStatsDTO",
      "@type" : "RFStats",
      "@url" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/RFStats\/15",
      "rfStatsDTO" : {
        "@displayName" : "String value",
        "@id" : "15",
        "@uuid" : "String value",
        "channelNumber" : "UNKNOWN",
        "channelUtilization" : 1,
        "clientCount" : 1,
        "collectionTime" : "String value",
        "coverageProfile" : "FAILED",
        "ethernetMac" : "String value",
        "interferenceProfile" : "FAILED",
        "loadProfile" : "FAILED",
        "macAddress" : "String value",
        "noiseProfile" : "FAILED",
        "operStatus" : "DOWN",
        "poorCoverageClients" : 1,
        "powerLevel" : 1,
        "rxUtilization" : 1,
        "slotId" : "String value",
        "txPowerOutput" : 15,
        "txUtilization" : 1
      }
    }
  }
}