Subscribing to alarms in the target system
The probe sends a REST API request to subscribe to a query and to initiate a WebSocket connection with Cisco APIC to listen for push notifications. A notification is generated by Cisco APIC when a new fault is created, updated or deleted because of a user or system initiated action that changes the result of an active subscribed query.
The query response (with the subscription request) contains
a subscription identifier (subscriptionId
) that you
use to refresh the subscription and to identify future notifications
from this subscription. To continue to receive event notifications,
you must periodically refresh each subscription during your API session.
To refresh a subscription, send an HTTP GET
message
to the subscriptionRefresh
API method with the parameter
ID set to the subscriptionId
. The default timeout
period for a subscription in Cisco APIC is one minute.
Alarm subscription requests are configured by the following properties in the ciscoApicTransport.properties file:
- subscribeRequestURI
- subscribeRequestMethod
- subscribeRequestContent
- subscribeRefreshURI
- subscribeRefreshMethod
- subscribeRefreshContent
- subscribeRefreshInterval
For details about these properties, see Configuring the transport module.