{"type":"api","title":"Get Alarm Details","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 alarm details for given UUID","operationId":"getAlarmDetails","parameters":[{"name":"alarm_uuid","in":"path","description":"Alarm UUID","required":true,"schema":{"type":"string"}},{"name":"includeTenants","in":"query","description":"Specify whether the tenant alarms need to be visible or not from provider view.","schema":{"type":"boolean"}}],"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":1717671791755},"data":[{"entry_time":1717671338582,"uuid":"59a93996-719d-4550-bbd5-1ba8c60b3d31","message":"failed to sync root cert to device (ca9ec973-ba93-48ea-ad40-dea43b32d9f5, vm10, 172.16.255.20) on 06 Jun 2024 10:55:38 UTC","type":"rootca-sync-failure","component":"System","severity":"Critical","severity_number":1,"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":1717671338582,"tenant":"default","eventname":"rootca-sync-failure","receive_time":1717671338582,"system_ip":"172.16.255.20","host_name":"vm10","site_id":"","update_time":1717671338595}]},"$$ref":"#/components/examples/ComViptelaVmanageServerCorrelationEngineResponseUuid"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Alarms-read","method":"get","path":"/alarms/uuid/{alarm_uuid}"}}