Get Page Monitoring Alarms Details 1203 - Cisco Catalyst SD-WAN Manager API, Release 20.18

{"type":"api","title":"Get Page Monitoring Alarms Details 1203","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/d2f02ba2-fd0d-3a26-bcc5-feafc8f24d17","info":{"title":"Monitoring and Troubleshooting","description":"Includes API operations for the following:\n- Real-time monitoring\n- Accessing statistics APIs and statistics bulk APIs\n- Retrieving device state\n- Managing alarms and events\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Monitoring - Alarms Details"],"description":"Get paginated alarms","operationId":"getPage_MonitoringAlarmsDetails_1203","parameters":[{"name":"query","in":"query","description":"Query","schema":{"type":"string"},"examples":{"Get alarms filter by severity":{"description":"Get alarms filter by severity","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"severity","operator":"in","type":"string","value":["Critical"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterBySeverity"},"Get alarms filter by site-id":{"description":"Get alarms filter by site-id","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"site_id","operator":"in","type":"string","value":["400","500"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterBySites"},"Get active alarms":{"description":"Get active alarms","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"active","type":"boolean","value":["true"],"operator":"equal"}]}},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterByActive"},"Get alarms filter by type":{"description":"Get alarms filter by type","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"rule_name_display","operator":"in","type":"string","value":["Memory_Usage"]}]},"size":10000},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterByType"},"Get alarms filter by hours":{"description":"Get alarms filter by hours","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterByHours"},"Get alarms filter by system ip":{"description":"Get alarms filter by system ip","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","operator":"last_n_hours","type":"date","value":["10"]},{"field":"system_ip","operator":"in","type":"string","value":["1.1.1.1"]}]},"size":100},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterBySystemIp"},"Get alarms filter between dates":{"description":"Get alarms filter between dates","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","type":"date","value":["2024-04-30T19:30:00 UTC","2024-05-30T17:30:00 UTC"],"operator":"between"}]},"size":10000},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineRequestFilterBetweenDates"}}},{"name":"scrollId","in":"query","description":"Scroll ID","schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of alarms per page","schema":{"type":"integer","format":"int32"}},{"name":"site-id","in":"query","description":"Specify the site-id to filter the alarms","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"acknowledged":{"type":"boolean"},"active":{"type":"boolean"},"cleared_by":{"type":"string","format":"uuid","example":"0a0dca23-11d5-4014-bfbb-976d3c6de492"},"cleared_events":{"type":"array","items":{"type":"string","format":"uuid"}},"cleared_time":{"type":"integer","format":"int64","example":1652894923722},"component":{"type":"string","example":"Schedule Telemetry collection"},"consumed_events":{"type":"array","items":{"type":"object","$$ref":"#/components/schemas/OneOfAlarmConsumedEventsItems"}},"devices":{"type":"array","items":{"type":"object","properties":{"system-ip":{"type":"string","example":"19.19.19.1"}},"$$ref":"#/components/schemas/AlarmDevices"}},"entry_time":{"type":"integer","format":"int64","example":1652906591837},"eventname":{"type":"string","example":"telemetry-data-collection-failure"},"id":{"type":"string","example":"HHbp2IABUbH5BDy9BhJe"},"message":{"type":"string","example":"Scheduled telemetry data collection failed on 19.19.19.1"},"possible_causes":{"type":"array","items":{"type":"string"}},"receive_time":{"type":"integer","format":"int64"},"rule_name_display":{"type":"string","example":"Telemetry data save failed"},"rulename":{"type":"string","example":"cpu-usage"},"severity":{"type":"string","enum":["Minor","Major","Critical","Medium"]},"severity_number":{"type":"integer","format":"int64","example":4},"site_id":{"type":"integer","format":"int64","example":100},"statcycletime":{"type":"integer","format":"int64"},"suppressed":{"type":"boolean","example":false},"suppressed_by":{"type":"object","example":{"system-ip":{"type":"string","example":"172.16.255.11"},"component":{"type":"string","example":"BFD"}}},"system_ip":{"type":"string","example":"172.16.255.26"},"tenant":{"type":"string","example":"default"},"type":{"type":"string","example":"Telemetry data save failed"},"uuid":{"type":"string","format":"uuid","example":"f6f83721-3a69-42d1-841f-94e015957fb7"},"values":{"type":"array","items":{"type":"object","properties":{"empty":{"type":"boolean"}},"additionalProperties":{"type":"string"},"$$ref":"#/components/schemas/GeneralSchema"}},"values_short_display":{"type":"array","items":{"type":"object","properties":{"empty":{"type":"boolean"}},"additionalProperties":{"type":"string"},"$$ref":"#/components/schemas/GeneralSchema"}}},"description":"Represents any kind of alarm","$$ref":"#/components/schemas/Alarm"}},"pageInfo":{"type":"object","properties":{"count":{"type":"integer","description":"number of alarms to be fetched","format":"int64"},"endTime":{"type":"integer","description":"end time of alarms to be fetched","format":"int64"},"startTime":{"type":"integer","description":"start time of alarms to be fetched","format":"int64"}},"$$ref":"#/components/schemas/PageInfo"}},"description":"AlarmResponse is used for GET/POST /alarms call.","$$ref":"#/components/schemas/AlarmResponse"},"examples":{"Response":{"description":"Response","value":{"header":{"generatedOn":1717672304804,"viewKeys":{"uniqueKey":[],"preferenceKey":"grid-raw_alarm"},"columns":[{"title":"Impacted Entities","property":"values_short_display","minWidth":250,"dataType":"jsonArray"},{"title":"Impacted Entities Details","property":"values","hideable":true,"visible":false,"minWidth":250,"dataType":"jsonArray"},{"title":"Severity","property":"severity","display":"iconAndText","iconProperty":"severity","hideable":false,"icon":[{"key":"Minor","value":"images/event_minor.png"},{"key":"Major","value":"images/event_major.png"},{"key":"Critical","value":"images/event_critical.png"},{"key":"Medium","value":"images/event_other.png"}],"minWidth":70,"dataType":"string"},{"title":"Alarm Name","property":"rule_name_display","hideable":false,"minWidth":160,"dataType":"string"},{"title":"Message","property":"message","minWidth":250,"dataType":"string"},{"title":"Date & Time","property":"entry_time","displayFormat":"DD MMM YYYY h:mm:ss A z","inputFormat":"unix-time","hideable":false,"minWidth":200,"dataType":"date"},{"title":"Cleared Date & Time","property":"cleared_time","displayFormat":"DD MMM YYYY h:mm:ss A z","inputFormat":"unix-time","minWidth":200,"dataType":"date"}],"fields":[{"property":"values_short_display","dataType":"jsonArray"},{"property":"values","dataType":"jsonArray"},{"property":"severity","dataType":"string","display":"iconAndText"},{"property":"rule_name_display","dataType":"string"},{"property":"message","dataType":"string"},{"property":"possible_causes","dataType":"string"},{"property":"entry_time","dataType":"date"},{"property":"cleared_time","dataType":"date"},{"property":"uuid","dataType":"string"},{"property":"type","dataType":"string"},{"property":"component","dataType":"string"},{"property":"severity_number","dataType":"number"},{"property":"devices","dataType":"object"},{"property":"active","dataType":"boolean"},{"property":"consumed_events","dataType":"false"},{"property":"values","dataType":"object"},{"property":"acknowledged","dataType":"boolean"},{"property":"cleared_events","dataType":"string"},{"property":"cleared_by","dataType":"string"}],"chart":{}},"data":[{"entry_time":1717505999936,"uuid":"edc2ed16-88c1-4a06-8bc7-19cfb489131c","message":"The interface admin-state changed to down","type":"interface-admin-state-change","component":"VPN","severity":"Critical","severity_number":1,"devices":"[{\"system-ip\":\"172.16.255.26\"}]","active":"true","consumed_events":"","values":"[{\"host-name\":\"vm16\",\"system-ip\":\"172.16.255.26\",\"if-name\":\"ge0/0\",\"new-admin-state\":\"down\",\"vpn-id\":\"0\"}]","acknowledged":"true","possible_causes":"","cleared_events":"","cleared_by":"","suppressed":"false","suppressed_by":"","rulename":"interface-admin-state-change","rule_name_display":"Interface_Admin_State_Change","values_short_display":"[{\"host-name\":\"vm16\",\"system-ip\":\"172.16.255.26\",\"if-name\":\"ge0/0\",\"new-admin-state\":\"down\"}]","cleared_time":0,"statcycletime":1717505999936,"tenant":"default","eventname":"interface-admin-state-change","receive_time":1717506427663,"system_ip":"172.16.255.26","host_name":"vm16","site_id":"","update_time":1717670310269}],"pageInfo":{"startTime":"1717505999936","endTime":"1717505999936","scrollId":"o1ZSObpt5WS4AbmFImwHaC6D1fGWs3j5sGX9O0bNlQErayGcAWysadCDWPV9qUmygzrXpVREKLV2oz8DKCxUrmscYXIEaUkxAJ0RXn3rnhPWmsRLAjs7mIOj","hasMoreData":true,"count":1,"totalCount":3074}},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineResponsePage"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Alarms-read","method":"get","path":"/alarms/page"}}