{"type":"api","title":"Create Connection History List Real Time","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 connections history list from device (Real Time)","operationId":"createConnectionHistoryListRealTime","parameters":[{"name":"peer-type","in":"query","description":"Peer type","schema":{"type":"string","enum":["vedge","vsmart","vmanage","vbond"]}},{"name":"system-ip","in":"query","description":"Peer system IP","schema":{"type":"string"}},{"name":"deviceId","in":"query","description":"deviceId - Device IP","required":true,"schema":{"pattern":"^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$","type":"string","example":"169.254.10.10"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"Connections list":{"description":"Connections list","value":{"data":[{"instance":0,"vdevice-name":"169.254.10.10","remote_enum-desc":"No Error.","system-ip":"0.0.0.0","remote-color":"default","site-id":0,"uuid":"d7e88eac-250c-4189-bc66-747615452ad9","peer-type":"vbond","protocol":"dtls","state":"tear_down","private-ip":"10.103.135.135","local_enum-desc":"Disconnect vBond after register reply.","domain-id":0,"rep-count":0,"index":0,"private-port":12346,"vdevice-host-name":"vm3","vh-org-name":"vIPtela Inc Regression","local-color":"default","downtime":"2022-01-20T19:10:43+0000","vdevice-dataKey":"169.254.10.10-0-0-2022-01-20T19:10:43+0000","public-ip":"10.103.135.135","downtime-date":1642705843000,"remote_enum":"NOERR","public-port":12346,"lastupdated":1642727714927,"local_enum":"DISCVBD"},{"instance":0,"vdevice-name":"169.254.10.10","remote_enum-desc":"No Error.","system-ip":"169.254.10.3","remote-color":"default","site-id":202,"uuid":"387d8bf3-5306-41fe-9090-7ee61c91d9c3","peer-type":"vmanage","protocol":"dtls","state":"tear_down","private-ip":"10.103.202.202","local_enum-desc":"TLOC Disabled.","domain-id":0,"rep-count":0,"index":1,"private-port":12346,"vdevice-host-name":"vm3","vh-org-name":"vIPtela Inc Regression","local-color":"biz-internet","downtime":"2022-01-20T19:10:24+0000","vdevice-dataKey":"169.254.10.10-0-1-2022-01-20T19:10:24+0000","public-ip":"10.103.202.202","downtime-date":1642705824000,"remote_enum":"NOERR","public-port":12346,"lastupdated":1642727714927,"local_enum":"DISTLOC"},{"instance":0,"vdevice-name":"169.254.10.10","remote_enum-desc":"No Error.","system-ip":"172.16.255.130","remote-color":"default","site-id":130,"uuid":"fca7532b-9366-466a-a8f9-79922392917b","peer-type":"vsmart","protocol":"dtls","state":"tear_down","private-ip":"10.103.130.130","local_enum-desc":"TLOC Disabled.","domain-id":1,"rep-count":0,"index":2,"private-port":12346,"vdevice-host-name":"vm3","vh-org-name":"vIPtela Inc Regression","local-color":"biz-internet","downtime":"2022-01-20T19:10:24+0000","vdevice-dataKey":"169.254.10.10-0-2-2022-01-20T19:10:24+0000","public-ip":"10.103.130.130","downtime-date":1642705824000,"remote_enum":"NOERR","public-port":12346,"lastupdated":1642727714927,"local_enum":"DISTLOC"},{"instance":0,"vdevice-name":"169.254.10.10","remote_enum-desc":"No Error.","system-ip":"169.254.10.3","remote-color":"default","site-id":202,"uuid":"387d8bf3-5306-41fe-9090-7ee61c91d9c3","peer-type":"vmanage","protocol":"dtls","state":"tear_down","private-ip":"10.103.202.202","local_enum-desc":"TLOC Disabled.","domain-id":0,"rep-count":0,"index":5,"private-port":12346,"vdevice-host-name":"vm3","vh-org-name":"vIPtela Inc Regression","local-color":"default","downtime":"2022-01-20T19:09:22+0000","vdevice-dataKey":"169.254.10.10-0-5-2022-01-20T19:09:22+0000","public-ip":"10.103.202.202","downtime-date":1642705762000,"remote_enum":"NOERR","public-port":12346,"lastupdated":1642727714927,"local_enum":"DISTLOC"}]}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"System-read,System-write,Security-read,Security-write","method":"get","path":"/device/control/connectionshistory"}}