Cisco Prime Infrastructure API
Prime Infrastructure 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

Aggregation?

No

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

DevNet Discussions

Resource URL

/webacs/api/v1/data/Radios

Response Parameters

Attribute Description

adminStatus RadioAdminStatusEnum

Administrative status of the radio interface

Allowed values:

  • 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

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

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

Allowed values:

  • DOWN
  • UP
  • NOTASSOCIATED
  • UNKNOWN

powerLevel Integer

power level of the radio

radioType String

radio type (802.11a/b/g/n)

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://localhost/webacs/api/v1/data/Radios/15

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

Sample JSON Payload

https://localhost/webacs/api/v1/data/Radios/15.json

{
  "queryResponse" : {
    "@type" : "Radios",
    "@responseType" : "getEntity",
    "@requestUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data\/Radios\/15",
    "@rootUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data",
    "entity" : {
      "@dtoType" : "radiosDTO",
      "@type" : "Radios",
      "@url" : "https : \/\/localhost\/webacs\/api\/v1\/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"
      }
    }
  }
}