{"type":"api","title":"Get Total Count For Device States","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":["Real-Time Monitoring - Device Control"],"description":"Get number of vedges and vsmart device in different control states","operationId":"getTotalCountForDeviceStates","parameters":[{"name":"isCached","in":"query","description":"Device State cached","schema":{"type":"boolean","default":false}},{"name":"site-id","in":"query","description":"Optional site ID to filter devices","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"Device state count":{"description":"Device state count","value":{"data":[{"name":"ControlStatus","count":7,"detailsURL":"","status":"error","statusList":[{"name":"Controlup","status":"up","message":"devicesup","detailsURL":"/dataservice/device/control/networksummary?state=up","count":7},{"name":"Partial","status":"warning","message":"devicesdown","detailsURL":"/dataservice/device/control/networksummary?state=partial","count":0},{"name":"Controldown","status":"error","message":"devicesdown","detailsURL":"/dataservice/device/control/networksummary?state=down","count":0}]}]}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Device Monitoring-read","method":"get","path":"/device/control/count"}}