{"type":"api","title":"Get Bandwidth Distribution","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 - Interface Statistics"],"description":"Get bandwidth distribution","operationId":"getBandwidthDistribution","parameters":[{"name":"site-id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"avg_down_capacity_percentage":{"type":"number"},"avg_up_capacity_percentage":{"type":"number"},"bw_down":{"type":"integer","format":"int64"},"bw_up":{"type":"number"},"count":{"type":"integer","format":"int64"},"interface":{"type":"string"},"max_down_capacity_percentage":{"type":"number"},"max_up_capacity_percentage":{"type":"number"},"min_down_capacity_percentage":{"type":"number"},"min_up_capacity_percentage":{"type":"integer","format":"int32"},"range":{"type":"string"},"vdevice_name":{"type":"string"}},"$$ref":"#/components/schemas/CapacityRespData"}},"distribution":{"type":"object","properties":{"100":{"type":"integer","format":"int64"},"0-25":{"type":"integer","format":"int64"},"25-50":{"type":"integer","format":"int64"},"50-75":{"type":"integer","format":"int64"},"75-100":{"type":"integer","format":"int64"},"uncategorized":{"type":"integer","format":"int64"}},"$$ref":"#/components/schemas/CapDistribution"}},"$$ref":"#/components/schemas/CapacityResp"},"examples":{"Bandwidth Distribution":{"description":"Bandwidth Distribution","value":{"query":{"condition":"AND","rules":[{"value":["24"],"field":"entry_time","type":"date","operator":"last_n_hours"},{"value":["1.1.60.7"],"field":"vdevice_name","type":"string","operator":"in"}]},"aggregation":{"field":[{"property":"family","size":200,"sequence":1}],"metrics":[{"property":"octets","type":"sum","order":"desc"}]}}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"get","path":"/statistics/interface/ccapacity/distribution"}}