{"type":"api","title":"Nping Device","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":["Troubleshooting Tools - Device Connectivity"],"description":"NPing device","operationId":"npingDevice","parameters":[{"name":"deviceIP","in":"path","description":"Device IP","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Ping parameter","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"string","example":"5"},"destPort":{"type":"string","example":"22"},"df":{"type":"string","example":"true"},"host":{"type":"string","example":"3::2"},"interfaceIP":{"type":"string","example":"3::1"},"mtu":{"type":"string","example":"128"},"probeType":{"type":"string","example":"tcp"},"rapid":{"type":"string","example":"true"},"size":{"type":"string","example":"128"},"source":{"type":"string","example":"3::1"},"sourcePort":{"type":"string","example":"22"},"tos":{"type":"string","example":"1"},"ttl":{"type":"string","example":"1"},"vpn":{"type":"string","example":"0"}},"$$ref":"#/components/schemas/NPingRequest"},"examples":{"Ping parameter":{"description":"Ping parameter","value":{"host":"10.1.12.16","probeType":"icmp","source":"10.1.12.15","interfaceIP":"10.1.12.15","vpn":"0"}}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"avgRoundTrip":{"type":"number","example":3.964},"lossPercentage":{"type":"number","example":0},"maxRoundTrip":{"type":"number","example":14.43},"minRoundTrip":{"type":"number","example":1.221},"packetsReceived":{"type":"number","example":5},"packetsTransmitted":{"type":"number","example":5},"rawOutput":{"type":"array","items":{"type":"string"}}},"$$ref":"#/components/schemas/NPingResponse"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Tools-read","method":"post","path":"/device/tools/nping/{deviceIP}"}}