{"type":"api","title":"Create Topology List","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 - Multicast"],"description":"Get topology list from device","operationId":"createTopologyList","parameters":[{"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":{"Topology list":{"description":"Topology list","value":{"data":[{"vdevice-name":"172.16.254.1","vdevice-host-name":"vm2","vpn-id":"1","group":"225.0.0.0","source":"0.0.0.0","join-type":"(*,G)","rp-address":"58.0.1.100","replicator":"172.16.255.14","upstream-neighbor":"172.16.255.14","upstream-state":"joined","upstream-interface":"172.16.255.14","up-time":"0:01:26:52","up-time-date":"18 07 2022 16:26:52 A z","expires":"0:00:00:31","expires-date":"20 07 2022 16:26:52 A z","oif-tunnel":"-","vdevice-dataKey":"172.16.254.1","lastupdated":1644997246553},{"vdevice-name":"172.16.254.1","vdevice-host-name":"vm2","vpn-id":"1","group":"225.0.0.9","source":"56.0.1.100","join-type":"(*,G)","rp-address":"-","replicator":"-","upstream-neighbor":"56.0.1.100","upstream-state":"joined","upstream-interface":"ge0/0","up-time":"0:16:26:52","up-time-date":"18 07 2022 16:26:52 A z","expires":"0:16:26:52","expires-date":"20 07 2022 16:26:52 A z","oif-tunnel":"172.16.255.14","vdevice-dataKey":"172.16.254.1","lastupdated":1644997246553}]}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Routing-read,Routing-write","method":"get","path":"/device/multicast/topology"}}