Cisco Catalyst SD-WAN MultiCloud - CloudGateway API

The MultiCloud - CloudGateway API from Cisco Catalyst SD-WAN — 22 operation(s) for multicloud - cloudgateway.

Business capability
IT Infrastructure Management BC-600.50

Operations 26

POST /multicloud/cloudgateway #
GET /multicloud/cloudgateway #
GET /multicloud/cloudgateway/availabilityZones #
POST /multicloud/cloudgateway/config-group Create cloud gateway config group #
GET /multicloud/cloudgateway/nvaSecurityRules/{cloudGatewayName} #
PUT /multicloud/cloudgateway/nvaSecurityRules/{cloudGatewayName} #
GET /multicloud/cloudgateway/nvas #
GET /multicloud/cloudgateway/nvasku #
GET /multicloud/cloudgateway/resource #
GET /multicloud/cloudgateway/resourceGroups #
GET /multicloud/cloudgateway/tgw/Attachments #
GET /multicloud/cloudgateway/tgw/RouteTables #
GET /multicloud/cloudgateway/tgws #
GET /multicloud/cloudgateway/vhubs #
GET /multicloud/cloudgateway/vnetsNoofAttached #
GET /multicloud/cloudgateway/vpn-gateways #
GET /multicloud/cloudgateway/vwans #
GET /multicloud/cloudgateway/{cloudGatewayName} #
PUT /multicloud/cloudgateway/{cloudGatewayName} #
DELETE /multicloud/cloudgateway/{cloudGatewayName} #
GET /multicloud/cloudgateway/{cloudType}/gateways/device-chassis-numbers Get cloud gateway devices by config ID. #
GET /multicloud/cloudgateways/{cloudType} #
GET /multicloud/cloudgatewaysetting/{cloudGatewayName} #
GET /multicloud/cloudgatewaytype #
POST /multicloud/pushCgwConfig #
GET /multicloud/tunnels/{cloudType} #

Documentation

📖
Documentation
https://developer.cisco.com/docs/sdwan/administration-and-setting/
📖
APIReference
https://developer.cisco.com/docs/sdwan/administration-and-setting/
📖
Documentation
https://developer.cisco.com/docs/sdwan/ux-1-0-configuration/
📖
APIReference
https://developer.cisco.com/docs/sdwan/ux-1-0-configuration/
📖
Documentation
https://developer.cisco.com/docs/sdwan/ux-2-0-configuration/
📖
APIReference
https://developer.cisco.com/docs/sdwan/ux-2-0-configuration/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-system/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-system/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-transport/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-transport/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-service/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-service/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-others/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-others/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-routing/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-routing/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-mobility-and-nfv/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-mobility-and-nfv/
📖
Documentation
https://developer.cisco.com/docs/sdwan/monitoring-and-troubleshooting/
📖
APIReference
https://developer.cisco.com/docs/sdwan/monitoring-and-troubleshooting/
📖
Documentation
https://developer.cisco.com/docs/sdwan/sd-wan-services/
📖
APIReference
https://developer.cisco.com/docs/sdwan/sd-wan-services/
📖
Documentation
https://developer.cisco.com/docs/sdwan/partner-integrations/
📖
APIReference
https://developer.cisco.com/docs/sdwan/partner-integrations/
📖
Documentation
https://developer.cisco.com/docs/sdwan/others/
📖
APIReference
https://developer.cisco.com/docs/sdwan/others/

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cisco-catalyst-sdwan-multicloud-cloudgateway-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cisco-catalyst-sdwan-multicloud-cloudgateway-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Others MultiCloud - CloudGateway API
  description: 'Other APIs

    Include APIs that do not belong to other categories'
  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: 26.1.0+2026-01-06
  x-provenance:
    method: harvested
    authored_by: Cisco Catalyst SD-WAN
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: pubhub.devnetcloud.com
    note: 4,138 operations across 2,841 paths, published by Cisco as self-contained per-operation OpenAPI 3.1.0 fragments on the DevNet CDN and consolidated here into 13 documents. Ownership verified from info.contact vmanage@cisco.com and the Cisco license URL rather than from the fetch host.
  x-evidence:
  - type: source
    url: https://pubhub.devnetcloud.com/media/cisco-catalyst-sd-wan-26-1-api-guide/docs/
  - type: source
    url: https://developer.cisco.com/docs/sdwan/
servers:
- url: /dataservice
tags:
- name: MultiCloud - CloudGateway
paths:
  /multicloud/cloudgateway:
    post:
      tags:
      - MultiCloud - CloudGateway
      description: Create cloud gateway
      operationId: createCgw
      requestBody:
        description: Payloads for updating Cloud Gateway based on CloudType
        content:
          application/json:
            schema:
              required:
              - accountId
              - azureProperties
              - cloudGatewayName
              - cloudType
              type: object
              properties:
                accountId:
                  type: string
                awsCwanProperties:
                  type: object
                  properties:
                    coreNetworkEdgeId:
                      type: string
                      description: Refers to AWS site id within the core network
                    coreNetworkEdgeSource:
                      type: string
                      enum:
                      - aws
                      - tvpcOnly
                      - toBeCreated
                    coreNetworkId:
                      type: string
                    coreNetworkSource:
                      type: string
                      enum:
                      - aws
                      - tvpcOnly
                      - toBeCreated
                  description: Used in AWS/AWS Govcloud CGW creation. Null if type is TGW based
                  $$ref: '#/components/schemas/CloudGatewayPostAwsCwanProperties'
                awsTgwProperties:
                  type: object
                  properties:
                    tgwConnections:
                      type: array
                      properties:
                        empty:
                          type: boolean
                      description: Defines a list of TGW connections. Null if tgwSource is not aws
                      items:
                        type: object
                        properties:
                          conn:
                            type: string
                          tgwRouteTableId:
                            type: string
                          vpnId:
                            type: string
                        description: Defines a list of TGW connections. Null if tgwSource is not aws
                        $$ref: '#/components/schemas/TgwConnectionsInner'
                    tgwId:
                      type: string
                    tgwSource:
                      type: string
                      enum:
                      - aws
                      - tvpcOnly
                      - toBeCreated
                  description: Used in AWS/AWS Govcloud CGW creation. Null if type is cloudwan based
                  $$ref: '#/components/schemas/CloudGatewayPostAwsTgwProperties'
                azureProperties:
                  required:
                  - resourceGroupName
                  - resourceGroupSource
                  - vhubName
                  - vhubSource
                  - vwanName
                  - vwanSource
                  type: object
                  properties:
                    nvaSource:
                      type: string
                    resourceGroupName:
                      pattern: ^[a-zA-Z0-9_/\\\-]+$
                      type: string
                    resourceGroupSource:
                      type: string
                    vhubName:
                      pattern: ^[a-zA-Z0-9_/\\\-]+$
                      type: string
                    vhubResourceGroupAccountId:
                      type: string
                    vhubResourceGroupName:
                      pattern: ^[a-zA-Z0-9_/\\\-]+$
                      type: string
                    vhubResourceGroupSource:
                      type: string
                    vhubSource:
                      type: string
                    vpnGatewaySource:
                      type: string
                    vwanName:
                      pattern: ^[a-zA-Z0-9_/\\\-]+$
                      type: string
                    vwanSource:
                      type: string
                  description: Used in Azure/Azure GovCloud CGW creation
                  $$ref: '#/components/schemas/CloudGatewayPostAzureProperties'
                cloudGatewayMode:
                  pattern: ^(sdwan|sd-routing)$
                  type: string
                cloudGatewayName:
                  maxLength: 255
                  minLength: 1
                  type: string
                cloudGatewaySolution:
                  pattern: ^[a-zA-Z_]+$
                  type: string
                cloudGatewayTag:
                  pattern: ^[a-zA-Z0-9_./\\\-]+$
                  type: string
                cloudType:
                  type: string
                configGroupSettings:
                  type: object
                  properties:
                    configGroupId:
                      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
                    configGroupName:
                      pattern: ^[a-zA-Z0-9_/\\\-]+$
                      type: string
                  description: Used in Azure/Azure GovCloud CGW creation
                  $$ref: '#/components/schemas/CloudGatewayPostConfigGroupSettings'
                description:
                  maxLength: 1024
                  minLength: 0
                  pattern: ^[a-zA-Z0-9_./\-\s]*$
                  type: string
                devices:
                  type: array
                  items:
                    type: string
                mrfRouterRole:
                  pattern: ^(edge|border)$
                  type: string
                region:
                  pattern: ^[a-zA-Z0-9_./\-]+$
                  type: string
                s2sPermitted:
                  pattern: ^(true|false)$
                  type: string
                settings:
                  type: object
                  properties:
                    cloudGatewaySolution:
                      pattern: ^[a-zA-Z_]*$
                      type: string
                    cloudType:
                      pattern: ^[a-zA-Z_]*$
                      type: string
                    instanceSize:
                      pattern: ^[a-zA-Z0-9_./\-]*$
                      type: string
                    ipSubnetPool:
                      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]))(?:\s*,\s*(?: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
                    name:
                      pattern: ^[a-zA-Z_]*$
                      type: string
                    networkTier:
                      pattern: ^[a-zA-Z0-9_./\-]*$
                      type: string
                      description: Used for GCP Custom settings
                    skuScaleUnit:
                      pattern: ^[0-9]*$
                      type: string
                      description: Used for Azure/Azure GovCloud Custom settings
                    softwareImageId:
                      pattern: ^[a-zA-Z0-9_./\-\s]*$
                      type: string
                    tunnelCount:
                      pattern: ^[0-9]*$
                      type: string
                      description: Tunnel Count for AWS Connect based and branch connect
                  $$ref: '#/components/schemas/AllOfcloudGatewayPostSettings'
                siteName:
                  pattern: ^[a-zA-Z0-9_./\\\-]+$
                  type: string
                sshKeyName:
                  pattern: ^[a-zA-Z0-9_./\\\-]+$
                  type: string
              $$ref: '#/components/schemas/CloudGatewayPost'
            examples:
              GCP CGW Create request:
                description: GCP CGW Create request
                value:
                  accountId: gcp-project-nprd-312512
                  cloudType: GCP
                  region: us-west4
                  cloudGatewayName: gcp-test
                  devices:
                  - C8K-2F69B355-2B3D-2801-EB48-F44789422299
                  - C8K-53349F28-AB44-70C5-260B-096581250519
                  description: GCP post request
                  s2sPermitted: false
                  mrfRouterRole: border
                  siteName: SITE_1
                  configGroupSettings:
                    configGroupName: CG_1
                    configGroupId: d0846e2c-a977-46fa-8acb-0e387a30eadf
              AWS/AWS GovCloud CGW create request:
                description: AWS/AWS GovCloud CGW create request
                value:
                  accountId: '238112874124'
                  cloudType: AWS
                  region: us-east-1
                  cloudGatewayName: aws-test
                  devices:
                  - C8K-2F69B355-2B3D-2801-EB48-F44789422299
                  - C8K-53349F28-AB44-70C5-260B-096581250519
                  description: AWS/AWS_GOVCLOUD post request
                  mrfRouterRole: border
                  siteName: SITE_1
                  configGroupSettings:
                    configGroupName: CG_1
                    configGroupId: d0846e2c-a977-46fa-8acb-0e387a30eadf
              Azure/Azure GovCloud CGW create request:
                description: Azure/Azure GovCloud CGW create request
                value:
                  accountId: 81k99acb9-1a58-b3b6-214f-840623g789a0
                  cloudType: AZURE
                  region: westus2
                  cloudGatewayName: azure-test
                  mrfRouterRole: border
                  siteName: SITE_1
                  devices:
                  - C8K-2F69B355-2B3D-2801-EB48-F44789422299 C8K-53349F28-AB44-70C5-260B-096581250519
                  description: AZURE/AZURE_GOVCLOUD post request
                  azureProperties:
                    resourceGroupName: azureTestRGP
                    resourceGroupSource: azure
                    vwanName: azureTestVwan
                    vwanSource: azure
                    vhubName: azureTestVhub
                    vhubSource: toBeCreated
                    nvaSource: toBeCreated
                  configGroupSettings:
                    configGroupName: CG_1
                    configGroupId: d0846e2c-a977-46fa-8acb-0e387a30eadf
        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
    get:
      tags:
      - MultiCloud - CloudGateway
      description: Get cloud gateways
      operationId: getCgws
      parameters:
      - name: cloudType
        in: query
        description: Multicloud provider type
        schema:
          type: string
      - name: accountId
        in: query
        description: Multicloud account id
        schema:
          type: string
      - name: region
        in: query
        description: Multicloud region
        schema:
          pattern: ^[a-zA-Z0-9_./\-]+$
          type: string
      - name: cloudGatewayName
        in: query
        description: Multicloud cloud gateway name
        schema:
          maxLength: 255
          minLength: 1
          type: string
      - name: connectivityState
        in: query
        description: Multicloud connectivity state
        schema:
          pattern: ^[a-zA-Z_./\\\-\s]+$
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    accountId:
                      type: string
                    accountName:
                      type: string
                    cloudGatewayId:
                      type: string
                    cloudGatewayName:
                      type: string
                    cloudType:
                      type: string
                    customSettings:
                      type: boolean
                    description:
                      type: string
                    region:
                      type: string
                    status:
                      type: string
                  $$ref: '#/components/schemas/CloudGatewayListResponse'
              examples:
                Azure Cgw list:
                  description: Azure Cgw list
                  value:
                  - resourceGroupName: azure-rgp
                    cloudGatewayName: az-test
                    accountName: ramL
                    devices:
                    - C8K-2F69B355-2B3D-2801-EB48-F44789422299
                    - C8K-53349F28-AB44-70C5-260B-096581250519
                    virtualRouterAsn: '65515'
                    vhubName: az-test
                    description: ''
                    vwanName: azure-vwan
                    connectivityStateUpdateTs: 1655141135729
                    accountId: 8b188c39-f358-4db6-a44f-84068541233a
                    cloudGatewayId: /subscriptions/8b188c39-f358-4db6-a44f-84068541233a0/resourceGroups/test-resource-group/providers/Microsoft.Network/virtualHubs/az-test
                    vhubId: /subscriptions/8b188c39-f358-4db6-a44f-84068541233a0/resourceGroups/test-resource-group/providers/Microsoft.Network/virtualHubs/az-test
                    cloudType: AZURE
                    customSettings: false
                    region: westus2
                    connectivityState: initialized
                    cloudGatewaySolution: vhub
                    settings:
                      softwareImageId: 17.6.01
                      skuScaleUnit: 2
                      ipSubnetPool: 10.0.0.0/16
                      instanceSize: 2
                    status: normal
                    vpns: []
                    connectedSites: 1
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /multicloud/cloudgateway/availabilityZones:
    get:
      tags:
      - MultiCloud - CloudGateway
      description: Discover AWS availability zones
      operationId: getAvailabilityZones
      parameters:
      - name: cloudType
        in: query
        required: true
        schema:
          type: string
          enum:
          - AWS
          - AWS_GOVCLOUD
      - name: accountId
        in: query
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    AttachmentId:
                      type: string
                      example: tgw-12345
                  $$ref: '#/components/schemas/TgwAttachmentsListResponse'
              examples:
                Discover AWS availability zones:
                  description: Discover AWS availability zones
                  value:
                  - zoneId: usw2-az2
                    zoneName: us-west-2
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /multicloud/cloudgateway/config-group:
    post:
      tags:
      - MultiCloud - CloudGateway
      summary: Create cloud gateway config group
      description: API to initiate a config group creation for a cloud gateway.
      operationId: createCloudGatewayConfigGroup
      parameters:
      - name: cloudType
        in: query
        description: Multicloud provider type
        required: true
        schema:
          type: string
      requestBody:
        description: Request Payload for Multicloud Gateway Config Group Creation
        content:
          application/json:
            schema:
              required:
              - configGroupName
              type: object
              properties:
                configGroupName:
                  pattern: ^[a-zA-Z0-9_/\\\-]+$
                  type: string
                configGroupSolution:
                  pattern: ^(sdwan|sd-routing)$
                  type: string
              $$ref: '#/components/schemas/MultiCloudGatewaysConfiggroupBody'
            examples:
              Cloud Gateway Config Group Creation:
                description: Cloud Gateway Config Group Creation
                value:
                  configGroupName: CGW_Config_Group
                  configGroupSolution: sdwan
        required: true
      responses:
        '200':
          description: Accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  createdBy:
                    type: string
                  createdOn:
                    type: number
                  description:
                    type: string
                  devices:
                    type: array
                    items:
                      type: string
                  fullConfigCli:
                    type: boolean
                  id:
                    type: string
                  iosConfigCli:
                    type: boolean
                  lastUpdatedBy:
                    type: string
                  lastUpdatedOn:
                    type: number
                  name:
                    type: string
                  numberOfDevices:
                    type: integer
                    format: int32
                  numberOfDevicesUpToDate:
                    type: integer
                    format: int32
                  origin:
                    type: string
                  profiles:
                    type: array
                    items:
                      type: object
                      properties:
                        createdBy:
                          type: string
                        createdOn:
                          type: number
                        description:
                          type: string
                        id:
                          type: string
                        lastUpdatedBy:
                          type: string
                        lastUpdatedOn:
                          type: number
                        name:
                          type: string
                        profileParcelCount:
                          type: string
                        solution:
                          type: string
                        type:
                          type: string
                      $$ref: '#/components/schemas/PostCgwConfigGroupResponseProfiles'
                  solution:
                    type: string
                  source:
                    type: string
                  state:
                    type: string
                  topology:
                    type: string
                  version:
                    type: integer
                    format: int32
                $$ref: '#/components/schemas/PostCgwConfigGroupResponse'
              examples:
                Cloud Gateway Config Group Creation Response:
                  description: Cloud Gateway Config Group Creation Response
                  value:
                    id: 9f4bb392-8255-46cd-a849-1aea7ccbad9a
                    name: test_cg
                    description: test_cg Config Group
                    source: MULTICLOUD_AZURE
                    solution: sdwan
                    lastUpdatedBy: system
                    lastUpdatedOn: 1712732936141
                    createdBy: system
                    createdOn: 1712732936141
                    profiles:
                    - id: 5329eb9c-084e-40da-ad17-3304c1922634
                      name: test_cg_AZURE_transport
                      solution: sdwan
                      type: transport
                      description: null
                      lastUpdatedBy: system
                      lastUpdatedOn: 1712732936112
                      createdBy: system
                      createdOn: 1712732935034
                      profileParcelCount: 2
                    - id: e578e626-3517-4bcc-b802-aecc4a7e85ba
                      name: test_cg_AZURE_system
                      solution: sdwan
                      type: system
                      description: null
                      lastUpdatedBy: system
                      lastUpdatedOn: 1712732935020
                      createdBy: system
                      createdOn: 1712732931425
                      profileParcelCount: 9
                    version: 1
                    state: null
                    devices: []
                    numberOfDevices: 0
                    numberOfDevicesUpToDate: 0
                    origin: user
                    topology: null
                    fullConfigCli: false
                    iosConfigCli: false
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /multicloud/cloudgateway/nvaSecurityRules/{cloudGatewayName}:
    get:
      tags:
      - MultiCloud - CloudGateway
      description: Get NVA Security Rules
      operationId: getNvaSecurityRules
      parameters:
      - name: cloudGatewayName
        in: path
        description: Multicloud cloud gateway name
        required: true
        schema:
          maxLength: 255
          minLength: 1
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  accountId:
                    type: string
                    example: '112948124124'
                  accountName:
                    type: string
                    example: test_account_name
                  cloudType:
                    type: string
                    example: AZURE
                  expirationTime:
                    type: string
                    example: 6/10/2022 6:12:36 PM UTC
                  nvaId:
                    type: string
                    example: /subscriptions/112948124124/resourceGroups/test-resource-group/providers/Microsoft.Network/networkVirtualAppliances/CiscoSdwanV2-nva-399bdf13-65e9-4177-876b-d125bee704d6
                  resourceGroupName:
                    type: string
                    example: test-resource-group
                  ruleName:
                    type: string
                    example: test_rule
                  securityRulesList:
                    type: object
                    properties:
                      securityRulesList:
                        type: array
                        items:
                          required:
                          - destinationPortRange
                          - protocol
                          - sourceAddressPrefix
                          type: object
                          properties:
                            destinationPortRange:
                              pattern: ^\d+$
                              type: string
                              example: '22'
                            protocol:
                              pattern: ^(TCP|UDP)$
                              type: string
                              example: TCP
                            sourceAddressPrefix:
                              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
                              example: 192.168.1.1/32
                          $$ref: '#/components/schemas/NvaRulesListRequestSecurityRulesList'
                    $$ref: '#/components/schemas/NvaRulesListRequest'
                $$ref: '#/components/schemas/NvaRulesResponse'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
    put:
      tags:
      - MultiCloud - CloudGateway
      description: Update NVA Security Rules
      operationId: updateNvaSecurityRules
      parameters:
      - name: cloudGatewayName
        in: path
        required: true
        schema:
          pattern: ^[\w.-]{1,128}$
          type: string
      requestBody:
        description: Update NVA security Rules
        content:
          application/json:
            schema:
              type: object
              properties:
                securityRulesList:
                  type: array
                  items:
                    required:
                    - destinationPortRange
                    - protocol
                    - sourceAddressPrefix
                    type: object
                    properties:
                      destinationPortRange:
                        pattern: ^\d+$
                        type: string
                        example: '22'
                      protocol:
                        pattern: ^(TCP|UDP)$
                        type: string
                        example: TCP
                      sourceAddressPrefix:
                        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
                        example: 192.168.1.1/32
                    $$ref: '#/components/schemas/NvaRulesListRequestSecurityRulesList'
              $$ref: '#/components/schemas/NvaRulesListRequest'
        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
  /multicloud/cloudgateway/nvas:
    get:
      tags:
      - MultiCloud - CloudGateway
      description: Discover Azure Network Virtual Appliances
      operationId: getAzureNetworkVirtualAppliances
      parameters:
      - name: cloudType
        in: query
        required: true
        schema:
          pattern: ^[a-zA-Z_]+$
          type: string
      - name: accountId
        in: query
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          pattern: ^[a-zA-Z0-9_./\-]+$
          type: string
      - name: resourceGroupName
        in: query
        required: true
        schema:
          pattern: ^[\w.-]{1,128}$
          type: string
      - name: resourceGroupSource
        in: query
        required: true
        schema:
          pattern: ^[a-zA-Z_]+$
          type: string
      - name: vhubName
        in: query
        required: true
        schema:
          pattern: ^[\w.-]{1,128}$
          type: string
      - name: vhubSource
        in: query
        required: true
        schema:
          pattern: ^[a-zA-Z_]+$
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    nvaId:
                      type: string
                      example: /subscriptions/8b188c39-f358-4db6-a44f-84068541233a0/resourceGroups/test-resource-group/providers/Microsoft.Network/networkVirtualAppliances/CiscoSdwanV2-nva-f383f40c-d07e-41be-bbc7-aa7abbfbf7fc
                    nvaName:
                      type: string
                      example: CiscoSdwanV2-nva-f383f40c-d07e-41be-bbc7-aa7abbfbf7fc
                    source:
                      type: string
                      example: vManage
                    uuids:
                      type: array
                      example:
                      - C8K-2F69B355-2B3D-2801-EB48-F44789422299
                      - C8K-10A9ACE8-2283-B45A-4E3A-23DFA39DBEF9
                      items:
                        type: string
                        example:
                        - C8K-2F69B355-2B3D-2801-EB48-F44789422299
                        - C8K-10A9ACE8-2283-B45A-4E3A-23DFA39DBEF9
                  $$ref: '#/components/schemas/NvasResponse'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /multicloud/cloudgateway/nvasku:
    get:
      tags:
      - MultiCloud - CloudGateway
      description: Get Azure NVA SKUs
      operationId: getAzureNvaSkuResources
      parameters:
      - name: cloudType
        in: query
        description: Multicloud provider type
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  accountId:
                    type: string
                    example: '112948124124'
                  accountName:
                    type: string
                    example: test_account_name
                  cloudType:
                    type: string
                    example: AZURE
                  nvaSkuId:
                    type: string
                    example: ciscosdwan
                  nvaSkuName:
                    type: string
                    example: ciscosdwan
                  scaleValueList:
                    type: array
                    items:
                      type: object
                      properties:
                        instanceCount:
                          type: integer
                          format: int32
                        instanceType:
                          type: string
                        scaleUnit:
                          type: string
                      $$ref: '#/components/schemas/NvaSkuListResponseScaleValueList'
                  versionList:
                    type: array
                    items:
                      type: string
                $$ref: '#/components/schemas/NvaSkuListResponse'
              examples:
                NVA Skus:
                  description: NVA Skus
                  value:
                  - accountId: '112948124124'
                    accountName: test_accou

# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-catalyst-sdwan/refs/heads/main/openapi/cisco-catalyst-sdwan-multicloud-cloudgateway-api-openapi.yml