Microsoft.Network virtualHubs/bgpConnections

Bicep resource definition

The virtualHubs/bgpConnections resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/virtualHubs/bgpConnections resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Network/virtualHubs/bgpConnections@2025-07-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    hubVirtualNetworkConnection: {
      id: 'string'
    }
    peerAsn: int
    peerIp: 'string'
    routingConfiguration: {
      associatedRouteTable: {
        id: 'string'
      }
      inboundRouteMap: {
        id: 'string'
      }
      outboundRouteMap: {
        id: 'string'
      }
      propagatedRouteTables: {
        ids: [
          {
            id: 'string'
          }
        ]
        labels: [
          'string'
        ]
      }
      vnetRoutes: {
        staticRoutes: [
          {
            addressPrefixes: [
              'string'
            ]
            name: 'string'
            nextHopIpAddress: 'string'
          }
        ]
        staticRoutesConfig: {
          propagateStaticRoutes: bool
          vnetLocalRouteOverrideCriteria: 'string'
        }
      }
    }
  }
}

Property Values

Microsoft.Network/virtualHubs/bgpConnections

Name Description Value
name The resource name string (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: virtualHubs
properties The properties of the Bgp connections. BgpConnectionProperties

BgpConnectionProperties

Name Description Value
hubVirtualNetworkConnection The reference to the HubVirtualNetworkConnection resource. CommonSubResource
peerAsn Peer ASN. int

Constraints:
Min value = 0
Max value = 4294967295
peerIp Peer IP. string
routingConfiguration The routing configuration indicating the associated and propagated route tables for this connection. RoutingConfiguration

CommonSubResource

Name Description Value
id Resource ID. string

PropagatedRouteTable

Name Description Value
ids The list of resource ids of all the RouteTables. CommonSubResource[]
labels The list of labels. string[]

RoutingConfiguration

Name Description Value
associatedRouteTable The resource id RouteTable associated with this RoutingConfiguration. CommonSubResource
inboundRouteMap The resource id of the RouteMap associated with this RoutingConfiguration for inbound learned routes. CommonSubResource
outboundRouteMap The resource id of theRouteMap associated with this RoutingConfiguration for outbound advertised routes. CommonSubResource
propagatedRouteTables The list of RouteTables to advertise the routes to. PropagatedRouteTable
vnetRoutes List of routes that control routing from VirtualHub into a virtual network connection. VnetRoute

StaticRoute

Name Description Value
addressPrefixes List of all address prefixes. string[]
name The name of the StaticRoute that is unique within a VnetRoute. string
nextHopIpAddress The ip address of the next hop. string

StaticRoutesConfig

Name Description Value
propagateStaticRoutes Boolean indicating whether static routes on this connection are automatically propagate to route tables which this connection propagates to. bool
vnetLocalRouteOverrideCriteria Parameter determining whether NVA in spoke vnet is bypassed for traffic with destination in spoke. 'Contains'
'Equal'

VnetRoute

Name Description Value
staticRoutes List of all Static Routes. StaticRoute[]
staticRoutesConfig Configuration for static routes on this HubVnetConnection. StaticRoutesConfig

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File Description
Create a Route Server in a New Subnet This template deploys a Route Server into a subnet named RouteServerSubnet.

ARM template resource definition

The virtualHubs/bgpConnections resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/virtualHubs/bgpConnections resource, add the following JSON to your template.

{
  "type": "Microsoft.Network/virtualHubs/bgpConnections",
  "apiVersion": "2025-07-01",
  "name": "string",
  "properties": {
    "hubVirtualNetworkConnection": {
      "id": "string"
    },
    "peerAsn": "int",
    "peerIp": "string",
    "routingConfiguration": {
      "associatedRouteTable": {
        "id": "string"
      },
      "inboundRouteMap": {
        "id": "string"
      },
      "outboundRouteMap": {
        "id": "string"
      },
      "propagatedRouteTables": {
        "ids": [
          {
            "id": "string"
          }
        ],
        "labels": [ "string" ]
      },
      "vnetRoutes": {
        "staticRoutes": [
          {
            "addressPrefixes": [ "string" ],
            "name": "string",
            "nextHopIpAddress": "string"
          }
        ],
        "staticRoutesConfig": {
          "propagateStaticRoutes": "bool",
          "vnetLocalRouteOverrideCriteria": "string"
        }
      }
    }
  }
}

Property Values

Microsoft.Network/virtualHubs/bgpConnections

Name Description Value
apiVersion The api version '2025-07-01'
name The resource name string (required)
properties The properties of the Bgp connections. BgpConnectionProperties
type The resource type 'Microsoft.Network/virtualHubs/bgpConnections'

BgpConnectionProperties

Name Description Value
hubVirtualNetworkConnection The reference to the HubVirtualNetworkConnection resource. CommonSubResource
peerAsn Peer ASN. int

Constraints:
Min value = 0
Max value = 4294967295
peerIp Peer IP. string
routingConfiguration The routing configuration indicating the associated and propagated route tables for this connection. RoutingConfiguration

CommonSubResource

Name Description Value
id Resource ID. string

PropagatedRouteTable

Name Description Value
ids The list of resource ids of all the RouteTables. CommonSubResource[]
labels The list of labels. string[]

RoutingConfiguration

Name Description Value
associatedRouteTable The resource id RouteTable associated with this RoutingConfiguration. CommonSubResource
inboundRouteMap The resource id of the RouteMap associated with this RoutingConfiguration for inbound learned routes. CommonSubResource
outboundRouteMap The resource id of theRouteMap associated with this RoutingConfiguration for outbound advertised routes. CommonSubResource
propagatedRouteTables The list of RouteTables to advertise the routes to. PropagatedRouteTable
vnetRoutes List of routes that control routing from VirtualHub into a virtual network connection. VnetRoute

StaticRoute

Name Description Value
addressPrefixes List of all address prefixes. string[]
name The name of the StaticRoute that is unique within a VnetRoute. string
nextHopIpAddress The ip address of the next hop. string

StaticRoutesConfig

Name Description Value
propagateStaticRoutes Boolean indicating whether static routes on this connection are automatically propagate to route tables which this connection propagates to. bool
vnetLocalRouteOverrideCriteria Parameter determining whether NVA in spoke vnet is bypassed for traffic with destination in spoke. 'Contains'
'Equal'

VnetRoute

Name Description Value
staticRoutes List of all Static Routes. StaticRoute[]
staticRoutesConfig Configuration for static routes on this HubVnetConnection. StaticRoutesConfig

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Azure Route Server in BGP peering with Quagga

Deploy to Azure
This template deploys a Router Server and Ubuntu VM with Quagga. Two external BGP sessions are established between the Router Server and Quagga. Installation and configuration of Quagga is executed by Azure custom script extension for linux
Create a Route Server in a New Subnet

Deploy to Azure
This template deploys a Route Server into a subnet named RouteServerSubnet.

Terraform (AzAPI provider) resource definition

The virtualHubs/bgpConnections resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/virtualHubs/bgpConnections resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualHubs/bgpConnections@2025-07-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      hubVirtualNetworkConnection = {
        id = "string"
      }
      peerAsn = int
      peerIp = "string"
      routingConfiguration = {
        associatedRouteTable = {
          id = "string"
        }
        inboundRouteMap = {
          id = "string"
        }
        outboundRouteMap = {
          id = "string"
        }
        propagatedRouteTables = {
          ids = [
            {
              id = "string"
            }
          ]
          labels = [
            "string"
          ]
        }
        vnetRoutes = {
          staticRoutes = [
            {
              addressPrefixes = [
                "string"
              ]
              name = "string"
              nextHopIpAddress = "string"
            }
          ]
          staticRoutesConfig = {
            propagateStaticRoutes = bool
            vnetLocalRouteOverrideCriteria = "string"
          }
        }
      }
    }
  }
}

Property Values

Microsoft.Network/virtualHubs/bgpConnections

Name Description Value
name The resource name string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: virtualHubs
properties The properties of the Bgp connections. BgpConnectionProperties
type The resource type "Microsoft.Network/virtualHubs/bgpConnections@2025-07-01"

BgpConnectionProperties

Name Description Value
hubVirtualNetworkConnection The reference to the HubVirtualNetworkConnection resource. CommonSubResource
peerAsn Peer ASN. int

Constraints:
Min value = 0
Max value = 4294967295
peerIp Peer IP. string
routingConfiguration The routing configuration indicating the associated and propagated route tables for this connection. RoutingConfiguration

CommonSubResource

Name Description Value
id Resource ID. string

PropagatedRouteTable

Name Description Value
ids The list of resource ids of all the RouteTables. CommonSubResource[]
labels The list of labels. string[]

RoutingConfiguration

Name Description Value
associatedRouteTable The resource id RouteTable associated with this RoutingConfiguration. CommonSubResource
inboundRouteMap The resource id of the RouteMap associated with this RoutingConfiguration for inbound learned routes. CommonSubResource
outboundRouteMap The resource id of theRouteMap associated with this RoutingConfiguration for outbound advertised routes. CommonSubResource
propagatedRouteTables The list of RouteTables to advertise the routes to. PropagatedRouteTable
vnetRoutes List of routes that control routing from VirtualHub into a virtual network connection. VnetRoute

StaticRoute

Name Description Value
addressPrefixes List of all address prefixes. string[]
name The name of the StaticRoute that is unique within a VnetRoute. string
nextHopIpAddress The ip address of the next hop. string

StaticRoutesConfig

Name Description Value
propagateStaticRoutes Boolean indicating whether static routes on this connection are automatically propagate to route tables which this connection propagates to. bool
vnetLocalRouteOverrideCriteria Parameter determining whether NVA in spoke vnet is bypassed for traffic with destination in spoke. 'Contains'
'Equal'

VnetRoute

Name Description Value
staticRoutes List of all Static Routes. StaticRoute[]
staticRoutesConfig Configuration for static routes on this HubVnetConnection. StaticRoutesConfig