Cisco Prime Infrastructure API
Prime Infrastructure API Documentation

GET ClientSessions

Represents detail view of client sessions. It provides device and session related attributes including security, connected device, session time, traffic, etc.

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/ClientSessions

Unmodified

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

Deprecated

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

Response Parameters

Attribute Description

adDomainName String

AD domain name acquired from Cisco Identity Service Engine

anchorIpAddress String

IP address of the mobility anchor controller if any

apIpAddress String

Associated AP IP address

apMacAddress String

Associated AP MAC address

apName String

Associated AP name

authenticationAlgorithm AuthenticationAlgorithmEnum

Client authentication algorithm

  • OPENSYSTEM
  • SHAREDKEY
  • UNKNOW
  • OPENANDEAP

authorizationPolicy String

Authorization Policy acquired from Cisco Identity Service Engine

bytesReceived long

Number of bytes received during the session

bytesSent long

Number of bytes sent during the session

clientInterface String

Client Interface

connectionType ConnectionTypeEnum

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

  • LIGHTWEIGHTWIRELESS
  • AUTONOMOUSWIRELESS
  • WIRED

ctsSecurityGroup String

CTS security group acquired from Cisco Identity Service Engine

deviceIpAddress String

Associated device IP address

deviceName String

Associated device name (controller or switch)

eapType EapTypeEnum

EAP type

  • EAPTLS
  • TTLS
  • PEAP
  • LEAP
  • SPEKE
  • EAPFAST
  • NA
  • UNNOWN
  • MD5
  • EAPSIM

encryptionCypher EncryptionCypherEnum

Client encryption cypher

  • CCMPAES
  • TKIPMIC
  • LITERAL2
  • WEP140
  • WEP128
  • NONE
  • NA
  • UNKNOWN

ipAddress String

Client IP Address

ipType ClientIpTypeEnum

Client IP type (IPv4, IPv6 or Dual Stack)

  • IPV4
  • IPV6
  • DUALSTACK
  • NOTDETECTED

location String

Associated AP or switch Map location

macAddress String

Client MAC Address

packetsReceived long

Number of packets received during the session

packetsSent long

Number of bytes sent during the session

policyTypeStatus PolicyTypeStatusEnum

Client policy status

  • IDLE
  • RUNNING
  • NOMETHOD
  • AUTHENTICATIONSUCEEDED
  • AUTHENTICATIONFAILED
  • AUTHORIZATIONSUCCEEDED
  • AUTHORIZATIONFAILED
  • DISASSOCIATED

portSpeed ClientSpeedEnum

Port speed (10Mbps, 100Mbps, 1Gbps, 10Gbps, 2.5Gbps, 5Gbps, 25Gbps, 40Gbps) for wired client

  • UNKNOWN
  • SPEED10M
  • SPEED100M
  • SPEED1G
  • SPEED10G
  • SPEED2_5G
  • SPEED5G
  • SPEED25G
  • SPEED40G

postureStatus PostureStatusEnum

Client posture status acquired from Cisco Identity Service Engine

  • UNKNOWN
  • COMPLIANT
  • NONCOMPLIANT
  • PENDING
  • NA
  • ERROR

profileName String

Profile name

protocol ClientProtocolEnum

Client connection protocol (802.11a, 802.11ac, 802.11ax, 802.11b, 802.11g, 802.11n or 802.3)

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

roamReason String

The reason reported from controller why client is moved to another AP

rssi int

RSSI observed from last polling during the session

securityPolicy SecurityPolicyEnum

Client security policy type

  • DOT1X
  • WPA1
  • WPA2
  • WPA2VFF
  • NA
  • UNKNOWN
  • CCKM
  • WAPI
  • MACAUTHBYPASS
  • WEBAUTH
  • WPA

sessionEndTime long

Session end time is the time the session finished, measured in milliseconds since the Unix epoch. For sessions that are still active, this time may be some point for in the future (for example Jan 1, 2100).

sessionStartTime long

Session start time is the time the session started, measured in milliseconds since the Unix epoch.

sessionTime long

Session duration on the moment of last updating. If session is finished then sessionTime = sessionEndTime - sessionStartTime, else sessionTime = currentTime - sessionStartTime.

snr int

SNR (Signal to Noise Ratio) observed from last polling during the session

ssid String

SSID

throughput double

Average session throughput

userName String

Client Username

vlan String

Vlan name

webSecurity WebSecurityEnum

Flag to indicate whether the client is authenticated via WebAuth

  • DISABLED
  • ENABLED

wgbMacAddress String

WGB MAC Address if it is a WGB client

wgbStatus WGBStatusEnum

Flag to indicate whether the client is WGB client, WGB AP or local client

  • REGULARCLIENT
  • WGBCLIENT
  • WGBAP

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/v2/data/ClientSessions/15

<?xml version="1.0" ?>
<queryResponse type="ClientSessions" responseType="getEntity" requestUrl="https://localhost/webacs/api/v2/data/ClientSessions/15" rootUrl="https://localhost/webacs/api/v2/data">
  <entity dtoType="clientSessionsDTO" type="ClientSessions" url="https://localhost/webacs/api/v2/data/ClientSessions/15">
    <clientSessionsDTO displayName="String value" id="15" uuid="String value">
      <adDomainName>String value</adDomainName>
      <authenticationAlgorithm>OPENSYSTEM</authenticationAlgorithm>
      <authorizationPolicy>String value</authorizationPolicy>
      <bytesReceived>2</bytesReceived>
      <bytesSent>2</bytesSent>
      <clientInterface>String value</clientInterface>
      <connectionType>LIGHTWEIGHTWIRELESS</connectionType>
      <ctsSecurityGroup>String value</ctsSecurityGroup>
      <deviceName>String value</deviceName>
      <eapType>EAPTLS</eapType>
      <encryptionCypher>CCMPAES</encryptionCypher>
      <ipType>IPV4</ipType>
      <location>String value</location>
      <packetsReceived>2</packetsReceived>
      <packetsSent>2</packetsSent>
      <policyTypeStatus>IDLE</policyTypeStatus>
      <portSpeed>UNKNOWN</portSpeed>
      <postureStatus>UNKNOWN</postureStatus>
      <profileName>String value</profileName>
      <protocol>UNDEFINED</protocol>
      <roamReason>String value</roamReason>
      <rssi>1</rssi>
      <securityPolicy>DOT1X</securityPolicy>
      <sessionEndTime>2</sessionEndTime>
      <sessionStartTime>2</sessionStartTime>
      <sessionTime>2</sessionTime>
      <snr>1</snr>
      <ssid>String value</ssid>
      <throughput>4.0</throughput>
      <userName>String value</userName>
      <webSecurity>DISABLED</webSecurity>
      <wgbStatus>REGULARCLIENT</wgbStatus>
      <anchorIpAddress>String value</anchorIpAddress>
      <apIpAddress>String value</apIpAddress>
      <apMacAddress>String value</apMacAddress>
      <apName>String value</apName>
      <deviceIpAddress>String value</deviceIpAddress>
      <ipAddress>String value</ipAddress>
      <macAddress>String value</macAddress>
      <vlan>String value</vlan>
      <wgbMacAddress>String value</wgbMacAddress>
    </clientSessionsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://localhost/webacs/api/v2/data/ClientSessions/15.json

{
  "queryResponse" : {
    "@type" : "ClientSessions",
    "@requestUrl" : "https://localhost/webacs/api/v2/data/ClientSessions/15",
    "@responseType" : "getEntity",
    "@rootUrl" : "https://localhost/webacs/api/v2/data",
    "entity" : [ {
      "@dtoType" : "clientSessionsDTO",
      "@type" : "ClientSessions",
      "@url" : "https://localhost/webacs/api/v2/data/ClientSessions/15",
      "clientSessionsDTO" : {
        "@displayName" : "String value",
        "@id" : 15,
        "@uuid" : "String value",
        "adDomainName" : "String value",
        "anchorIpAddress" : "String value",
        "apIpAddress" : "String value",
        "apMacAddress" : "String value",
        "apName" : "String value",
        "authenticationAlgorithm" : "OPENSYSTEM",
        "authorizationPolicy" : "String value",
        "bytesReceived" : 2,
        "bytesSent" : 2,
        "clientInterface" : "String value",
        "connectionType" : "LIGHTWEIGHTWIRELESS",
        "ctsSecurityGroup" : "String value",
        "deviceIpAddress" : "String value",
        "deviceName" : "String value",
        "eapType" : "EAPTLS",
        "encryptionCypher" : "CCMPAES",
        "ipAddress" : "String value",
        "ipType" : "IPV4",
        "location" : "String value",
        "macAddress" : "String value",
        "packetsReceived" : 2,
        "packetsSent" : 2,
        "policyTypeStatus" : "IDLE",
        "portSpeed" : "UNKNOWN",
        "postureStatus" : "UNKNOWN",
        "profileName" : "String value",
        "protocol" : "UNDEFINED",
        "roamReason" : "String value",
        "rssi" : 1,
        "securityPolicy" : "DOT1X",
        "sessionEndTime" : 2,
        "sessionStartTime" : 2,
        "sessionTime" : 2,
        "snr" : 1,
        "ssid" : "String value",
        "throughput" : 4.0,
        "userName" : "String value",
        "vlan" : "String value",
        "webSecurity" : "DISABLED",
        "wgbMacAddress" : "String value",
        "wgbStatus" : "REGULARCLIENT"
      }
    } ]
  }
}