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

GET Clients

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Represents client view with information about the end points. It provides end point information such as MAC address, IP address, username, and status.

Since Product Version: 1.2

Resource URL

/webacs/api/v1/data/Clients

Deprecated

This version has been deprecated due to poor performance in large-scale environments. Please use v2.

Response Parameters

Type Attribute Name Description

String

apMacAddress

associated AP MAC address for wireless client

long

associationTime

Last or current session start time of the client of the NCS server in unix format

String

clientInterface

interface that the client is connected to

ConnectionTypeEnum

connectionType

Type of connection (Lightweight AP, Autonomous AP, or Wired)

Allowed values:

  • LIGHTWEIGHTWIRELESS
  • AUTONOMOUSWIRELESS
  • WIRED

String

deviceIpAddress

associated device IP address

String

deviceName

associated device name

String

deviceType

device type of the client, like laptop, iPad, etc

String

hostname

DNS lookup by client IP address

String

instanceUuid

This is a uuid for this instance.

String

ipAddress

Client IP Address

String

location

map location of the client

String

macAddress

Client MAC Address

ClientProtocolEnum

protocol

client connection protocol (802.11a, 802.11b, 802.11g, 802.11n or 802.3)

Allowed values:

  • UNDEFINED
  • DOT11A
  • DOT11B
  • DOT11G
  • UNKNOWN
  • MOBILE
  • DOT11N2_4GNZ
  • DOT11N5GHZ
  • DOT3
  • DOT3GUEST
  • DOT11AC

SecurityPolicyStatusEnum

securityPolicyStatus

status whether the client is on network (in running state)

Allowed values:

  • PASSED
  • FAILED

String

ssid

ssid that the client is connected to

ClientStatusEnum

status

current association status of the client

Allowed values:

  • IDLE
  • AUTHPENDING
  • AUTHENTICATED
  • ASSOCIATED
  • POWERSAVE
  • DISASSOCIATED
  • TOBEDELETED
  • PROBING
  • BLACKLISTED
  • NOTCONFIGURED
  • UNAUTHENTICATED

long

updateTime

Last time this record was updated. Measured in milliseconds since the Unix epoch.

String

userName

Client Username

String

vendor

vendor name of client card

String

vlan

Name of the vlan that the client is connected to

int

vlanId

ID of the vlan the client is connected to

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/Clients/15

<?xml version="1.0" ?>
<queryResponse type="Clients" responseType="getEntity" requestUrl="https://172.25.123.114/webacs/api/v1/data/Clients/15" rootUrl="https://172.25.123.114/webacs/api/v1/data">
  <entity dtoType="clientsDTO" type="Clients" url="https://172.25.123.114/webacs/api/v1/data/Clients/15">
    <clientsDTO displayName="String value" id="15" uuid="String value">
      <apMacAddress>String value</apMacAddress>
      <associationTime>2</associationTime>
      <clientInterface>String value</clientInterface>
      <connectionType>LIGHTWEIGHTWIRELESS</connectionType>
      <deviceIpAddress>String value</deviceIpAddress>
      <deviceName>String value</deviceName>
      <deviceType>String value</deviceType>
      <hostname>String value</hostname>
      <ipAddress>String value</ipAddress>
      <location>String value</location>
      <macAddress>String value</macAddress>
      <protocol>UNDEFINED</protocol>
      <securityPolicyStatus>PASSED</securityPolicyStatus>
      <ssid>String value</ssid>
      <status>IDLE</status>
      <updateTime>2</updateTime>
      <userName>String value</userName>
      <vendor>String value</vendor>
      <vlan>String value</vlan>
      <vlanId>1</vlanId>
    </clientsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

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

{
  "queryResponse" : {
    "@type" : "Clients",
    "@responseType" : "getEntity",
    "@requestUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/Clients\/15",
    "@rootUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data",
    "entity" : {
      "@dtoType" : "clientsDTO",
      "@type" : "Clients",
      "@url" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/Clients\/15",
      "clientsDTO" : {
        "@displayName" : "String value",
        "@id" : "15",
        "@uuid" : "String value",
        "apMacAddress" : "String value",
        "associationTime" : 2,
        "clientInterface" : "String value",
        "connectionType" : "LIGHTWEIGHTWIRELESS",
        "deviceIpAddress" : "String value",
        "deviceName" : "String value",
        "deviceType" : "String value",
        "hostname" : "String value",
        "ipAddress" : "String value",
        "location" : "String value",
        "macAddress" : "String value",
        "protocol" : "UNDEFINED",
        "securityPolicyStatus" : "PASSED",
        "ssid" : "String value",
        "status" : "IDLE",
        "updateTime" : 2,
        "userName" : "String value",
        "vendor" : "String value",
        "vlan" : "String value",
        "vlanId" : 1
      }
    }
  }
}