Cisco Cisco Security Manager 4.11 Guia De Especificação
Cisco Security Manager 4.4 API Specification (Version 1.1)
OL- 29074-01
Page 135
Figure 86: eventSubscription for ConfigChange XML Example
The above request will be sent by the client to register for events. The API only supports event notifications using
the syslog protocol (the format of the event data over syslog can be XML or syslog plainText which is described in
the table and subsequent sections).
the syslog protocol (the format of the event data over syslog can be XML or syslog plainText which is described in
the table and subsequent sections).
All event subscriptions are linked to the active logged in session. If the session (that initiated the subscription
request) is logged out or expires, then all subscriptions corresponding to the session are deleted. It is thus important
for the client to keep the session alive if it needs to receive event notifications.
request) is logged out or expires, then all subscriptions corresponding to the session are deleted. It is thus important
for the client to keep the session alive if it needs to receive event notifications.
The following events are supported:
1. Config Change Event
a. The event will be sent whenever a configuration change has been made and deployed on the
network device identified in the event (either via CSM or out-of-band).
2. Device Status Change Event:
a. This event will be sent whenever CSM detects a change in the device connectivity status, either UP
or DOWN.
Table 73: eventSubscription Request Elements and Attributes Descriptions
Element.
Attribute
Name
Definition
eventSubRequest
eventSubscription request allows the client to register a
events handler for one or more classes
events handler for one or more classes
URL:
https://hostname/nbi/eventservice/eventSubscription
XML Argument:
<?xml version=”1.0” encoding=”UTF-8”?>
<eventSubRequest>
https://hostname/nbi/eventservice/eventSubscription
XML Argument:
<?xml version=”1.0” encoding=”UTF-8”?>
<eventSubRequest>
<op>add</op>
<subscriptionId>123454</subscriptionId>
<eventFilterItem>
<filterEventType>syslog</filterEventType>
<filterEventFormat>xml</filterEventFormat>
<filterEventCategory>configChange</filterEventCategory>
</eventFilterItem>
<syslogServer>
<port>514</port>
<destAddress>12.1.1.1</destAddress>
</syslogServer>
</eventSubRequest>