Compliance Service
Provides service to compliance operations
Resource | Description |
---|---|
GET Checks status of Check Job | Checks status of Compliance Check Job |
POST Add policy | Creates custom policy |
POST Add profile | Creates profile and associates policy |
POST Import policy | Creates custom policy from XML |
POST Schedule a Check Job | Schedules a Compliance Check Job |
Configuration Archive Service
Provides services for configuration file, diff and versions operations
Resource | Description |
---|---|
GET Bulk export sanitized configuration archives | Intended to bulk export of sanitized configuration files from archive. This API resource does not support filtering and sorting on configuration files content. |
GET Bulk export unsanitized configuration archives | Intended to bulk export of unsanitized configuration files from archive. This API resource does not support filtering and sorting on configuration files content. |
GET Configuration Diff | Compute Running Configuration Diff. Currently supported only for router devices. |
Device Operations
Operations to create, update, delete devices
Resource | Description |
---|---|
POST Delete devices through job | Delete one or more devices through a batch job |
Group Management Service
The Group Management Service provides operations for getting group rules summary, deleting and updating groups, managing devices and rules assigned to groups.
Resource | Description |
---|---|
PUT Assign interfaces to a group | Statically assign list of interfaces to given port group . Only 'User Defined' and 'WAN Interfaces' port groups are supported. |
PUT Remove interfaces from a group | Remove a list of interfaces from a given port group. Only 'User Defined' and 'WAN Interfaces' port groups are supported. |
Plug and Play
Provides operations related to Plug And Play
Resource | Description |
---|---|
DELETE Delete Pnp Profile | Deletes the exisiting Pnp profiles. |
GET Get All Profile Instances of a PnP Profile | Takes PnP Profile Name as rest parameter. It returns the set of all Profile Instances of the passed PnP Profile. |
GET Get Profile Instance of PnP Profile | Takes PnP Profile Name and Instance Name as rest parameters. It returns the Profile Instance. |
GET Read All Pnp Profiles | Read all the pnp profiles inside a folder |
GET Read Pnp Profile | Get the attributes of the given pnp profile |
POST Create Pnp Profile | Creates Pnp profiles |
POST Create or Update Profile Instances of a PnP Profile | Takes Profile Name as rest parameter and List of Profile Instances as payload. If Profile Instance with same name and same profile exist, those get updated otherwise new Profile Instance will be created. |
PUT Update Pnp Profile | Updates the existing pnp profiles |
Software Updates
Provides information about Software Updates.
Resource | Description |
---|---|
GET Information about current platform |
Retrieves the information about current platform
|
GET Information about updates |
Retrieves the information about updates for a given UBF name or state. Here are the sample queries
Available states: |
Statistics
The Statistics services provide summary, pre-defined statistical information about the system.
Resource | Description |
---|---|
GET All Border Routers |
Fetches all Border Routers in a PfR controlled site that are actively exporting PfR NetFlow within a specified time range.The URL Format is: /op/pfrMonitoringExt/getAllBorderRouters/startTime/endTime/siteName?siteHierachyPath. Here are the sample queries:
|
GET All IMEs |
Fetches all Immitigable events reported from the Master Controller of the source site for a Site-to-Site communication.Immitigable events typically indicate that for a particular class of traffic, PfR feature (running on Cisco devices) is unable to automatically circumvent Network issues by re-routing traffic .The URL format is:/op/pfrMonitoringExt/getAllIMEs/srcSite/dstSite/startTime/endTime?srcHierarchyPath&destHierarchyPath. Here are the sample queries:
|
GET All RCs |
Fetches all Route Change events reported from the Master Controller of the source site for a Site-to-Site communication. A Route Change event typically indicates that for a given class of traffic, PfR feature (running on Cisco devices) is able to automatically circumvent Network issues by re-routing traffic.The URL format is:/op/pfrMonitoringExt/getAllRCs/srcSite/dstSite/startTime/endTime?srcHierarchyPath&destHierarchyPath. Here are the sample queries:
|
GET All TCAs |
Fetches all Threshold Crossing Alerts reported from the Master Controller of the source site for a Site-to-Site communication within a specified time range. A Threshold Crossing Alert typically indicates that for a given class of traffic, PfR feature (running on Cisco devices) has identified network issues that are imparing the traffic quality (measured in terms of Jitter, Delay, Packet Loss). The URL format is:/op/pfrMonitoringExt/getAllRCs/srcSite/dstSite/startTime/endTimes?rcHierarchyPath&destHierarchyPath. Here are the sample queries:
|
GET All WANInterfaces |
Fetches all the WAN Interface details active within a specific time range for a given site and its Border Router.The URL format is:/op/pfrMonitoringExt/getAllWANInterfaces/startTime/endTime/siteName/brIp?srcHierarchyPath. Here are the sample queries:
|
GET Cluster Details |
Fetches the details of Clusters
|
GET Cluster Metric Data |
Fetches the metric data for a Cluster
|
GET Cluster Metrics Supported |
Fetches the URLs for various metrics of a Cluster
|
GET DSCP App Usage |
Fetches WAN Link bandwidth usage in terms of data volume w.r.t DSCP and applications classified for that DSCP, withinin a specified time range for a site pair. This API accepts the Site names and Site hierarchies.The URL format is:/op/pfrMonitoringExt/getDscpAppUsage/startTime/endTime?srcSiteName&dstSiteName&managedIpBR&tunnelName&srcHierarchyPath&destHierarchyPath. Here are the sample queries:
|
GET DSCP App Usage For Live Topo |
Fetches WAN Link bandwidth usage in terms of data volume w.r.t DSCP and applications classified for that DSCP, within a specified time range for a site pair and a VRF. This API accepts Site Ids in Prime and VRF Ids assigned by Prime PfR NetFlow processing. The pre-requisite of using this API is to fetch the Site Ids and VRF Ids stored in Prime and then use those Ids in this API. The URL format is:/op/pfrMonitoringExt/getDscpAppUsageForLiveTopo/startTime/endTime/srcSiteId/dstSiteId?vrfIdList. Here are the sample queries:
|
GET DSCP Time Vs Usage Chart |
Provides a trending report of DSCP and its associated application usage for a given time frame, a source site, its Border Router and the WAN link. The URL format is:/op/pfrMonitoringExt/getDSCPTimeVsUsageChart/startTime/endTime/siteName/brIp/dscp/noOfPoints?interfaceName. Here are the sample queries:
|
GET Datacenter Details |
Fetches the details of Datacenters
|
GET Datacenter Metric Data |
No metrics are available for Datacenters
|
GET Datacenter Metrics Supported |
No metrics are available for Datacenters
|
GET Device Metric Data |
Fetches the metric data for the device.
|
GET Device Metrics Supported |
Fetches the URLs for various metrics of the device.
|
GET Device Resource |
Fetches the basic details of devices and REST URL links to their children and metrics.
|
GET Host Details |
Fetches the details of Hosts
|
GET Host Metric Data |
Fetches the metric data for a Host
|
GET Host Metrics Supported |
Fetches the URLs for various metrics of a Host
|
GET Interface Metric Data |
Fetches the metric data for an Interface
|
GET Interface Metrics Supported |
Fetches the URLs for various metrics of an Interface
|
GET Interface Resource |
Fetches the basic details of interfaces and REST URL links to their children and metrics
|
GET Lisp Map Summary Trend |
Retrieves the lisp map-cache size over time trend for a given device in the selected time interval
|
GET OutStanding IMEs For Site |
Fetches immitigable events for out going traffic for a given site within a time range. The URL format is:/op/pfrMonitoringExt/getOutStandingIMEsForSite/startTime/endTime/siteName?siteHierarchyPath. Here are the sample queries:
|
GET Refresh App Cache |
Refresh App Cache
|
GET Resource Types Supported |
Fetches the various resources that support statistics service APIs
|
GET Site App Health |
Provides overall application health status of a site in terms of RED and GREEN based on resolved / un-resolved traffic issues. The URL format is:/op/pfrMonitoringExt/getSiteAppHealth/startTime/endTime. Here are the sample queries:
|
GET Threshold Violated Applications |
Retrieves the list of applications which have values that have crossed the historical baselines or the defined health rule for the given group, For getting Fabric based data, pass the fabric id in siteId parameter. Here are the sample queries
|
GET Top N Applications |
Retrieves the top N applications for a given group/site with given time period. If the group is Fabric, please mark isFabric=true else the parameter can be set to false or can be omitted in the URL. Here are the sample queries
|
GET Top N Applications Over Time |
Retrieves the top N applications over time for a given group/site with given time period. If the group is Fabric, please mark isFabric=true else the parameter can be set to false or can be omitted in the URL. Here are the sample queries
|
GET Top N Device Cache |
Retrieves the top N devices by LISP map-cache usage
|
GET TopNApplication Usage Over Time |
Fetches application usage trend over time from AVC NetFlow from a Border / Core Router The URL format is:/op/pfrMonitoringExt/getTopNApplicationUsageOverTimeOld/startTime/endTime/deviceIp/rownum?interfaceName Here are the sample queries:
|
GET TopNApplication Usage Over Time PfR |
Fetches application usage trend over time from PfR NetFlow from a Border Router. This API provides only the Egress Application usage information. The URL format is:/op/pfrMonitoringExt/getTopNApplicationUsageOverTime/startTime/endTime/deviceIp/rownum?interfaceName. Here are the sample queries:
|
GET Total Application Count |
Retrieves the total count of all the applications in a given UCI fabric. The fabric id needs to be set in the siteid parameter of the URL. Here are the sample queries
|
GET VM Details | Fetches the details of VMs |
GET VM Metric Data |
Fetches the metric data for a VM
|
GET VM Metrics Supported |
Fetches the URLs for various metrics of a VM
|
GET WAN Utilization Over TimeRate For Link |
Fetches WAN Utilization Over Time Rate For Link
|
GET WanUtilization Over Time For Link |
Fetches WAN Link utilization trend over time from PfR Bandwidth NetFlow from a Border Router for either IN or OUT direction. The URL format is:/op/pfrMonitoringExt/getWanUtilizationOverTimeForLink/startTime/endTime/deviceIp/rownum?interfaceName. Here are the sample queries:
|
POST DSCP vs All TCA |
Fetches TCA events experienced by various DSCPs in a PfR controlled network. This call is over HTTP(s) POST where a filter object having one or more or none of the below filters can be applied 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getDSCPvsAllTCAViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST DSCP vs UrTCA |
Fetches UnReachable events experienced by various DSCPs in a PfR controlled network. This call is over HTTP(s)POST where a filter object having one or more or none of the below filters can be applied 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getDSCPvsUrTCAViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST Max Delay Vs DSCP Chart Reports |
Provides a trend report of how DSCPs are affected by network Delay reported by PfR events.Provides a trend report of how DSCPs are affected by network Delay reported by PfR events. This call is over HTTP(s) POST where a filter object having one or more or none of the below filters 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getMaxDelayVsDSCPChartReportsViaPost/startTime/endTime Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST Max Jitter Vs DSCP Chart Reports |
Provides a trend report of how DSCPs are affected by Jitter variations reported by PfR events.This call is over HTTP(s) POST where a filter object having one or more or none of the below filters 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getMaxJitterVsDSCPChartReportsViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST Max Packet Loss Vs DSCP Chart Reports |
Provides a trend report of how DSCPs are affected by Packet Loss percentage reported by PfR events.This call is over HTTP(s) POST where a filter object having one or more or none of the below filters 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getMaxPacketLossVsDSCPChartReportsViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST Pfr Event List |
Fetches a trend of PfR Events over a period of time for different PfR controlled Site Pairs. This call is over HTTP(s) POST where a filter object having one or more or none of the below filters 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics The URL format is:/op/pfrMonitoringExt/getPfrEventListViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
POST Service Provider Usage Vs DSCP Chart |
Provides a snapshot view of how Service Providers are being utilized to carry traffic for various DSCPs. This call is over HTTP(s) POST where a filter object having one or more or none of the below filters 1) Source Site 2) Destination Site 3) DSCP 4) Service Provider 5) TCA Metrics. The URL format is:/op/pfrMonitoringExt/getMaxJitterVsDSCPChartReportsViaPost/startTime/endTime. Here are the sample queries:
Sample PostBody: { "pfRLandingPageFilterDTO" : { "dSCPs" : { "dSCPs" :"5" } } } |
VNF Provisioning
Provides for operations to register and deploy VNFs (Virtual Network Functions) on NfVOS.
Resource | Description |
---|---|
GET Get Bridges | Get bridges. |
GET Get Deployments | Get VNF deployments. |
GET Get Device Details | Get device details. |
GET Get OVS Bridges | Get OVS bridges. |
GET Get Services | Get services from NfVOS. |
POST Add Bridge | Add a bridge. |
POST Add Device | Add a device. |
POST Create OVS Bridge | Create an OVS bridge. |
POST Delete Bridge | Delete a bridge. |
POST Delete OVS Bridge | Delete an OVS bridge. |
POST Deploy Service | Deploy a service on NfVOS. |
POST Register Service | Register a service on NfVOS. |
POST Un-Deploy Service | Undeploy a service on NfVOS. |
POST Un-Register Service | Unregister a service on NfVOS. |
PUT Update Bridge | Update Bridge |
PUT Update OVS Bridge | Update OVS Bridge |
Virtual Image Repository
Provides operations to query and manage the Virtual Image Repository
Resource | Description |
---|---|
DELETE Delete Image by id | Delete the image with the supplied ID |
GET List Image by id | List the details of the image with the given ID |
GET List Images | List the details of all NFV images in PI |
GET List Images by family | List the details of all NFV images with the given family name |
GET List Physical Images | List all Physical images in the repository |
GET List Virtual Images | List all Virtual images in the repository |
POST Add Image | Add an image file to the repository |
POST Deploy Configuration | Configure the deployment with the provided details |
Wireless Device Details
Resource | Description |
---|---|
GET Historical Wireless Lan Controller CPU Utilizations | Represents the historical CPU utilization information collected from WLAN controllers in past 24 hours. |
GET Historical Wireless Lan Controller Memory Utilizations | Represents the historical memory utilization information collected from WLAN controllers in past 24 hours. |
GET Wireless Lan Controller CPU Utlizations | Represents the latest CPU utilization collected from a WLAN controller. |
GET Wireless Lan Controller Memory Utilizations | Represents the latest memory utilization collected from a WLAN controller. |