Get Non Viewed Alarms - Cisco Catalyst SD-WAN Manager API, Release 20.18

{"type":"api","title":"Get Non Viewed Alarms","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 alarms which are not acknowledged by the user.","operationId":"getNonViewedAlarms","parameters":[{"name":"state","in":"query","description":"Specify the not viewed alarm state to be fetched. Allowed values : [\"active\", \"cleared\"] ","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":{"Not viewed alarms":{"description":"Not viewed alarms","value":{"header":{"generatedOn":1717671984421,"viewKeys":{"uniqueKey":[],"preferenceKey":"grid-Alarms"},"columns":[{"title":"Impacted Entities","property":"values_short_display","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","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","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":"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"}]},"data":[{"severity_number":1,"entry_time":1717671939079,"uuid":"5f573c27-4264-4b9b-8b46-4a415fc583a1","message":"failed to sync root cert to device (353e002d-1d66-403e-b94b-86a890761803, vm9, 172.16.255.19) on 06 Jun 2024 11:05:39 UTC","type":"rootca-sync-failure","component":"System","severity":"Critical","devices":[{"system-ip":"172.16.255.19"}],"active":"true","values":[{"system-ip":"172.16.255.19","host-name":"vm9"}],"acknowledged":"false","cleared_by":"","suppressed":"false","suppressed_by":"","rulename":"rootca-sync-failure","rule_name_display":"ROOTCA_SYNC_FAILURE","values_short_display":[{"host-name":"vm9","system-ip":"172.16.255.19"}],"cleared_time":0,"statcycletime":1717671939079,"tenant":"default","eventname":"rootca-sync-failure","receive_time":1717671939079,"system_ip":"172.16.255.19","host_name":"vm9","site_id":""},{"severity_number":1,"entry_time":1717671939079,"uuid":"3ad7e9e2-df6e-43f7-bf1b-a947b3274e7e","message":"failed to sync root cert to device (ca9ec973-ba93-48ea-ad40-dea43b32d9f5, vm10, 172.16.255.20) on 06 Jun 2024 11:05:39 UTC","type":"rootca-sync-failure","component":"System","severity":"Critical","devices":[{"system-ip":"172.16.255.20"}],"active":"true","values":[{"system-ip":"172.16.255.20","host-name":"vm10"}],"acknowledged":"false","cleared_by":"","suppressed":"false","suppressed_by":"","rulename":"rootca-sync-failure","rule_name_display":"ROOTCA_SYNC_FAILURE","values_short_display":[{"host-name":"vm10","system-ip":"172.16.255.20"}],"cleared_time":0,"statcycletime":1717671939079,"tenant":"default","eventname":"rootca-sync-failure","receive_time":1717671939079,"system_ip":"172.16.255.20","host_name":"vm10","site_id":""}]},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineResponseNotviewed"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Alarms-read","method":"get","path":"/alarms/notviewed"}}