{"type":"api","title":"Get Synced Device Interface","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 - Interface"],"description":"Get device interfaces synchronously","operationId":"getSyncedDeviceInterface","parameters":[{"name":"vpn-id","in":"query","description":"VPN Id","schema":{"type":"string"}},{"name":"ifname","in":"query","description":"IF Name","schema":{"type":"string","enum":["ge0/0","ge0/1","ge0/2","ge0/3","ge0/4","ge0/5","ge0/6","ge0/7","system","eth0"]}},{"name":"af-type","in":"query","description":"AF Type","schema":{"type":"string","enum":["ipv4","ipv6"]}},{"name":"deviceId","in":"query","description":"deviceId - Device IP","required":true,"schema":{"type":"string","example":"169.254.10.10"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"Device interface":{"description":"Device interface","value":{"data":[{"vdevice-name":"172.16.255.11","if-admin-status":"Up","duplex":"full","tcp-mss-adjust":"1416","@rid":855,"ifname":"ge0/1","af-type":"ipv4","shaping-rate":0,"if-oper-status":"Up","auto-neg":"false","ifindex":2,"if-tracker-status":"NA","createTimeStamp":1647315879734,"secondary-address":"","vpn-id":"0","vdevice-host-name":"vm1","mtu":"1500","ipv6-address":"-","secondary":"false","ip-address":"10.0.26.11/24","hwaddr":"52:54:00:db:d9:1b","speed-mbps":"1000","vdevice-dataKey":"172.16.255.11-0-ge0/1-ipv4","vmanage-system-ip":"172.16.255.11","lastupdated":1647315879722,"port-type":"service","encap-type":"null"},{"vdevice-name":"172.16.255.11","if-admin-status":"Up","duplex":"full","tcp-mss-adjust":"1416","@rid":869,"ifname":"ge0/2","af-type":"ipv4","shaping-rate":0,"if-oper-status":"Up","auto-neg":"false","ifindex":3,"allow-service":"dhcpdnsicmphttps","if-tracker-status":"NA","createTimeStamp":1647315880679,"secondary-address":"","vpn-id":"0","vdevice-host-name":"vm1","mtu":"1500","ipv6-address":"-","secondary":"false","ip-address":"10.0.5.11/24","hwaddr":"52:54:00:5b:92:ab","speed-mbps":"1000","vdevice-dataKey":"172.16.255.11-0-ge0/2-ipv4","vmanage-system-ip":"172.16.255.11","lastupdated":1647315879722,"port-type":"transport","encap-type":"null"},{"ifindex":4,"vdevice-name":"172.16.255.11","if-tracker-status":"NA","if-admin-status":"Down","createTimeStamp":1647315881312,"tcp-mss-adjust":"1416","vpn-id":"0","vdevice-host-name":"vm1","mtu":"1500","ipv6-address":"-","hwaddr":"52:54:00:36:5b:37","ip-address":"-","vdevice-dataKey":"172.16.255.11-0-ge0/3-ipv4","@rid":883,"ifname":"ge0/3","vmanage-system-ip":"172.16.255.11","af-type":"ipv4","lastupdated":1647315879722,"shaping-rate":0,"port-type":"service","if-oper-status":"Down","encap-type":"null"},{"vdevice-name":"172.16.255.11","if-admin-status":"Up","duplex":"full","tcp-mss-adjust":"1416","@rid":897,"ifname":"ge0/4","af-type":"ipv4","shaping-rate":0,"if-oper-status":"Up","auto-neg":"false","ifindex":5,"if-tracker-status":"NA","createTimeStamp":1647315882880,"secondary-address":"","vpn-id":"0","vdevice-host-name":"vm1","mtu":"1500","ipv6-address":"-","secondary":"false","ip-address":"10.0.7.11/24","hwaddr":"52:54:00:67:74:f1","speed-mbps":"1000","vdevice-dataKey":"172.16.255.11-0-ge0/4-ipv4","vmanage-system-ip":"172.16.255.11","lastupdated":1647315879722,"port-type":"service","encap-type":"null"},{"ifindex":6,"vdevice-name":"172.16.255.11","if-tracker-status":"NA","if-admin-status":"Down","createTimeStamp":1647315883461,"tcp-mss-adjust":"1416","vpn-id":"0","vdevice-host-name":"vm1","mtu":"1500","ipv6-address":"-","hwaddr":"52:54:00:0f:c2:a7","ip-address":"-","vdevice-dataKey":"172.16.255.11-0-ge0/5-ipv4","@rid":908,"ifname":"ge0/5","vmanage-system-ip":"172.16.255.11","af-type":"ipv4","lastupdated":1647315879722,"shaping-rate":0,"port-type":"service","if-oper-status":"Down","encap-type":"null"}]}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Device Monitoring-read","method":"get","path":"/device/interface/synced"}}