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

GET Radios

Retrieves radio interfaces of lightweight and autonomous access points. You should use RadioDetails API for retrieving only radio interfaces of lightweight APs and AutoApRadioDetails API for only radio interfaces of autonomous APs.

Since Product Version: 1.2

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Group Filtering?

No

Aggregation?

No

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Resource URL

/webacs/api/v2/data/Radios

Unmodified

This resource has not been modified since the previous API version.

Deprecated

This version has been deprecated. Please use v4.

Response Parameters

Attribute Description

adminStatus RadioAdminStatusEnum

Administrative status of the radio interface

  • UNKNOWN
  • ENABLE
  • DISABLE

apIpAddress String

IP address of the access point

apName String

Name of the access point

apType String

Type of access point (CAPWAP or Autonomous)

baseRadioMac String

Base radio MAC address

channelNumber ChannelNumberEnum

Current operational channel number

  • 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

clientCount String

Client count connected to the radio interface

controllerIpAddress String

Registered controller IP address for CAPWAP AP only

ethernetMac String

MAC address of the ethernet interface on the AP

operStatus RadioOperStatusEnum

Operational status of the radio interface

  • DOWN
  • UP
  • NOTASSOCIATED
  • UNKNOWN

powerLevel Integer

Power level of the radio

radioType String

Radio type of the interface. Allowed values: 802.11a, 802.11ac, 802.11a/n, 802.11a/n/ac, 802.11a/n/ac/ax, 802.11b/g, 802.11b/g/n, 802.11b/g/n/ax, 802.11a/b/g/n, 802.11a/b/g/n/ac, 802.11a/b/g/n/ac/ax, XOR (Monitor Mode), XOR (2.4GHz), XOR (5GHz), UWB, BLE, Unknown

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.20.127.108/webacs/api/v2/data/Radios/15

<?xml version="1.0" ?>
<queryResponse type="Radios" responseType="getEntity" requestUrl="https://172.20.127.108/webacs/api/v2/data/Radios/15" rootUrl="https://172.20.127.108/webacs/api/v2/data">
  <entity dtoType="radiosDTO" type="Radios" url="https://172.20.127.108/webacs/api/v2/data/Radios/15">
    <radiosDTO displayName="String value" id="15" uuid="String value">
      <adminStatus>UNKNOWN</adminStatus>
      <apName>String value</apName>
      <channelNumber>UNKNOWN</channelNumber>
      <operStatus>DOWN</operStatus>
      <powerLevel>15</powerLevel>
      <apIpAddress>String value</apIpAddress>
      <apType>String value</apType>
      <baseRadioMac>String value</baseRadioMac>
      <clientCount>String value</clientCount>
      <controllerIpAddress>String value</controllerIpAddress>
      <ethernetMac>String value</ethernetMac>
      <radioType>String value</radioType>
    </radiosDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://172.20.127.108/webacs/api/v2/data/Radios/15.json

{
  "queryResponse" : {
    "@type" : "Radios",
    "@requestUrl" : "https://172.20.127.108/webacs/api/v2/data/Radios/15",
    "@responseType" : "getEntity",
    "@rootUrl" : "https://172.20.127.108/webacs/api/v2/data",
    "entity" : [ {
      "@dtoType" : "radiosDTO",
      "@type" : "Radios",
      "@url" : "https://172.20.127.108/webacs/api/v2/data/Radios/15",
      "radiosDTO" : {
        "@displayName" : "String value",
        "@id" : 15,
        "@uuid" : "String value",
        "adminStatus" : "UNKNOWN",
        "apIpAddress" : "String value",
        "apName" : "String value",
        "apType" : "String value",
        "baseRadioMac" : "String value",
        "channelNumber" : "UNKNOWN",
        "clientCount" : "String value",
        "controllerIpAddress" : "String value",
        "ethernetMac" : "String value",
        "operStatus" : "DOWN",
        "powerLevel" : 15,
        "radioType" : "String value"
      }
    } ]
  }
}