{"type":"api","title":"Get Interconnect provider Device-Link","meta":{"id":"/apps/pubhub/media/sd-wan-api-20-16/58fb893fa751949ea20a40274e9ab219a20e19fa/e77267b5-7b4b-3f93-807c-c6d1c6b41343","info":{"title":"Cisco Catalyst SD-WAN Manager API","description":"The vManage API exposes the functionality of operations maintaining devices and the overlay network","contact":{"email":"vmanage@cisco.com"},"license":{"name":"Commercial License","url":"https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html"},"version":"2.0.0"},"openapi":"3.0.1","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Multicloud Interconnect - Connectivity"],"summary":"Get Interconnect provider Device-Link.","description":"API to retrieve Interconnect provider Device-Link.","operationId":"getInterconnectDeviceLinks","parameters":[{"name":"device-link-name","in":"query","description":"Interconnect Device Link name","schema":{"type":"string"}},{"name":"interconnect-type","in":"query","description":"Interconnect Provider Type","schema":{"type":"string","enum":["MEGAPORT","EQUINIX"]}},{"name":"refresh","in":"query","description":"Retrieve Interconnect Device-Link from provider enabled","schema":{"type":"string","default":"false"}}],"responses":{"200":{"description":"Interconnect Device-Link Get Response.","content":{"application/json":{"schema":{"required":["bandwidth","deviceLinkName","edgeAccountId","edgeType"],"type":"object","properties":{"bandwidth":{"type":"string","description":"Device-Link Bandwidth Input.","example":"50"},"deviceLinkName":{"maxLength":50,"minLength":3,"pattern":"^[\\w.-]{3,50}$","type":"string","description":"Name of the Interconnect Device-Link.","example":"my-device-link"},"deviceLinkUuid":{"pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}","type":"string","description":"Uuid of the Interconnect Device-Link","example":"496bddbd-e104-44a7-ba62-7a285f642304"},"deviceLinksubnet":{"type":"string","description":"Subnet pool for Interconnect Gateway interfaces in the Device-Link.","example":"20.10.0.0/16"},"deviceList":{"maxItems":2147483647,"minItems":2,"type":"array","items":{"type":"object","properties":{"deviceInterfaceId":{"type":"string","description":"Interface used on the Interconnect Gateway to connect to the Device-Link.","example":"GigabitEthernet4"},"deviceIntfIpAddress":{"type":"string","description":"IP assigned to the Interconnect Gateway interface to connect to the Device-Link.","example":"20.10.0.2"},"deviceName":{"pattern":"^[\\w.-]{3,50}$","type":"string","description":"Name of the Interconnect Gateway in the Device-Link.","example":"ICGW_1"},"deviceUuid":{"type":"string","description":"Uuid of Interconnect Gateway in the Device-Link.","example":"0dc43131-47c9-4fce-8499-f02e3340c9fb"},"egwLoopBackCidr":{"type":"string","description":"IP assigned to the loopback interface of the Interconnect Gateway to form SDWAN tunnel.","example":"172.31.251.8/30"}},"$$ref":"#/components/schemas/InterconnectDeviceLinkDeviceList"}},"dlMetroBandwidth":{"type":"string","description":"Device-Link Bandwidth at a given Metro.","example":"150"},"edgeAccountId":{"maxLength":255,"minLength":1,"type":"string"},"edgeAccountName":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9_\\-\\s]+$","type":"string"},"edgeType":{"type":"string"},"linkBandwidth":{"type":"string","description":"Device-Link Bandwidth.","example":"50"},"resourceState":{"type":"string"},"resourceStateMessage":{"type":"string"},"resourceStateUpdateTs":{"type":"string"},"subnet":{"pattern":"^(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(?:\\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}\\/(?:3[0-2]|[0-2]?[0-9])$","type":"string","description":"Subnet pool for Interconnect Gateway interfaces in the Device-Link.","example":"20.10.0.0/16"},"version":{"type":"string","description":"Version of the payload.","example":"1"}},"description":"Interconnect Device-Link Object","$$ref":"#/components/schemas/InterconnectDeviceLink"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"__originalOperationId":"getInterconnectDeviceLinks","method":"get","path":"/multicloud/interconnect/connectivity/device-links"}}