Event API
Using the Event API
Event API Method Calls
Handling Event Notifications On the Client Side
- Example
- Events and Outage Notification Handling WSDL (Client Side)
Push Mechanisms
- QueryResult
- Example

Event API

This chapter describes the Event API.

Using the Event API

In your IoT FND NB API client application, use this IoT FND server URL to access the Event API WSDL:

http://<server_address> /nbapi/event?wsdl

For example:

http://10.27.167.19/nbapi/event?wsdl

Event API Method Calls

This section contains the following topics:

searchEvents

This call searches for events based on device type, event name, event time, and event severity. This API returns only the events of the domain that the user belongs to.

Prototype


<even:searchEvents>
<query>deviceType:cgmesh eventName:up</query>
<count>4</count>	
<offset>0</offset>		
</even:searchEvents>

Parameters

Table 1. searchEvents Parameters
Parameter	Type	Description
query	string	Search query string.
count	integer	Number of results to retrieve.
offset	integer	Position of the first result.

Use the parameters in Table 2 and the options listed in searchEvents in the query.

Table 2. Query Parameters
Parameter	Delimiters	Options	Description
deviceType	=	asr1000 cgmesh cgnms cgr1000 db c800 ir800 ir500 ap800	Device type.
eventName	=	Options are listed in searchEvents .	User-defined name.
eventSeverity	=	CRITICAL MAJOR MINOR INFO	Severity level.
eventTime	>\|<\|>=\|<=	User defined.	UTC date and time in the format: yyyy-MM-dd HH:mm:ss:SSS.

Table 3. eventName Query Options
Event	Device Type	Supported Device(s)	Description
aaaFailure	cgr1000 ir8100	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The AAA server returned an error or was unreachable while attempting to authenticate a meter.
act2lFailure	cgr1000 ir8100	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The system rebooted after a hardware ACT2 failure, and the ACT2 process is being invoked.
archiveLogModeDisabled	db	Database	Database archive log mode is disabled. Hot backups are not permitted.
archiveLogModeEnabled	db	Database	Database archive log mode is enabled.
batteryFailure	cgr1000 ir8100	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The battery failed.
batteryLow	cgr1000 ir8100	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The battery charge is below the normal range.
batteryNormal	cgr1000 ir8100	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The battery charge is in the normal range.
bbuConfigFailure	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	The battery back up (BBU) configuration failed.
bbuFirmwareDownloadFailed	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	The BBU firmware download failed.
bbuFirmwareDownloadPassed	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	The BBU firmware download passed.
bbuFirmwareMismatchFound	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	A BBU firmware mismatch was found.
bbuFirmwareUpgradeFailure	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	The BBU firmware upgrade failed.
bbuLockOut	ir500	Cisco IR500 Series Routers	The BBU is locked out.
bbuPowerOff	cgr1000 ir8100 ir500	Cisco 1000 series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR500 Series Routers	The battery backup unit is not powered.
cd11IfRogueApDetectedNotif	ap800	Cisco 800 Series Integrated Access Points	-
cd11IfStationSwitchOverNotif	ap800	Cisco 800 Series Integrated Access Points	-
ciscoIetfDot11QosExtChangeNotif	ap800	Cisco 800 Series Integrated Access Points	-
ciscoWlanVlanWepChangeNotif	ap800	Cisco 800 Series Integrated Access Points	-
coldBoot	cgmesh ir500	Cisco Resilient Mesh Cisco IR500 Series Routers	A cold boot occurred or a mesh node registered due to cold boot.
configPushed	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco IR1100 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	(Industrial Operations Kit only) The group configuration pushed to CGRs.
configRollback	cgr1000 c800 ir800 ap800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco 800 Series Access Points Cisco IR1100 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	Configuration rollback required.
criticallyLowFRASpace	db	Database	The Flash Recovery Area (FRA) free space is critically low. Run database backup immediately or risk Cisco IoT FND and database failure.
criticallyLowTableSpace	db	Database	Database “USERS” table space is critically low. Contact your DBA immediately to add more space or risk Cisco IoT FND and database failure.
defaultRouteLost	cgmesh	Cisco Resilient Mesh	The mesh node lost the default route.
deviceAdded	cgr1000 c800 ir800 ir1800 ir8100 ir1100 cgmesh ir500 lgnn lgelectric	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR1100 Series Industrial Integrated Services Routers Cisco Connected Grid Mesh (CG-Mesh) Cisco 500 Series WPAN Industrial Routers (IR500) Cisco LoRaWAN Gateway for Network (LGNN) Cisco LoRaWAN Gateway for Electric (LGElectric)	(Industrial Operations Kit only) The EID of the new device.
deviceLocChanged	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	This event occurs when the GPS location changed in relation to the configured interval and distance thresholds.
deviceRemoved	cgr1000 c800 ir800 ir1100 ir1800 ir8100 cgmesh ir500 lgnn lgelectric	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco IR1100 Series Industrial Integrated Services Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	(Industrial Operations Kit only) The EID of the removed device.
deviceUnknown	IoT FND	Cisco IoT FND	Unknown device detected by NMS.
doorClose	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The device door is closed.
doorOpen	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The device door is open.
dot11AuthenticateFail	ap800	Cisco 800 Series Access Points	Dot11 authentication failed for the access point
dot11Deauthenticate	ap800	Cisco 800 Series Access Points	Dot11 deauthentication frame was detected.
dot11Disassociate	ap800	Cisco 800 Series Access Points	Dot11 disassociation frame was detected.
dot1xAuthFailed	cgmesh	Cisco Resilient Mesh	Dot1x authentication failed for the meter.
dot1xAuthFailure	cgmesh	Cisco Resilient Mesh	A Dot1x authentication failure was detected.
dot1xAuthFlood	cgmesh	Cisco Resilient Mesh	A Dot1x authentication flood was detected.
dot1xReauth	cgmesh	Cisco Resilient Mesh	Multiple attempts to send the mesh key to the meter failed. Re-authentication is in progress.
down	asr1000 cgmesh IoT FND cgr1000 c800 ir800 db ir500 ap800 ir1800 ir1100 ir8100 lgnn lgelectric	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh) Cisco IoT FND Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco Digital Building Series Switches (DB) Cisco 500 Series WPAN Industrial Routers (IR500) Cisco 800 Series Access Points Cisco Catalyst IR1800 Rugged Series Routers Cisco IR1100 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco LoRaWAN Gateway for Network (LGNN) Cisco LoRaWAN Gateway for Electric (LGElectric)	The specified device is down.
hardwareInsertion	cgr1000 c800 ir800 ir8100 ir1100 ir1800 cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers (ISR) Cisco 800 Series Industrial Integrated Services Routers (ISR) Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco IR1100 Series Industrial Integrated Services Routers Cisco Catalyst IR1800 Rugged Series Routers	A new piece of hardware was inserted into the chassis.
hardwareRemoval	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	Hardware was removed from the chassis.
HSMdown	IoT FND	Cisco IoT FND	The Hardware Security Module (HSM) is down.
HSMup	IoT FND	Cisco IoT FND	The HSM is down.
interfaceDown	asr1000 c800 ir800	Cisco ASR 1000 Series Aggregation Services Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The device interface is down.
interfaceUp	asr1000 c800 ir800	Cisco ASR 1000 Series Aggregation Services Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The device interface is up.
linecardFailure	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	Linecard failure detected.
linePowerFailure	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The line power supply for the device failed. This is different from the device being turned off, as happens in a power outage.
linePowerRestored	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The line power supply for the device is restored.
lowBattery	cgr1000 c800 ir800 ir500 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 500 Series Industrial Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The device battery backup unit charge is low or below the specified threshold.
lowFlashSpace	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The device is nearly out of memory on the flash partition.
lowFlashSpaceOk	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers.	The CGR available flash memory is within the specified threshold.
lowFRASpace	db	Database	Low database CGR space detected.
lowMemory	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers.	Available memory is below the specified threshold.
lowMemoryOk	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers.	Available memory is above the specified threshold.
manualCloseEvent	asr1000 cgmesh cgr1000 c800 ir800 ir8100	Cisco ASR 1000 Series Aggregation Services Routers Cisco Connected Resilient Mesh (CR-Mesh) Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers.	The issue state changed by admin to closed.
manualNMSAddrChange	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node registered due to a manual NMS address change.
manualReRegistration	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node registered due to manual registration
meshConnectivityLost	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node lost all connectivity.
meshLinkKeyTimeout	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node link key timed out.
meshUpgradeSuccess	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh module firmware upgrade was successful.
meterCertChange	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node registered due to a certificate change.
metricRetrievalFailure	asr1000 cgr1000 c800 ir800	Cisco ASR 1000 Series Aggregation Services Routers Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	Metric retrieval failed.
migratedToBetterPAN	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node migrated to a better PAN.
modemTemperatureColdAlarm	cgr1000 c800 ir800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The temperature of the modem module fell below specified levels.
modemTemperatureColdAlarmRecovery	cgr1000 c800 ir800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The modem alarm reset.
modemTemperatureWarmAlarm	cgr1000 c800 ir800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The temperature of the modem module fell above specified levels.
modemTemperatureWarmAlarmRecovery	cgr1000 c800 ir800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers	The modem alarm reset.
nmsAddrChange	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node registered due to an NMS address change.
nmsError	cgmesh	Cisco Connected Resilient Mesh (CR-Mesh)	The mesh node registered due to an NMS error.
normalFRASpace	db	Database	Database FRA space is normal.
normalTableSpace	db	Database	Database table space is normal.
outage	cgmesh cgr1000 c800 ir800 ir500 lgnn lgelectric	Cisco Resilient Mesh (CR-Mesh) Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 500 Series Industrial Routers Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	An outage was detected for this device.
portDown	cgr1000 c800 ir800 ap800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Access Points Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	Ethernet interface {0}/{1} is down.
portFailure	cgr1000 c800 ir800 ap800 ir1800 ir8100 ir1100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers	Syslog message corresponding to the port facility was generated.
portUp	cgr1000 c800 ir800 ap800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers.	Ethernet interface {0}/{1} is up.
powerSourceNormal	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The input power source is equal to or better than when system started.
powerSourceWarning	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	One or more input power source is not connected.
refreshMeshKeyFailed	asr1000 cgmesh	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh)	A refresh of the mesh key failed.
registered	asr1000 cgmesh	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh)	The event received is registered with NMS.
registrationFailure	cgr1000 c800 ir800 ap800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	Device registration failed.
registrationRequest	cgr1000 c800 ir800 ap800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	A registration request from a device was received.
registrationSuccess	cgr1000 c800 ir800 ap800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	Device registration was successful.
rejoinedWithNewIP	cgmesh	Cisco Resilient Mesh (CR-Mesh)	The mesh node registered with a new IP address.
restoration	cgmesh lgnn lgelectric	Cisco Resilient Mesh (CR-Mesh) Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	The device was restored from outage.
restorationRegistration	cgmesh lgnn lgelectric	Cisco Resilient Mesh (CR-Mesh) Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	The mesh node registered after an outage.
rplTreeReset	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The RPL tree version was reset to 2. Because the RPL tree is updated with data, versions increment. A value of 2 signifies a reset to its original initial state.
rplTreeSizeCritical	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	More than the maximum number of mesh nodes joined the RPL tree.
rplTreeSizeCriticalClear	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	Less than the maximum number of mesh nodes detected in the RPL tree.
rplTreeSizeMajor	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	More than the expected mesh nodes joined the RPL tree were detected.
rplTreeSizeMajorClear	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The expected number of mesh nodes in the RPL tree were detected.
rplTreeVersionReset	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The RPL tree version was reset to 2. Because the RPL tree is updated with data, versions increment. A value of 2 signifies a reset to its original initial state.
ruleEvent	asr1000 cgmesh IoT FND cgr1000 c800 ir800 db ir1100 ir8100 ir1800 lgnn lgelectric	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh) Cisco IoT FND Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Connected Grid Design Suite (CG-DS) Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	This is a rule-generated event.
sdcardRemovalAlarm	cgr1000	Cisco 1000 Series Connected Grid Routers	SD card removal detected, and an alarm sent.
signatureFailure	asr1000 cgmesh cgr1000 IoT FND c800 ir800 db ir500	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh) Cisco 1000 Series Connected Grid Routers Cisco IoT FND Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Connected Grid Design Suite (CG-DS) Cisco 500 Series Industrial Routers	Invalid signature reported by mesh nodes. If this event occurs, you must verify the certificate setup and that the mesh node and IoT FND are time synchronized.
softwareCrash	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers.	Software process failed with a stateless restart, indicating an interruption of a service. Messages are processed for crashes on supervisor modules and line cards.
systemSwInconsistent	cgr1000 c800 ir800 ir1800 ir1100 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	Inconsistency detected in software or file system.
temperatureMajorAlarm	cgr1000 c800 ir800 ir8100 ir1800 ir1100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR1100 Rugged Series Routers	A thermal sensor indicates that the temperature has reached the operating major threshold.
temperatureMajorRecovery	cgr1000 c800 ir800 ir1100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers	A major temperature alarm has recovered.
temperatureMinor	cgr1000 c800 ir800 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The device temperature reached the minor threshold.
temperatureMinorRecovery	cgr1000 c800 ir800 ir1100 ir8100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The minor temperature alarm has recovered.
timeMismatch	cgmesh	Cisco Resilient Mesh (CR-Mesh)	The NMS server time does not match the device local time.
timeMismatchResolved	cgmesh	Cisco Resilient Mesh (CR-Mesh)	The NMS server time matches the device local time.
tunnelDown	cgr1000 c800 ir800 ir8100 ir1100 ir1800	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers	The tunnel is down.
tunnelProvFailure	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	Tunnel provisioning failed.
tunnelProvRequest	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	A tunnel provisioning request was received from a device.
tunnelProvSuccess	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	Tunnel provisioning was successful.
tunnelUp	cgr1000 c800 ir800 ir1100 ir1800 ir8100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers	The tunnel is up.
unknown	asr1000 cgmesh IoT FND cgr1000 c800 ir800 ir500 ap800 db ir1100 ir1800 ir8100 lgnn lgelectric	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh) Cisco IoT FND Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 500 Series Industrial Routers Cisco 800 Series Industrial Access Points Cisco Connected Grid Design Suite (CG-DS) Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	The event received is not registered with NMS.
unknownRegReason	cgmesh	Cisco Reslient Mesh (CR-Mesh)	The mesh node registered for an unknown reason.
unknownWPANChange	cgmesh	Cisco Reslient Mesh (CR-Mesh)	The mesh node changed its WPAN for an unknown reason.
unsupported	cgr1000 c800 ir800 ap800 ir1800 ir8100 ir1100	Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco Catalyst IR1100 Rugged Series Routers	Unsupported device detected.
up	asr1000 cgmesh IoT FND cgr1000 c800 ir800 ap800 db ir1100 ir1800 ir8100 lgnn lgelectric	Cisco ASR 1000 Series Aggregation Services Routers Cisco Resilient Mesh (CR-Mesh) Cisco IoT FND Cisco 1000 Series Connected Grid Routers Cisco 800 Series Integrated Services Routers Cisco 800 Series Industrial Integrated Services Routers Cisco 800 Series Industrial Access Points Cisco Connected Grid Design Suite (CG-DS) Cisco Catalyst IR1100 Rugged Series Routers Cisco Catalyst IR1800 Rugged Series Routers Cisco Catalyst IR8100 Heavy Duty Series Routers Cisco LoRaWAN Gateway for Network (LGN) Cisco LoRaWAN Gateway for Electric (LGE)	The specified device is up.
veryLowFRASpace	db	Database	Very low database FRA space detected.
wpanWatchdogReload	cgr1000 ir8100	Cisco 1000 Series Connected Grid Routers Cisco Catalyst IR8100 Heavy Duty Series Routers.	The WatchDog reloaded the WPAN module. The bridge was unresponsive for more than 5 minutes and the WatchDog is enabled.

Results

Table 4. searchEvents Results
Field	Type	Description
subscriptionid	long	Subscription ID used by the listener to identify the subscription response origin.
events	List<EventDetail>	Details about the event.

searchEvents SOAP XML Request Format


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:searchEvents>
         <!--Optional:-->
         <query>deviceType:cgmesh eventName:up</query>
         <!--Optional:-->
         <count>4</count>
         <!--Optional:-->
         <offset>0</offset>
      </even:searchEvents>
   </soapenv:Body>
</soapenv:Envelope>

subscribeForEvents

This call streams a set of events to the API listener based on the query. Event subscriptions are based on device type, event name, or severity. Listener registers the URL and specifies the push window. After every configured eventPushWindowSec event push window, all new events that are received for the subscribed domain in this window are delivered to the registered URL. Subscription-based events notification uses the same query language as searchEvents, except that the eventTime attribute-based queries cannot be subscribed to and return unsuccessful subscription errors.

Note

You can ONLY subscribe or unsubscribe to events of the domain that you belong to. Only root users have the privilege to subscribe or unsubscribe to events of other domains.

Prototype


<even:subscribeForEvents>
<soapEndPointUrl>http://customer.network.com:11001/Process/Service/ProcessCellRouterStates/ReceiveEvents/EventPushService?wsdl</soapEndPointUrl>	
<query>deviceType:cgmesh eventName:registered</query>
<eventPushWindowSec>21</eventPushWindowSec>
<domain>root</domain>
</even:subscribeForEvents>

Parameters

Parameter

Type

Description

soapEndPointUrl

string

The address of the WSDL file–as implemented by your client–that receives event notifications from the IoT FND NB API. For more information, see Handling Event Notifications On the Client Side.

http://<server_address> :<port number> /<path><api> ?wsdl

For example:

http://localhost:8445/event?wsdl

soapEndPointUrl must point to the WSDL document that describes the listener application receiving the events. Ensure that the target namespace and service name parameters in the Web Services Description Language (WSDL) document conform to these default values:


target namespace
"http://pushevent.nbapi.cgms.cisco.com/"
service name
"EventPushService"

Note

Release 2.1 and later installations support https for soapEndPointUrl.

Functionality in IoT FND 1.1.3 and later installations

Some applications cannot set the default values for these parameters when generating the WSDL file. If this is the case, in IoT FND 1.1.3 and later installations you can set the following properties in the server/cgms/conf/cgms.properties file to match the values in the generated WSDL document:


eventSubscriberNamespace
="http://event.nbapi.cgms.mydomain.com/"
eventSubscriberServicename
="MyEventService"

The target namespace and service name parameters must match those specified in the cgms.properties file. If they are not specified in the cgms.properties file, they must match the default values.

Note

Only one set of these values is allowed in the cgms.properties file. If there are multiple subscribers, they must use the target namespace and service name parameter values specified in all WSDL documents pointed to in the soapEndPointUrl of the subscriptions.

query

string

The query string.

Note

The query language eventTime field cannot be inside the subscription.

eventPushWindowSec

integer

The event push window time, in seconds. The query executes after x seconds, and the results are pushed to the listener endpoint specified in the soapEndPointUrl WSDL file.

Domain

string

Specify the domain name to subscribe to events.

Results

Table 6. subscribeforEvents Response
Field	Type	Description
subscriptionId	long	Subscription ID

The QueryResult Status field indicates if the subscription succeeded or failed.

subscribeForEvents SOAP XML Request Format

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:subscribeForEvents>
         <!--Optional:-->
         <soapEndPointUrl>http://localhost</soapEndPointUrl>
         <!--Optional:-->          
         <query>deviceType:cgmesh eventName:registered</query>          
        <!--Optional:-->
         <eventPushWindowSec>60</eventPushWindowSec>
         <!--Mandatory field for new subscriptions from 4.9.0-->
         <!--To update subscriptions prior to 4.9.0, this field should be empty-->  
         <domain>root</domain>
      </even:subscribeForEvents>
   </soapenv:Body>
</soapenv:Envelope>

unSubscribeForEvents

This call unsubscribes the defined listener event query.

Prototype


<even:unSubscribeForEvents>
<query>deviceType:cgmesh eventName:registered</query>
<domain>root</domain>
</even:unSubscribeForEvents>

Parameters

Table 7. unSubscribeForEvents Parameters

Parameter

Type

Description

soapEndPointUrl

string

Address where the EventNbapiService WSDL is located.

http://<server_address> :<port number> /<path><api> ?wsdl

query

string

Query string.

Note

Query language eventTime field cannot be inside the subscription.

Domain

string

Specify the domain name to unsubscribe to events.

Results

Table 8. unSubscribeForEvents Results
Field	Type	Description
subscriptionId	long	Subscription ID

The QueryResult Status field indicates if the subscription succeeded or failed.

unSubscribeForEvents SOAP XML Request Format

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:unSubscribeForEvents>
         <!--Optional:-->
         <soapEndPointUrl>http://localhost</soapEndPointUrl>
         <!--Optional:--> 
         <query>deviceType:cgmesh eventName:registered</query>   
         <!--Mandatory field for new subscriptions from 4.9.0-->
         <!--To update subscriptions prior to 4.9.0, this field should be empty--> 
         <domain>root</domain>
      </even:unSubscribeForEvents>
   </soapenv:Body>
</soapenv:Envelope>

subscribeForCgmeshOutage

This call is similar to subscribeForEvents, except that it is for outage and restoration events. Up to 10 subscribers (listeners) at a time can register for these events.

Starting from Cisco IoT FND Release 5.1, this call streams events to the API listener based on the query. Outage Event subscriptions use device type and exclude filters. If you do not provide a query, the call pushes all outage and restoration events to the API listener regardless of device type.

Prototype


<even:subscribeForCgmeshOutage>
<soapEndPointUrl>http://128.107.109.98:8456/nbapi/pushevent?wsdl</soapEndPointUrl>
<query>deviceType:ir500 exclude:'Source of Outage Message = [Restoration Message]'</query>
<domain>root</domain>
</even:subscribeForCgmeshOutage>

Parameters

Table 9. subscribeForCgmeshOutage Parameters

Parameter

Type

Description

soapEndPointUrl

string

Address of the WSDL, implemented by your client that receives outage notifications from the Cisco IoT FND NB API.

For more information, see Handling Event Notifications On the Client Side.

http://<server_address> :<port number> /<path><api> ?wsdl

For example:

http://localhost:8445/outage?wsdl

Note

Release 2.1 and later installations support https for soapEndPointUrl.

Domain

string

Specify the domain name to subscribe to cgmesh outage events.

query

string

Search query string.

The event-Outage-push-sec parameter governs the period with which the CG-NMS pushes outage/restoration notifications to NBAPI subscribers. Here's an example to set event-Outage-push-sec to 30:


event-Outage-push-sec=30

Note

When Cisco IoT FND pushes outage events to subscribers, only subscribers that are up receive the events. The subscribers that are down (they do not respond) do not receive these events even after they come back online, but they receive the next outage event push.
For a very fast outage event push, set event-Outage-push-sec to a value as low as one second. If you set the push value to one second, Cisco IoT FND executes a job to find and push new events in the queue.
The default value is 10 seconds.

The event-Outage-BufferTime parameter governs the amount of time CG-NMS must suppress an outage notification before actually processing it. This is to avoid floods of momentary outages.

Note

The default value is 30 seconds.
This value defines the duration during which Cisco IoT FND suppresses an outage notification before processing it.
The port 61628 supports event-Outage-BufferTime

The allowed-outage-skew parameter addresses special cases where multiple PON outages are received within this timeframe. Cisco IoT FND treats these outages as a single outage event if their timestamps fall within the allowed skew.

Note

The default value is 1000ms (configured in granularity of ms).

Results

Table 10. Subscribe for CG-Mesh Outage Response
Parameter	Type	Description
subscriptionId	long	Subscription ID which can be used by the listener to identify for which subscription they are getting the response from.

The QueryResult Status field indicates if the subscription succeeded or failed.

subscribeForCgmeshOutage SOAP XML Request Format


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:subscribeForCgmeshOutage>
         <!--Optional:-->
         <soapEndPointUrl>http:/localhost</soapEndPointUrl>  
         <!--Mandatory field for new subscriptions from 4.9.0 -->
         <!-- To update subscriptions prior to 4.9.0, this field should be empty--> 
         <domain>root</domain>
         <!--Optional field for new subscriptions from 5.1.0 -->

         <!-- To update subscriptions prior to 5.1.0, the query parameter is not required or this field should be empty-->

        <query>deviceType:ir500 exclude:'Source of Outage Message = [Restoration Message]'</query>
      </even:subscribeForCgmeshOutage>
   </soapenv:Body>
</soapenv:Envelope>

unSubscribeForCgmeshOutage

This call unsubscribes the defined listener.

Prototype


<even:unSubscribeForCgmeshOutage>
<soapEndPointUrl>http://128.107.109.98:8456/nbapi/pushevent?wsdl</soapEndPointUrl>
<query>deviceType:ir500 exclude:'Source of Outage Message = [Restoration Message]'</query>
<domain>root</domain>
</even:unSubscribeForCgmeshOutage>

Parameters

The following table describes the parameters in the request.

Table 11. unSubscribeForCgmeshOutage Parameters

Parameter

Type

Description

soapEndPointUrl

string

Address of the Event WSDL service. The soapEndPointUrl identifies the subscription.

http://<server_address> :<port number> /<path><api> ?wsdl

Note

Release 2.1 and later installations support HTTPS for soapEndPointUrl.

Domain

string

Specify the domain name to unsubscribe to cgmesh outage events.

query

string

Search query string.

Results

Table 12. unSubscribeForCgmeshOutage Results
Parameter	Type	Description
subscriptionId	long	Subscription ID

The QueryResult Status field indicates if the subscription succeeded or failed.

unSubscribeForCgmeshOutage SOAP XML Request Format

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:unSubscribeForCgmeshOutage>
         <!--Optional:-->
         <soapEndPointUrl>http:/localhost</soapEndPointUrl>  
         <!--Mandatory field for new subscriptions from 4.9.0-->
         <!--To update subscriptions prior to 4.9.0, this field should be empty-->  
         <domain>root</domain>
         <!--Optional field for new subscriptions from 5.1.0 -->

         <!-- To update subscriptions prior to 5.1.0, this field should be empty-->

        <query>deviceType:ir500 exclude:'Source of Outage Message = [Restoration Message]'</query>
      </even:unSubscribeForCgmeshOutage>
   </soapenv:Body>
</soapenv:Envelope>

getAllEventSubscriptions

This API gets all the events or outage events for which you have subscribed in IoT FND.

Based on the value defined in the outageSubscription field, the API provides information on either all events or only outage events:

Set the value to "true" to get information on all the outage events.
Set the value to "false" to get information on all the events.

Prototype

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:even="http://event.nbapi.cgms.cisco.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <even:getAllEventSubscriptions>
         <!--Optional:-->
         <outageSubscription>false</outageSubscription>
          </even:getAllEventSubscriptions>
   </soapenv:Body>
</soapenv:Envelope>

Parameters

Table 13. getAllEventSubscriptions Parameters
Parameter	Type	Description
outageSubscription	boolean	Set the value to "true" to get the outage events. Set the value to false to get all events.
Domain	string	Specify the domain name to subscribe to all events or only outage events.

getAllEventSubscriptions SOAP XML Request Format

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"/>
   <soap:Body>
      <ns2:getAllEventSubscriptionsResponse xmlns:ns2="http://event.nbapi.cgms.cisco.com/">
         <eventSubscriptionListResult>
            <queryStatus>SUCCEEDED</queryStatus>
            <eventSubscriptions>
               <eventPushWindowSec>60</eventPushWindowSec>
               <id>1000</id>
               <isOutageSubscription>false</isOutageSubscription>
               <lastPushTime>0</lastPushTime>
               <queryString>deviceType:ir800</queryString>
               <soapEndPointUrl>http:/localhost</soapEndPointUrl>
               <domain>root</domain>
            </eventSubscriptions>
            <numberOfRecords>1</numberOfRecords>
            <showOutageSubscriptionOnly>false</showOutageSubscriptionOnly>
         </eventSubscriptionListResult>
      </ns2:getAllEventSubscriptionsResponse>
   </soap:Body>
</soap:Envelope>

Handling Event Notifications On the Client Side

When subscribing for an event type, your IoT FND NB API client must implement a Web Service that implements the WSDL for handling event notifications sent by the IoT FND NB API. The WSDL you must provide the receiveEvents() method, which the IoT FND NB API uses to send event notifications to your client.

Example

In the following figure, the IoT FND NB API client implements the Outage WSDL. When the client subscribes for outage events, IoT FND uses the IoT FND NB API to call the method receiveEvents() on the IoT FND NB API client.

Figure 1. Event Notification Handling

This is the Event XML that your client must implement to receive outage notifications from IoT FND.

Events and Outage Notification Handling WSDL (Client Side)

The clients must implement the WSDL file to receive notification on events and power outages. The WSDL file varies for different releases of IoT FND.

For IoT FND releases prior to 4.9.x, the WSDL file is same for both events and outage notifications.
For IoT FND release 4.9.x to 4.10.x, the WSDL file is different for events and outage notifications.
- Events
- Outages

WSDL File for Event and Outage Notification


<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:tns="http://pushevent.nbapi.cgms.cisco.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="eventPush"
	targetNamespace="http://pushevent.nbapi.cgms.cisco.com/">
	<wsdl:types>
		<xsd:schema targetNamespace="http://pushevent.nbapi.cgms.cisco.com/">
			<xsd:element name="receiveEvents" type="tns:receiveEvents" />
			<xsd:complexType name="receiveEvents">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="eventQueryResult"
						type="tns:eventQueryResult" />
				</xsd:sequence>
			</xsd:complexType>
			<xsd:complexType name="eventQueryResult">
				<xsd:complexContent>
					<xsd:extension base="tns:queryResult">
						<xsd:sequence>
							<xsd:element maxOccurs="unbounded" minOccurs="0"
								name="events" nillable="true" type="tns:eventDetail" />
							<xsd:element name="subscriptionId" type="xsd:long" />
						</xsd:sequence>
					</xsd:extension>
				</xsd:complexContent>
			</xsd:complexType>
			<xsd:complexType abstract="true" name="queryResult">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="queryId" type="xsd:string" />
					<xsd:element minOccurs="0" name="queryStatus" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>
			<xsd:complexType name="eventDetail">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="eid" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventMessage" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventSeverity" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventTime" type="xsd:long" />
					<xsd:element minOccurs="0" name="eventTypeName" type="xsd:string" />
					<xsd:element minOccurs="0" name="meterId" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>
		</xsd:schema>
	</wsdl:types>
	<wsdl:message name="receiveEvents">
		<wsdl:part element="tns:receiveEvents" name="receiveEvents" />
	</wsdl:message>
	<wsdl:portType name="EventPushService">
		<wsdl:operation name="receiveEvents">
			<wsdl:input message="tns:receiveEvents" />
		</wsdl:operation>
	</wsdl:portType>
	<wsdl:binding name="EventPushServiceBinding" type="tns:EventPushService">
		<soap:binding style="document"
			transport="http://schemas.xmlsoap.org/soap/http" />
		<wsdl:operation name="receiveEvents">
			<soap:operation soapAction="http://pushevent.nbapi.cgms.cisco.com/receiveEvents" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
		</wsdl:operation>
	</wsdl:binding>
	<wsdl:service name="EventPushService">
		<wsdl:port binding="tns:EventPushServiceBinding" name="EventPushService">
			<soap:address location="http://127.0.0.1:8008" />
		</wsdl:port>
	</wsdl:service>
</wsdl:definitions>

WSDL File for Outage Notification

Note

From IoT FND release 4.9.x to 4.10.x, the domain is specified in the request.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions
	xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:tns="http://pushevent.nbapi.cgms.cisco.com/"
	xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="eventPush" targetNamespace="http://pushevent.nbapi.cgms.cisco.com/">
	<wsdl:types>
		<xsd:schema targetNamespace="http://pushevent.nbapi.cgms.cisco.com/">
			<xsd:element name="receiveEvents" type="tns:receiveEvents" />
			<xsd:complexType name="receiveEvents">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="eventQueryResult" type="tns:eventQueryResult" />
				</xsd:sequence>
			</xsd:complexType>
			<xsd:complexType name="eventQueryResult">
				<xsd:complexContent>
					<xsd:extension base="tns:queryResult">
						<xsd:sequence>
							<xsd:element maxOccurs="unbounded" minOccurs="0" name="events" nillable="true" type="tns:eventDetail" />
							<xsd:element name="subscriptionId" type="xsd:long" />
						</xsd:sequence>
					</xsd:extension>
				</xsd:complexContent>
			</xsd:complexType>
			<xsd:complexType abstract="true" name="queryResult">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="queryId" type="xsd:string" />
					<xsd:element minOccurs="0" name="queryStatus" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>
			<xsd:complexType name="eventDetail">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="domain" type="tns:domain"/>
					<xsd:element minOccurs="0" name="eid" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventMessage" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventSeverity" type="xsd:string" />
					<xsd:element minOccurs="0" name="eventTime" type="xsd:long" />
					<xsd:element minOccurs="0" name="eventTypeName" type="xsd:string" />
					<xsd:element minOccurs="0" name="meterId" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>
			<xsd:complexType name="domain">
				<xsd:sequence>
					<xsd:element minOccurs="0" name="id" type="xsd:long"/>
					<xsd:element minOccurs="0" name="name" type="xsd:string"/>
				</xsd:sequence>
			</xsd:complexType>
		</xsd:schema>
	</wsdl:types>
	<wsdl:message name="receiveEvents">
		<wsdl:part element="tns:receiveEvents" name="receiveEvents" />
	</wsdl:message>
	<wsdl:portType name="EventPushService">
		<wsdl:operation name="receiveEvents">
			<wsdl:input message="tns:receiveEvents" />
		</wsdl:operation>
	</wsdl:portType>
	<wsdl:binding name="EventPushServiceBinding" type="tns:EventPushService">
		<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />
		<wsdl:operation name="receiveEvents">
			<soap:operation soapAction="http://pushevent.nbapi.cgms.cisco.com/receiveEvents" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
		</wsdl:operation>
	</wsdl:binding>
	<wsdl:service name="EventPushService">
		<wsdl:port binding="tns:EventPushServiceBinding" name="EventPushService">
			<soap:address location="http://10.88.202.38:33005/FNDIncomingEvent" />
		</wsdl:port>
	</wsdl:service>
</wsdl:definitions>

Push Mechanisms

Push mechanisms work only when the NMS server has successfully completed the subscription, as defined in the subscribeForEvents and subscribeForCgmeshOutage API methods.

A successful subscription leads to generation of the Subscription ID that is sent to the subscriber. The subscriber uses the Subscription ID to track the event push.

IoT FND runs a Scheduled Job every x seconds. Seconds are configurable during the subscription by using the event-Outage-push-sec global parameter defined in the /opt/cgms/conf/cgms.properties file. After every x seconds, IoT FND generates an EventList and pushes it to the subscribers defined in the soapEndPointUrl.

The web service to implement on the NMS side is:


public void receiveEvents(EventQueryResult eventQueryResult) throws java.rmi.RemoteException;

QueryResult

The QueryResult Status field indicates if the subscription succeeded or failed. The following table describes the parameters in the response.

Table 14. EventQueryResult Response
Field	Type	Description
subscriptionId	long	Subscription ID used by the listener to identify which subscription the response is from.
events	List<EventDetail>	Details about the event.

The following table describes the parameters in the EventDetail results.

Table 15. EventDetail Response
Field	Type	Description
eid	string	Serial number for the CGR and MAC address for the mesh endpoint.
eventMessage	string	Message related to the event.
eventTime	long	Time in milliseconds.
eventTypeName	string	Type of event
meterId	string	Meter ID corresponding to the EID. For this value to return, it must be included in the import file when importing meters in IoT FND.

Example

This is an example of the XML content that the subscriber receives:


<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
   <env:Header>
      <seam:conversationId xmlns:seam="http://www.jboss.org/seam/webservice">110</seam:conversationId>
   </env:Header>
   <env:Body>
      <ns2:searchEventsResponse xmlns:ns2="http://event.nbapi.cgms.cisco.com/">
         <eventQueryResult>
            <queryId></queryId>
            <queryStatus>SUCCEEDED</queryStatus>
            <events>
               <eid>NE01</eid>
               <eventMessage>Device is Up</eventMessage>
               <eventSeverity>INFO</eventSeverity>
               <eventTime>1314656731899</eventTime>
               <eventTypeName>up</eventTypeName>
               <meterId>Sjc123</meterId>
            </events>
            <events>
               <eid>NE01</eid>
               <eventMessage>Outage detected on this device</eventMessage>
               <eventSeverity>CRITICAL</eventSeverity>
               <eventTime>1314656731908</eventTime>
               <eventTypeName>outage</eventTypeName>
               <meterId>Sjc123</meterId>
            </events>
            <events>
               <eid>NE01</eid>
               <eventMessage>Device has been Restored from Outage</eventMessage>
               <eventSeverity>INFO</eventSeverity>
               <eventTime>1314656771923</eventTime>
               <eventTypeName>restoration</eventTypeName>
               <meterId>Sjc123</meterId>
            </events>
            <events>
               <eid>NE01</eid>
               <eventMessage>Device is Up</eventMessage>
               <eventSeverity>INFO</eventSeverity>
               <eventTime>1314656771933</eventTime>
               <eventTypeName>up</eventTypeName>
               <meterId>Sjc123</meterId>
            </events>
            <subscriptionId>2</subscriptionId>
         </eventQueryResult>
      </ns2:searchEventsResponse>
   </env:Body>
</env:Envelope>

The subscriptionId XML element (<subscriptionId>2</subscriptionId>) tells the receiver that this push is for the subscription ID equal to 2.

North Bound API User Guide for Cisco IoT Field Network Director, Release 4.x

Bias-Free Language

Results

Chapter: Event API

Event API

Using the Event API

Event API Method Calls

searchEvents

Prototype

Parameters

Results

searchEvents SOAP XML Request Format

subscribeForEvents

Prototype

Parameters

Results

subscribeForEvents SOAP XML Request Format

unSubscribeForEvents

Prototype

Parameters

Results

unSubscribeForEvents SOAP XML Request Format

subscribeForCgmeshOutage

Prototype

Parameters

Results

subscribeForCgmeshOutage SOAP XML Request Format

unSubscribeForCgmeshOutage

Prototype

Parameters

Results

unSubscribeForCgmeshOutage SOAP XML Request Format

getAllEventSubscriptions

Prototype

Parameters

getAllEventSubscriptions SOAP XML Request Format

Handling Event Notifications On the Client Side

Example

Events and Outage Notification Handling WSDL (Client Side)

Push Mechanisms

QueryResult

Example

Was this Document Helpful?

Contact Cisco