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

REST API Resources

Clients

Provides information about wired and wireless clients.

Resource Description
GET Client Counts Represents number of clients counted during the last polling cycle. The combination of type, key and subtype represents number of clients associated with the entity.
GET Client Details Represents the detail view of a client. It provides attributes of client device, security information, connected device, traffic and session information. All information is collected in current or last session.
GET Client Sessions Represents detail view of client sessions. It provides device and session related attributes including security, connected device, session time, traffic, etc.
GET Client Summary Represents client view with information about the end points. It provides end point information such as MAC address, IP address, username, and status.
GET Client Traffic Information Represents clients traffic information collected during the last polling cycle.
GET Historical Client Counts Represents client count collected in last 24 hours with 5 minutes (default) interval. The dataset could be really big. When querying, you must use paged query or filtered by entity or time. Otherwise it could result in longer running query to affect system performance.
GET Historical Client Traffic Information Represents client traffic information collected in last 24 hours with 15 minutes (default) interval. The dataset could be really big. When querying, you must use paged query or filtered by entity or time. Otherwise it could be resulted in longer running query to affect system performance.

Credentials Service

A REST based operation to query the Credential Manager for a device's credentials.

Resource Description
GET Credentials Operation to retrieve device credentials. Can take one of two parameters: 'id' or 'address'. , e.g. ?id=17010 or ?address=172.23.218.75, where the id is MEI ID or the address is the management address.

Device Details

The Device Details category provides basic information about the managed devices:
  • Device summary and inventory information about devices.
  • Events and alarms in the system.
Resource Description
GET Alarms Alarm is a representation of the fault or change of state that occurred in the managed system; it could be resource or service and customer related. Alarms are associated with a group of events received from the managed resources, usually with the same source and category, indicating that such fault or event had occurred.
GET Devices Represents the device view with information about the managed network elements. It provides device information such as device name, device type, ip address, software type, version, and also provides the reachability and management status.
GET Events Represents a "normalized" record of an occurrence reported by the network (or any system capable of notifying of such an occurrence); it could be a syslog, SNMP trap, or any other such type. The term "normalized" denotes a single format abstracted over all types of reported events, regardless of source and structure.
GET Inventory Details It provides an aggregated view of all the available inventory information for the device.
GET Syslogs Represents the syslog view. Syslogs are standard method for logging messages such as system events in an IP network. This API only supports Syslogs with severities 0, 1, 2 (Emergency, Alert, Critical)

Group Summary Service

The Group Summary Service provides a summary of alarms per group for each type of group (Site, Device Type or User Defined Group) , an overall alarm summary and a summary of the number devices per Site.

Resource Description
GET Device Groups
Deprecated

Do not use this resource. Replaced by /op/groups/deviceGroups.

This provides information about the hierarchy of device type groups. Note that internally, DeviceGroups are type of "Group", and thus all children will be of the generic type "subGroup".
GET Sites
Deprecated

Do not use this resource. Replaced by /op/groups/sites.

This provides information about the location groups and its hierarchy of campus and buildings. Note that internally, Locations are type of "Group", and thus all children will be of the generic type "subGroup".
GET User Defined Groups
Deprecated

Do not use this resource. Replaced by /op/groups/userDefinedGroups.

Provides the list of User Defined groups and the associated sub group hierarchy. Note that internally, UserDefinedGroups are type of "Group", and thus all children will be of the generic type "subGroup".

Report Service

The Report service provides operations to discover and run reports. Reports need to be defined in the system prior to access through the API.

Resource Description
GET Get Available Report Templates
This URL is used to get all the saved report templates. It returns an array of information about the available saved report templates.

Report templates need to be set up in the GUI to be available here.

GET Get a Report
This URL is used to retrieve the report data for a report that was previously generated from an asynchronous call of the reportService/report URL, or returns the latest result from a scheduled report generation.
GET Run a Report
This URL is used to generate reports from a specific saved report template and return the report output as an XML/JSON response.

It takes two arguments: a String reportTitle - a unique title of the saved report template, and a Boolean async indicating if the call is asynchronous when the value is true.

It provides the report data in the case of a synchronous call, or just provides a report URL using which the latest report can be retrieved.

Statistics

The Statistics services provide summary, pre-defined statistical information about the system.

Resource Description
GET Application Art Analysis
Retrieves the application art analysis statistics in the list of time, client network time, server response time, transaction time and data time. Here are the sample queries
  • /op/statisticsService/application/applicationArtAnalysis -- return the art analysis statistics of all applications in the past 1 hour
  • /op/statisticsService/application/applicationArtAnalysis?networkAwareType=2 -- return the wired network art analysis statistics of all applications
  • /op/statisticsService/application/applicationArtAnalysis?appId=1234,5678&siteId=10013 -- return the art analysis statistics of the application with id 1234 and 5678 in the site 10013
GET Application Performance
Retrieves the application performance statistics.
GET Application Top N Traffics
Retrieves the top N clients or server traffic statistics of an application or all applications. Here are the sample queries
  • /op/statisticsService/application/topNTraffics -- return the top 15 client traffics of all applications in the past 1 hour
  • /op/statisticsService/application/topNTraffics?nodeType=server -- return the top 15 server traffics of all applications in the past 1 hour
  • /op/statisticsService/application/topNTraffics?networkAwareType=2 -- return the top 15 client wired traffics of all applications in the past 1 hour
  • /op/statisticsService/application/topNTraffics?appId=1234 -- return the top 15 client traffics of the application with id 1234 in the past 1 hour
  • /op/statisticsService/application/topNTraffics?appId=1234,5678 -- return the top 15 client traffics of of the application with id 1234 and 5678 in the past 1 hour
GET Application Traffic Analysis
Retrieves the traffic analysis of an application.
GET Application Volume
Retrieves the application volume statistics in the list of application name and volume pairs. Here are the sample queries
  • /op/statisticsService/application/appVolume -- return top 15 application volumes in the past 1 hour
  • /op/statisticsService/application/appVolume?siteId=1234
  • /op/statisticsService/application/appVolume?deviceIp=192.168.1.1
  • /op/statisticsService/application/appVolume?deviceIp=192.168.1.1&interfaceIndex=2
GET Applications Number of Users
Retrieves the number of users of an application.
GET CPU Utilization Summary
Retrieves the device CPU utilization summary.
GET CPU Utilization Trend
Retrieves the device CPU utilization trend.
GET Device Availability
Retrieves the device availability summary for a given IP address.
GET Device Availability Message
Retrieves the device availability message.
GET Device Availability Summary

Retrieves the device availability summary.

GET Device Down Message
Retrieves the device down message.
GET Device Health Info
Retrieves the device health information.
GET Device Port Summary
Retrieves the device port summary.
GET Device Reachability Status
Retrieves the device reachability status.
GET Interface Availability
Retrieve the interface availability.
GET Interface Availability Message
Retrieves the interface availability message.
GET Interface Availability Summary
Retrieves the interface availability summary.
GET Interface Details
Retrieves the interface details.
GET Interface Discards
Retrieves the interface discards.
GET Interface Down Message
Retrieves the interface down message.
GET Interface Errors
Retrieves the interface errors.
GET Interface Status Summary
Retrieves the interface status summary.
GET Interface Utilization Summary
Retrieves the interface utilization summary.
GET Interface Utilizations
Retrieves the interface utilization.
GET Memory Utilization Trend
Retrieves the device memory utilization trend.
GET System Health
Retrieves system health statistics.
GET System Information
Retrieves system information statistics.
GET Top N Application Hosts
Retrieves the top N application hosts.
GET Top N Class Map QOS
Retrieves the top N class map QOS statistics.
GET Top N Device CPU Utilization
Retrieves the top N device CPU utilization statistics.
GET Top N Device Memory Utilization
Retrieves the top N device memory utilization statistics.
GET Top N Device Temperature
Retrieves the top N device temperature statistics.
GET Top N Interface Errors
Retrieves the top N interface error statistics.
GET Top N Interface Utilization
Retrieves the top N interface utilization statistics.
GET Top N WAN Interface Issues
Retrieves the top N WAN interface issue statistics.
GET Top N WAN Interface Utilization
Retrieves the top N WAN interface utilization statistics.
GET Worst N Application Hosts
Retrieves the worst N application hosts.
GET Worst N Application Locations
Retrieves the worst N application sites.

Wireless Device Details

The Wireless Device Details category provides detailed information about the managed wireless devices.
Resource Description
GET Autonomous AP Radio Details Represents a radio interface of an autonomous access point.
GET Client Statistics Represents client statistics data collected during the last polling cycle. The data represented here are the counters retrieved from controllers. The counters only get reset in new sessions.
GET Historical Client Statistics Represents client statistics collected in last 24 hours with 15 minutes (default) interval. The dataset could be really big. When querying it, it is better to use paged query or filtered by client or time.
GET Historical Radio Interface 802.11 Counters in Last 24 Hours Represents 802.11 counters collected for radio interfaces of lightweight wireless access points in last 24 hours with 15 minutes (default) interval. The dataset could be really big. When querying it, it is better to use paged query or filtered by AP or time.
GET Historical Radio Interface Statistics in Last 24 Hours Represents statistics for radio interfaces of lightweight wireless access points collected in last 24 hours with 15 minutes (default) interval. The dataset could be really big. When querying it, it is better to use paged query or filtered by AP or time.
GET Historical Wireless Lan Controller Utlizations
Deprecated

Do not use this resource. Replaced by /data/HistoricalWLCCPUUtilizations and /data/HistoricalWLCMemUtilizations.

Represents the historical CPU and memory utilization information collected from WLAN controllers in past 24 hours.
GET Lightweight AP Radio Details Represents detail information of a radio interfaces on lightweight access point.
GET Radio Interface 802.11 Counters Represents the latest 802.11 counters for radio interfaces of lightweight wireless access points collected from controllers.
GET Radio Interface Statistics Represents the latest statistics information for radio interfaces of lightweight wireless access points collected from WLAN controllers.
GET Radio Summary Represents a radio interface of an wireless access point.
GET Wireless Access Point Details Represents detail information of a wireless access points. It includes basic attributes, inventory, CDP, client and other information.
GET Wireless Access Point Summary Represents a wireless access point including both unified and autonomous. It provides device attributes such as type, version, association controller, number of associated client, etc.
GET Wireless Lan Controller Details Represents detail information about a WLAN controller.
GET Wireless Lan Controller Summary Represents summary information about a WLAN controller.
GET Wireless Lan Controller Utlizations
Deprecated

Do not use this resource. Replaced by /data/WLCCPUUtilizations and /data/WLCMemoryUtilizations.

Represents the latest CPU and memory utilization collected from a WLAN controller.