Edit Tag - Cisco Catalyst SD-WAN Manager API, Release 20.18

{"type":"api","title":"Edit Tag","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/744a8207-9965-344e-aed3-d3ef846a4950","info":{"title":"Others","description":"Other APIs\n- Include APIs that do not belong to other categories\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["MultiCloud - Tagging"],"description":"Edit VPCs for a Tag","operationId":"editTag","requestBody":{"description":"Payload for updating VPCs for a Tag","content":{"application/json":{"schema":{"type":"object","properties":{"hostVpcs":{"type":"array","description":"Used for AWS, AWS GovCloud and GCP cloud types","items":{"required":["accountId","cloudType","hostVpcId","region","vnetId"],"type":"object","properties":{"accountId":{"type":"string"},"accountName":{"type":"string"},"cgwAttachment":{"pattern":"^[\\w.-]{1,128}$","type":"string"},"cgwAutoAttachmentFlag":{"type":"boolean"},"cloudType":{"type":"string"},"hostVpcId":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for AWS, AWS GovCloud and GCP cloud types"},"hostVpcName":{"pattern":"^[a-zA-Z0-9_/\\-]*$","type":"string","description":"Used for AWS, AWS GovCloud and GCP cloud types"},"id":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"interconnectTag":{"pattern":"^(Yes|No)$","type":"string"},"label":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"region":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"resourceGroups":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"tag":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"vnetId":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"vnetKey":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"vpcName":{"pattern":"^[a-zA-Z0-9_/\\-]*$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"}},"description":"Used for AWS, AWS GovCloud and GCP cloud types","$$ref":"#/components/schemas/AllOfhostVpcTagPutHostVpcsItems"}},"interconnectTag":{"type":"boolean"},"tagName":{"type":"string"},"vnets":{"type":"array","description":"Used for Azure and Azure GovCloud cloud types","items":{"required":["accountId","cloudType","hostVpcId","region","vnetId"],"type":"object","properties":{"accountId":{"type":"string"},"accountName":{"type":"string"},"cgwAttachment":{"pattern":"^[\\w.-]{1,128}$","type":"string"},"cgwAutoAttachmentFlag":{"type":"boolean"},"cloudType":{"type":"string"},"hostVpcId":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for AWS, AWS GovCloud and GCP cloud types"},"hostVpcName":{"pattern":"^[a-zA-Z0-9_/\\-]*$","type":"string","description":"Used for AWS, AWS GovCloud and GCP cloud types"},"id":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"interconnectTag":{"pattern":"^(Yes|No)$","type":"string"},"label":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"region":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"resourceGroups":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"tag":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string"},"vnetId":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"vnetKey":{"pattern":"^[a-zA-Z0-9_./\\-]+$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"},"vpcName":{"pattern":"^[a-zA-Z0-9_/\\-]*$","type":"string","description":"Used for Azure and Azure GovCloud cloud types"}},"description":"Used for Azure and Azure GovCloud cloud types","$$ref":"#/components/schemas/AllOfhostVpcTagPutVnetsItems"}}},"$$ref":"#/components/schemas/HostVpcTagPut"},"examples":{"Edit AWS Tag":{"description":"Edit AWS Tag","value":{"tagName":"test-tag","interconnectTag":false,"hostVpcs":[{"accountId":"999293417507","accountName":"test-aws-account","region":"us-west-2","cloudType":"AWS","hostVpcId":"vpc-0fd1fbce44f9db86b","hostVpcName":"test-vpc-1","id":"vpc-0fd1fbce44f9db86b","label":"vpc-0fd1fbce44f9db86b","interconnectTag":"No"},{"accountId":"999293417507","accountName":"test-aws-account","region":"us-west-2","cloudType":"AWS","hostVpcId":"vpc-089a6f8af08dacbf1","hostVpcName":"test-vpc-2","id":"vpc-089a6f8af08dacbf1","label":"vpc-089a6f8af08dacbf1","interconnectTag":"No"}]}},"Edit Azure Tag":{"description":"Edit Azure Tag","value":{"tagName":"test-azure-tag","interconnectTag":false,"vnets":[{"accountId":"9e222d34-9f20-4a2f-9c01-e507193dabb","accountName":"test-azure-account","region":"us-west-2","cloudType":"AZURE","vnetId":"/subscriptions/9e222d34-9f20-4a2f-9c01-e507193dabb4/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet-1","vnetKey":"9e222d34-9f20-4a2f-9c01-e507193dabb4/test-rg/test-vnet-1","vpcName":"test-vnet-1","resourceGroups":"test-rg","id":"/subscriptions/9e222d34-9f20-4a2f-9c01-e507193dabb4/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet-1","label":"9e222d34-9f20-4a2f-9c01-e507193dabb4/test-rg/test-vnet-1","interconnectTag":"No","tag":"test-azure-tag"},{"accountId":"9e222d34-9f20-4a2f-9c01-e507193dabb","accountName":"test-azure-account","region":"us-west-2","cloudType":"AZURE","vnetId":"/subscriptions/9e222d34-9f20-4a2f-9c01-e507193dabb4/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet-2","vnetKey":"9e222d34-9f20-4a2f-9c01-e507193dabb4/test-rg/test-vnet-2","vpcName":"test-vnet-2","resourceGroups":"test-rg","id":"/subscriptions/9e222d34-9f20-4a2f-9c01-e507193dabb4/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet-2","label":"9e222d34-9f20-4a2f-9c01-e507193dabb4/test-rg/test-vnet-2","interconnectTag":"No","tag":"test-azure-tag"}]}},"Edit GCP Tag":{"description":"Edit GCP Tag","value":{"tagName":"test-gcp-tag","interconnectTag":false,"hostVpcs":[{"accountId":"gcp-test-1234","accountName":"test-gcp-account","region":"us-west-3","cloudType":"GCP","hostVpcId":"8360972143511967399","hostVpcName":"test-vpc-3","tag":"test-tag","interconnectTag":"No","id":"8360972143511967399","label":"8360972143511967399"},{"accountId":"gcp-test-1234","accountName":"test-gcp-account","region":"us-west-3","cloudType":"GCP","hostVpcId":"2261865283189378184","hostVpcName":"test-vpc-4","tag":"test-tag","interconnectTag":"No","id":"2261865283189378184","label":"2261865283189378184"}]}}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"6c723f65-9106-4f43-9d2b-a033a39353b3"}},"description":"Task id for polling status","$$ref":"#/components/schemas/Taskid"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"put","path":"/multicloud/hostvpc/tags"}}