Cisco DCNM Web Services API Guide, Release 4.1 - EventApp Service [Cisco Prime Data Center Network Manager]

Table Of Contents

EventApp Service

Information About EventApp Service

createUserAction

deleteEventsBeforeATimeStamp

deleteEventsBetweenTimestamps

getEventCountAfterATimestamp

getEventsAfterATimestamp

getEventsBeforeATimestamp

getEventsBetweenTimestamps

getEventsBetweenTimestampsByEventClass

getEventsForEventType

getEventsForEventTypeByEventClass

getEventsForFeature

getEventsForFeatureByEventClass

getEventsForPerceivedSeverity

getEventsForPerceivedSeverityByEventClass

getLastEvent

getUserActions

modifyEventStatus

EventApp Service

This chapter describes the DCNM web services' API methods for the EventApp service.

Information About EventApp Service

The EventApp service provides you with various methods to obtain persistent events in the database.

createUserAction

Persist the userActions done for a list of events

Parameters

opContext—Operational context

annotatedEvents—List of userActions performed on a list of events

Return Value

void

deleteEventsBeforeATimeStamp

Deletes the events having timestamp earlier than the specified Timestamp object.

Parameters

opContext—Operational context

timestamp—specifies the Timestamp

Return Value

void

deleteEventsBetweenTimestamps

Deletes the events having timestamp between two timeInstances (startTime and endTime)

Parameters

opContext—Operational context

startTime—Start Timestamp

endTime—End Timestamp

Return Value

void

getEventCountAfterATimestamp

Returns the number of events having timestamp later than the specified Timestamp object.

If no Events present in the Database later than specified timestamp will return 0.

Parameters

opContext—Operational context

timestamp—specifies the Timestamp

Return Value

The number of events having timestamp later than the specified timestamp

getEventsAfterATimestamp

Returns a list of Events having timestamp later than the specified Timestamp object.

If no Events present in the Database later than specified timestamp will return an empty List.

Parameters

opContext—Operational context

timestamp—specifies the Timestamp

eventCount—specifies the no.of events to be retrieved from the Database

Return Value

List of the Events having timestamp later than the specified timestamp

getEventsBeforeATimestamp

Returns a list of Events having timestamp earlier than the specified Timestamp object.

If no Events present in the Database earlier to the specified timestamp, will return an empty List.

Parameters

opContext—Operational context

timestamp—specifies the Timestamp

eventCount—specifies the no.of events to be retrieved from the Database

Return Value

List of the Events having timestamp earlier than the specified timestamp

getEventsBetweenTimestamps

Returns a list of Events having timestamp between two timeInstances (startTime and endTime)

Parameters

opContext—Operational context

startTime—Start Timestamp

endTime—End Timestamp

Return Value

List of the Events having timestamp between two timeInstances (startTime and endTime)

If the specified startTime is null, then will return events having timestamp earlier than the endTime.

If the specified endTime is null, then will return events having timestamp later than the startTime

If the specified startTime and endTime are null, then will return all the persisted events.

getEventsBetweenTimestampsByEventClass

Returns the List of Events having timeStamp between two timeInstances (startTime and endTime) with the specified filterType.

Parameters

opContext—Operational context

startTime—Start Timestamp

endTime—End Timestamp

filterType—specifies the type of Events to be retrieved from the Database.

Can specify the following filterTypes (Constants)

– DcmNormalizedEvent

– DcmThresholdEvent

– DcmInformationalEvent

– UnsupportedEvent

– All type of Events

Return Value

List of the Events having timestamp between two timeInstances (startTime and endTime) and corresponding filterType

If the specified startTime is null, then will return events having timestamp earlier than the endTime.

If the specified endTime is null, then will return events having timestamp later than the startTime

If the specified startTime and endTime are null, then will return all the events persisted in the Database.

getEventsForEventType

Returns the List of Events having specified EventType

Parameters

opContext—Operational context

eventType—specifies the EventType

Return Value

List returns a List of Events corresponding specified eventType and filterType

getEventsForEventTypeByEventClass

Returns the List of Events having specified EventType and filterType.

Parameters

opContext—Operational context

eventType—specifies the EventType

filterType—specifies the type of Events to be retrieved from the Database.

Can specify the following filterTypes (Constants)

– DcmNormalizedEvent

– DcmThresholdEvent

– DcmInformationalEvent

– UnsupportedEvent

– All type of Events

Return Value

List returns a List of Events corresponding specified eventType and filterType

getEventsForFeature

Returns the List of Events having specified FeatureType.

Parameters

opContext—Operational context

featureType—specifies the FeatureType

Return Value

List of persisted Events having specified featureType

getEventsForFeatureByEventClass

Returns the List of Events having specified FeatureType and filterType.

Parameters

opContext—Operational context

featureType—specifies the FeatureType

filterType—specifies the type of Events to be retrieved from the Database.

Can specify the following filterTypes (Constants)

– DcmNormalizedEvent

– DcmThresholdEvent

– DcmInformationalEvent

– UnsupportedEvent

– All type of Events

Return Value

List of persisted Events having specified featureType and filterType

getEventsForPerceivedSeverity

Returns the List of Events having specified PerceivedSeverity.

Parameters

opContext—Operational context

perceivedSeverity—specifies the PerceivedSeverity

Return Value

List of persisted Events having specified perceivedSeverity

getEventsForPerceivedSeverityByEventClass

Returns the List of Events having specified PerceivedSeverity and filterType.

Parameters

opContext—Operational context

perceivedSeverity—specifies the PerceivedSeverity

filterType—specifies the type of Events to be retrieved from the Database.

Can specify the following filterTypes (Constants)

– DcmNormalizedEvent

– DcmThresholdEvent

– DcmInformationalEvent

– UnsupportedEvent

– All type of Events

Return Value

List of persisted Events having specified PerceivedSeverity and filterType

getLastEvent

Returns the Last persisted event in the Database

Parameters

opContext—Operational context

Return Value

Last persisted event in the Database

getUserActions

Returns a List of AnnotatedEvents having specified eventId.

Parameters

opContext—Operational context

eventId—persistedEventId

Return Value

Returns a List of AnnotatedEvents having eventId

modifyEventStatus

Update the EventStatus in the Database for a List of events

Parameters

opContext—Operational context

eventIds—contains list of eventIds

eventStatusList—contains a list of modified EventStatus

Return Value

void

	Cisco DCNM Web Services API Guide, Release 4.1
	EventApp Service
Cisco DCNM Web Services API Guide, Release 4.1 Preface Overview AaaApp Service AclApp Service CollectorApp Service CollectorExtendedApp Service ConfigArchiveApp Service DaiApp Service DataPurgingApp Service DevicelistApp Service DhcpSnoopApp Service Dot1xApp Service EtherChanApp Service EventApp Service GlbpApp Service HsrpApp Service InterfacesApp Service ImageInstallApp Service InventoryApp Service IpSourceGuardApp Service KeyChainApp Service LicensingApp Service LogApp Service NacLpIpApp Service ObjTrackingApp Service PollerApp Service PortSecApp Service RbacApp Service RepositoryApp Service SecurityApp Service ServerAdminApp Service SoftwareApp Service SpanApp Service StpApp Service TrafficStormControlApp Service TunnelApp Service UserApp Service VdcApp Service VlanApp Service VpcApp Service VrfApp Service	Download this chapter EventApp Service Download the complete book Cisco DCNM Web Services API Guide, Release 4.1 (PDF - 5 MB) Feedback Table Of Contents EventApp Service Information About EventApp Service createUserAction deleteEventsBeforeATimeStamp deleteEventsBetweenTimestamps getEventCountAfterATimestamp getEventsAfterATimestamp getEventsBeforeATimestamp getEventsBetweenTimestamps getEventsBetweenTimestampsByEventClass getEventsForEventType getEventsForEventTypeByEventClass getEventsForFeature getEventsForFeatureByEventClass getEventsForPerceivedSeverity getEventsForPerceivedSeverityByEventClass getLastEvent getUserActions modifyEventStatus EventApp Service This chapter describes the DCNM web services' API methods for the EventApp service. Information About EventApp Service The EventApp service provides you with various methods to obtain persistent events in the database. createUserAction Persist the userActions done for a list of events Parameters opContext—Operational context annotatedEvents—List of userActions performed on a list of events Return Value void deleteEventsBeforeATimeStamp Deletes the events having timestamp earlier than the specified Timestamp object. Parameters opContext—Operational context timestamp—specifies the Timestamp Return Value void deleteEventsBetweenTimestamps Deletes the events having timestamp between two timeInstances (startTime and endTime) Parameters opContext—Operational context startTime—Start Timestamp endTime—End Timestamp Return Value void getEventCountAfterATimestamp Returns the number of events having timestamp later than the specified Timestamp object. If no Events present in the Database later than specified timestamp will return 0. Parameters opContext—Operational context timestamp—specifies the Timestamp Return Value The number of events having timestamp later than the specified timestamp getEventsAfterATimestamp Returns a list of Events having timestamp later than the specified Timestamp object. If no Events present in the Database later than specified timestamp will return an empty List. Parameters opContext—Operational context timestamp—specifies the Timestamp eventCount—specifies the no.of events to be retrieved from the Database Return Value List of the Events having timestamp later than the specified timestamp getEventsBeforeATimestamp Returns a list of Events having timestamp earlier than the specified Timestamp object. If no Events present in the Database earlier to the specified timestamp, will return an empty List. Parameters opContext—Operational context timestamp—specifies the Timestamp eventCount—specifies the no.of events to be retrieved from the Database Return Value List of the Events having timestamp earlier than the specified timestamp getEventsBetweenTimestamps Returns a list of Events having timestamp between two timeInstances (startTime and endTime) Parameters opContext—Operational context startTime—Start Timestamp endTime—End Timestamp Return Value List of the Events having timestamp between two timeInstances (startTime and endTime) If the specified startTime is null, then will return events having timestamp earlier than the endTime. If the specified endTime is null, then will return events having timestamp later than the startTime If the specified startTime and endTime are null, then will return all the persisted events. getEventsBetweenTimestampsByEventClass Returns the List of Events having timeStamp between two timeInstances (startTime and endTime) with the specified filterType. Parameters opContext—Operational context startTime—Start Timestamp endTime—End Timestamp filterType—specifies the type of Events to be retrieved from the Database. Can specify the following filterTypes (Constants) – DcmNormalizedEvent – DcmThresholdEvent – DcmInformationalEvent – UnsupportedEvent – All type of Events Return Value List of the Events having timestamp between two timeInstances (startTime and endTime) and corresponding filterType If the specified startTime is null, then will return events having timestamp earlier than the endTime. If the specified endTime is null, then will return events having timestamp later than the startTime If the specified startTime and endTime are null, then will return all the events persisted in the Database. getEventsForEventType Returns the List of Events having specified EventType Parameters opContext—Operational context eventType—specifies the EventType Return Value List returns a List of Events corresponding specified eventType and filterType getEventsForEventTypeByEventClass Returns the List of Events having specified EventType and filterType. Parameters opContext—Operational context eventType—specifies the EventType filterType—specifies the type of Events to be retrieved from the Database. Can specify the following filterTypes (Constants) – DcmNormalizedEvent – DcmThresholdEvent – DcmInformationalEvent – UnsupportedEvent – All type of Events Return Value List returns a List of Events corresponding specified eventType and filterType getEventsForFeature Returns the List of Events having specified FeatureType. Parameters opContext—Operational context featureType—specifies the FeatureType Return Value List of persisted Events having specified featureType getEventsForFeatureByEventClass Returns the List of Events having specified FeatureType and filterType. Parameters opContext—Operational context featureType—specifies the FeatureType filterType—specifies the type of Events to be retrieved from the Database. Can specify the following filterTypes (Constants) – DcmNormalizedEvent – DcmThresholdEvent – DcmInformationalEvent – UnsupportedEvent – All type of Events Return Value List of persisted Events having specified featureType and filterType getEventsForPerceivedSeverity Returns the List of Events having specified PerceivedSeverity. Parameters opContext—Operational context perceivedSeverity—specifies the PerceivedSeverity Return Value List of persisted Events having specified perceivedSeverity getEventsForPerceivedSeverityByEventClass Returns the List of Events having specified PerceivedSeverity and filterType. Parameters opContext—Operational context perceivedSeverity—specifies the PerceivedSeverity filterType—specifies the type of Events to be retrieved from the Database. Can specify the following filterTypes (Constants) – DcmNormalizedEvent – DcmThresholdEvent – DcmInformationalEvent – UnsupportedEvent – All type of Events Return Value List of persisted Events having specified PerceivedSeverity and filterType getLastEvent Returns the Last persisted event in the Database Parameters opContext—Operational context Return Value Last persisted event in the Database getUserActions Returns a List of AnnotatedEvents having specified eventId. Parameters opContext—Operational context eventId—persistedEventId Return Value Returns a List of AnnotatedEvents having eventId modifyEventStatus Update the EventStatus in the Database for a List of events Parameters opContext—Operational context eventIds—contains list of eventIds eventStatusList—contains a list of modified EventStatus Return Value void
	Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks