Create gateway for Interconnect provider - Cisco Catalyst SD-WAN Manager API, Release 20.16

{"type":"api","title":"Create gateway for Interconnect provider","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 - Gateways"],"summary":"Create gateway for Interconnect provider.","description":"API to create an Intercoonect gateway in an Interconnect provider.","operationId":"createInterconnectGateway","requestBody":{"description":"Request Payload for Multicloud Interconnect Gateways","content":{"application/json":{"schema":{"required":["deviceUuid","edgeAccountId","edgeBillingAccountId","edgeGatewayName","edgeType","ipTransit","licenseType","region","regionId","siteName"],"type":"object","properties":{"configGroupSettings":{"required":["configGroupId","configGroupName"],"type":"object","properties":{"configGroupId":{"maxLength":255,"minLength":1,"type":"string","description":"Config Group Id","example":"482eb6f3-1168-4b6f-901a-bd2c788b370d"},"configGroupName":{"maxLength":255,"minLength":1,"type":"string","description":"Config Group name","example":"My-CG-1"}},"$$ref":"#/components/schemas/InterconnectConfigGroupSettings"},"description":{"maxLength":255,"minLength":1,"type":"string"},"deviceUuid":{"maxLength":255,"minLength":1,"type":"string"},"edgeAccountId":{"maxLength":255,"minLength":1,"type":"string"},"edgeBillingAccountId":{"maxLength":255,"minLength":1,"type":"string"},"edgeGatewayName":{"maxLength":255,"minLength":1,"type":"string"},"edgeType":{"type":"string"},"egwBgpAsn":{"type":"string","description":"BGP ASN assigned to Interconnect Gateway","example":"64500"},"ipTransit":{"maxLength":255,"minLength":1,"type":"string"},"ipTransitId":{"type":"string"},"ipTransitSkuId":{"type":"string"},"isCustomSetting":{"type":"boolean","description":"Custom Settings enabled for Interconnect Gateway","example":true},"licenseSkuId":{"type":"string","description":"License Sku Id of Interconnect Gateway","example":"12345"},"licenseType":{"type":"string","enum":["PAYG","PREPAID","DIRECT"]},"loopbackCidr":{"type":"string","description":"Ip pool allocated to Interconnect Gateway for Loopback Interfaces","example":"172.31.251.4/30"},"mrfSettings":{"type":"object","properties":{"mrfRouterRole":{"type":"string","description":"Multi Region Fabric router role","example":"border"},"mrfTransportGateway":{"type":"boolean","description":"Multi Region Fabric Transport Gateway","example":false},"nhmRegionId":{"type":"integer","description":"Network Hierarchy Region Id","format":"int64","example":123},"nhmRegionName":{"type":"string","description":"Network Hierarchy Region name","example":"My-Region"}},"$$ref":"#/components/schemas/InterconnectMrfSettings"},"region":{"maxLength":255,"minLength":1,"type":"string"},"regionId":{"maxLength":255,"minLength":1,"type":"string"},"resourceState":{"type":"string"},"resourceStateMessage":{"type":"string"},"resourceStateUpdateTs":{"type":"string"},"serviceChainAttachments":{"type":"string"},"settings":{"required":["instanceSize","softwareImageId"],"type":"object","properties":{"edgeGatewaySolution":{"type":"string","enum":["MVE","NE"]},"edgeType":{"type":"string","enum":["MEGAPORT","EQUINIX","ATT"]},"egwCustomSettingName":{"type":"string","description":"Assigned name of the Interconnect Gateway Custom Settings"},"instanceSize":{"maxLength":255,"minLength":1,"type":"string"},"ipSubnetPool":{"type":"string","description":"Ip subnet pool assigned to the gateway","example":"192.168.10.0/24"},"softwareImageId":{"maxLength":255,"minLength":1,"pattern":"^C8000v.*$","type":"string"}},"$$ref":"#/components/schemas/InterconnectGatewaySettings"},"siteName":{"maxLength":255,"minLength":1,"type":"string"}},"$$ref":"#/components/schemas/InterconnectGatewayExtended"},"examples":{"Interconnect Megaport Gateways":{"description":"Interconnect Megaport Gateways","value":{"edgeType":"MEGAPORT","edgeAccountId":"ABCD-1234-CDEF","edgeGatewayName":"mp-gateway-name","description":"This is my Megaport gateway","region":"Cologix TOR1, Toronto, ON, Canada : Toronto","regionId":"10","siteName":"My_Megaport_Site","deviceUuid":"C8K-f7f6c42c-409d-11eb-9562-005056841be8","settings":{"instanceSize":"Small","softwareImageId":"C8000v 17.09.01a"},"mrfSettings":{"mrfRouterRole":"border","mrfTransportGateway":false}}},"Interconnect Equinix Gateways - MRF Enabled":{"description":"Interconnect Equinix Gateways - MRF Enabled","value":"{\n\t\"edgeType\": \"EQUINIX\",\n\t\"edgeAccountId\": \"ABCD-1234-CDEF\",\n\t\"edgeGatewayName\": \"eq-gateway-name\",\n\t\"description\": \"This is my Equinix Gateway\",\n\t\"region\": \"NY Metro\",\n\t\"regionId\": \"10\",\n\t\"edgeBillingAccountId\": \"ABCD-1234-CDEF\",\n\t\"siteName\": \"My_Equinix_Site\",\n\t\"deviceUuid\": \"CSR-725caea2-41a4-497c-821d-a2e280be40f2\",\n\t\"mrfSettings\": {\n\t\t\"mrfRouterRole\": \"edge\",\n\t\t\"mrfTransportGateway\": false\n\t}\n\t\"settings\": {\n\t\t\"instanceSize\": \"Small\",\n\t\t\"softwareImageId\": \"CSR1000v 17.03.03\"\n\t}\n}"}}}}},"responses":{"200":{"description":"Interconnect Process ID Information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Procees Id of the task","example":"51d0a0e4-983a-471c-9abb-724d58144884"}},"$$ref":"#/components/schemas/ProcessResponse"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"__originalOperationId":"createInterconnectGateway","method":"post","path":"/multicloud/interconnect/gateways"}}