{"type":"api","title":"Update a private Interconnect virtual network connection","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/36693899-8b64-31bd-aa1c-b67fb5b6463c","info":{"title":"SD-WAN Services","description":"Includes API operations for managing SD-WAN services such as Cloud OnRamp for SaaS and MultiCloud\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Multicloud Interconnect - Connectivity"],"summary":"Update a private Interconnect virtual network connection.","description":"API to update a virtual network connection between virtual network Tags and onRamp gateway connection.","operationId":"updateInterconnectVirtualNetworkConnection","parameters":[{"name":"connection-name","in":"path","description":"Interconnect virtual network connection name","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Request Payload for Interconnect virtual network connections","content":{"application/json":{"schema":{"required":["cloudAccountId","cloudAccountName","cloudType","connectionName","virtualNetworkTagAssociationType","virtualNetworkTagAssociations","virtualNetworkTags"],"type":"object","properties":{"cloudAccountId":{"maxLength":255,"minLength":1,"type":"string","description":"Interconnect virtual network connection cloud account id"},"cloudAccountName":{"type":"string","description":"Interconnect virtual network connection cloud account name"},"cloudType":{"pattern":"^(AWS|AZURE)$","type":"string","description":"Cloud provider type"},"connectionId":{"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":"Interconnect virtual network connection id"},"connectionName":{"pattern":"^[\\w.:-]{1,256}$","type":"string","description":"Interconnect virtual network connection name"},"resourceState":{"type":"object","properties":{"resourceAssociationDetails":{"type":"array","items":{"type":"object","properties":{"associatedResourceConnectionStatus":{"type":"string"},"associatedResourceId":{"type":"string"},"associatedResourceName":{"type":"string"},"associatedResourceStatus":{"type":"string"},"associatedResourceType":{"type":"string"}},"$$ref":"#/components/schemas/ResourceAssociationDetail"}},"resourceState":{"type":"string"},"resourceStateMessage":{"type":"string"},"resourceStateUpdateTs":{"type":"string"}},"description":"Interconnect virtual network connection resource state information","$$ref":"#/components/schemas/InterconnectResourceState"},"virtualNetworkTagAssociationType":{"type":"string","description":"Interconnect virtual network connection tag association type "},"virtualNetworkTagAssociations":{"type":"array","description":"Interconnect virtual network connection virtual network tag association list","items":{"required":["resourceType"],"type":"object","properties":{"onRampGatewayConnection":{"required":["name"],"type":"object","properties":{"id":{"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":"Interconnect onRamp gateway connection id"},"name":{"pattern":"^[\\w.:-]{1,256}$","type":"string","description":"Interconnect onRamp gateway connection name"}},"description":"Interconnect onRamp gateway connection information","$$ref":"#/components/schemas/OnRampGatewayConnection"},"resourceType":{"type":"string","description":"Type of resource to be associated to the tag"}},"description":"Interconnect virtual network connection virtual network tag association list","$$ref":"#/components/schemas/VirtualNetworkTagAssociation"}},"virtualNetworkTags":{"type":"array","description":"Interconnect virtual network connection virtual network tag list","items":{"required":["tagName"],"type":"object","properties":{"tagName":{"maxLength":255,"minLength":1,"type":"string","description":"Name of the Host VPC/VNET tag"}},"description":"Interconnect virtual network connection virtual network tag list","$$ref":"#/components/schemas/VirtualNetworkTag"}}},"$$ref":"#/components/schemas/InterconnectVirtualNetworkConnection"}}},"required":true},"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"}},"method":"put","path":"/multicloud/interconnect/connectivity/virtual-network-connections/{connection-name}"}}