{"type":"api","title":"Devices","meta":{"id":"/apps/pubhub/media/dna-center-235/0e427c513038595590fc5a0593cb0e208dd78571/2192edf3-d24e-3461-ab8c-12a97b547df4","swagger":"2.0","info":{"description":"Cisco DNA Center Platform v. 2.3.5","version":"2.3.5","title":"Intent API"},"schemes":["https"],"x-parser-conf":{"expand":0,"labelConfig":{"endpoint":"summary"}}},"spec":{"operationId":"devices","tags":["Devices"],"summary":"Devices","description":"Intent API for accessing DNA Assurance Device object for generating reports, creating dashboards or creating additional value added services.","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"deviceRole","description":"The device role (One of CORE, ACCESS, DISTRIBUTION, ROUTER, WLC, AP)","default":"","required":false,"type":"string","in":"query"},{"name":"siteId","description":"Assurance site UUID value","default":"","required":false,"type":"string","in":"query"},{"name":"health","description":"The device overall health (One of POOR, FAIR, GOOD)","default":"","required":false,"type":"string","in":"query"},{"name":"startTime","description":"UTC epoch time in milliseconds","required":false,"type":"number","in":"query"},{"name":"endTime","description":"UTC epoch time in miliseconds","required":false,"type":"number","in":"query"},{"name":"limit","description":"Max number of device entries in the response (default to 50. Max at 1000)","required":false,"type":"number","in":"query"},{"name":"offset","description":"The offset of the first device in the returned data","required":false,"type":"number","in":"query"}],"responses":{"200":{"description":"The request was successful. The result is contained in the response body.","schema":{"type":"object","properties":{"version":{"type":"string"},"totalCount":{"type":"integer"},"response":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"model":{"type":"string"},"osVersion":{"type":"string"},"ipAddress":{"type":"string"},"overallHealth":{"type":"integer"},"issueCount":{"type":"number"},"location":{"type":"string"},"deviceFamily":{"type":"string"},"deviceType":{"type":"string"},"macAddress":{"type":"string"},"interfaceLinkErrHealth":{"type":"integer"},"cpuUlitilization":{"type":"integer"},"cpuHealth":{"type":"integer"},"memoryUtilizationHealth":{"type":"integer"},"memoryUtilization":{"type":"integer"},"interDeviceLinkAvailHealth":{"type":"integer"},"reachabilityHealth":{"type":"string"},"clientCount":{"type":"object","properties":{"radio0":{"type":"number"},"radio1":{"type":"integer"},"Ghz24":{"type":"number"},"Ghz50":{"type":"integer"}}},"interferenceHealth":{"type":"object","properties":{"radio0":{"type":"integer"},"radio1":{"type":"integer"},"Ghz24":{"type":"integer"},"Ghz50":{"type":"integer"}}},"noiseHealth":{"type":"object","properties":{"radio1":{"type":"integer"},"Ghz50":{"type":"integer"}}},"airQualityHealth":{"type":"object","properties":{"radio0":{"type":"integer"},"radio1":{"type":"integer"},"Ghz24":{"type":"integer"},"Ghz50":{"type":"integer"}}},"utilizationHealth":{"type":"object","properties":{"radio0":{"type":"integer"},"radio1":{"type":"integer"},"Ghz24":{"type":"integer"},"Ghz50":{"type":"integer"}}}}}}},"$$ref":"#/definitions/DevicesResponse"}},"400":{"description":"The client made a request that the server could not understand (for example, the request syntax is incorrect)."},"401":{"description":"The client's authentication credentials included with the request are missing or invalid."},"404":{"description":"The client made a request for a resource that does not exist."},"500":{"description":"The server could not fulfill the request."}},"__originalOperationId":"devices","method":"get","path":"/dna/intent/api/v1/device-health"}}