Cisco DCNM Web Services API Guide, Release 4.2
EventApp Service
Downloads: This chapterpdf (PDF - 98.0KB) The complete bookPDF (PDF - 7.93MB) | Feedback

EventApp Service

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