Cisco Cisco Prime Network Services Controller 3.2 Developer's Guide

Page 15 

OL-30968-01 

 

The response from Prime Network Services Controller will include XML message with the following Xpath 
information: 

<aaaLogin  

cookie="testCookie"  
commCookie=""  
srcExtSys="0.0.0.0"  
destExtSys="0.0.0.0"  
srcSvc=""  
destSvc=""  
response="yes"  
outCookie="<real_cookie>"  
outRefreshPeriod="600"  
outPriv="admin,read-only"  
outDomains=""  
outChannel="fullssl"  
outEvtChannel="fullssl"  
outSessionId="web_46649"  
outVersion="3.0(1c)" /> 

  

The response from Prime Network Services Controller will need to be filtered to get the session cookie value, this 
is held in the //aaaLogin/@outCookie value. 

This information for example can  be held in a variable called ‘Cookie-Value’ . 

This value can then be used on all further session API calls. 

For example a call to /service-reg can be made with the following cookie embedded: 
<configConfMo cookie="Cookie-Value" inHierarchical="false"> 

<inConfig> 

<orgTenant dn="org-root/org-coke" status="created"/> 

</inConfig> 

</configConfMo> 

Data Validation 

Prime Network Services Controller validates all configuration information that is entered via the API for each 
property, including the data type (such as integer, boolean, or string) and any additional constraints (such as an 
integer range or string regular expression). If the information supplied via the API does not meet the requirements 
for the specified property, Prime Network Services Controller stops the transaction and issues a failure response. 

For more information about failure responses, see 

.  

Event Subscription Methods  

When an object is created, changed, or deleted because of a user- or system-initiated action, an event is 
generated. Applications can receive Prime Network Services Controller state change information by regular polling 
or subscribing to events. Because polling is resource-expensive, event subscription is the preferred method of 
notification. 

Event subscription allows a client application to register for event notification from Prime Network Services 
Controller. When an event occurs, Prime Network Services Controller sends a notification of the event and its type 
to the subscribing client applications. Only actual change events are sent, not the object’s unaffected attributes. 
This process applies to all object changes in the system. 

Subscribing to Event Notification 

To subscribe to event notification: 

Step 1.   Log into Prime Network Services Controller to obtain a valid cookie for event subscription. If you are not 

logged in, the event subscription request will be rejected with an error response. 

Step 2.   Open an HTTP session and keep the session open.