Microsoft.Network virtualHubs 2025-03-01

Определение ресурсов Bicep

Тип ресурса virtualHubs можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/virtualHubs, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Network/virtualHubs@2025-03-01' = {
  location: 'string'
  name: 'string'
  properties: {
    addressPrefix: 'string'
    allowBranchToBranchTraffic: bool
    azureFirewall: {
      id: 'string'
    }
    expressRouteGateway: {
      id: 'string'
    }
    hubRoutingPreference: 'string'
    p2SVpnGateway: {
      id: 'string'
    }
    preferredRoutingGateway: 'string'
    routeTable: {
      routes: [
        {
          addressPrefixes: [
            'string'
          ]
          nextHopIpAddress: 'string'
        }
      ]
    }
    securityPartnerProvider: {
      id: 'string'
    }
    securityProviderName: 'string'
    sku: 'string'
    virtualHubRouteTableV2s: [
      {
        id: 'string'
        name: 'string'
        properties: {
          attachedConnections: [
            'string'
          ]
          routes: [
            {
              destinations: [
                'string'
              ]
              destinationType: 'string'
              nextHops: [
                'string'
              ]
              nextHopType: 'string'
            }
          ]
        }
      }
    ]
    virtualRouterAsn: int
    virtualRouterAutoScaleConfiguration: {
      minCapacity: int
    }
    virtualRouterIps: [
      'string'
    ]
    virtualWan: {
      id: 'string'
    }
    vpnGateway: {
      id: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

Microsoft.Network/virtualHubs

Имя Description Ценность
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства виртуального концентратора. Свойства VirtualHub
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

Теги ресурса

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Свойства VirtualHub

Имя Description Ценность
addressПрефикс Префикс адреса для этого ВиртуальногоHub. струна
allowBranchToBranchTraffic Пометка для управления транзитом для концентратора VirtualRouter. bool
azureFirewall AzureFirewall, связанный с этим VirtualHub. Подресурс
expressRouteGateway ExpressRouteGateway, связанный с этим VirtualHub. Подресурс
hubRoutingPreference HubRoutingPreference этого ВиртуальногоHub. AsPath
ExpressRoute
"VpnGateway"
Шлюз p2SVpnGateway P2SVpnGateway, связанный с этим VirtualHub. Подресурс
предпочтительное значениеRoutingGateway Предпочтительный шлюз для маршрутизации локального трафика ExpressRoute
'None'
"VpnGateway"
RouteTable Маршрутная таблица, связанная с этим виртуальным концентратором. Таблица маршрутов VirtualHubRoute
securityPartnerProvider SecurityPartnerProvider, связанный с этим VirtualHub. Подресурс
securityProviderName Имя поставщика безопасности. струна
sku SKU этого ВиртуальногоHub. струна
virtualHubRouteTableV2s Список всех таблиц маршрутов виртуального концентратора версии 2, связанных с этим VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn Виртуальный маршрутизатор ASN. int

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 4294967295
virtualRouterAutoScaleConfiguration Конфигурация автомасштабирования маршрутизатора VirtualHub. VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)
virtualRouterIps Ip-адреса VirtualRouter. строка[]
virtualWan Виртуальная глобальная сеть, к которой принадлежит VirtualHub. Подресурс
vpnШлюз VpnGateway, связанный с этим VirtualHub. Подресурс

Виртуальный HubRoute

Имя Description Ценность
addressПрефиксы Список всех адресовPrefixes. строка[]
nextHopIpAddress Ip-адрес NextHop. струна

Таблица маршрутов VirtualHubRoute

Имя Description Ценность
routes Список всех маршрутов. VirtualHubRoute[]

VirtualHubRouteTableV2

Имя Description Ценность
id Идентификатор ресурса. струна
имя Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. струна
properties Свойства таблицы маршрутов виртуального концентратора версии 2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Имя Description Ценность
присоединенные подключения Список всех подключений, подключенных к этой таблице маршрутов версии 2. строка[]
routes Список всех маршрутов. VirtualHubRouteV2[]

VirtualHubRouteV2

Имя Description Ценность
destinations Список всех назначений. строка[]
Тип назначения Тип назначений. струна
следующийХмель Ip-адрес NextHops. строка[]
nextHopType Тип следующего прыжка. струна

VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)

Имя Description Ценность
минПроизводительность Минимальное количество единиц масштабирования для маршрутизатора VirtualHub. int

Ограничения целостности:
Минимальное значение = 0

Примеры использования

Примеры Bicep

Простой пример развертывания виртуального концентратора в виртуальной глобальной сети.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource virtualHub 'Microsoft.Network/virtualHubs@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressPrefix: '10.0.0.0/24'
    hubRoutingPreference: 'ExpressRoute'
    virtualRouterAutoScaleConfiguration: {
      minCapacity: 2
    }
    virtualWan: {
      id: virtualWan.id
    }
  }
}

resource virtualWan 'Microsoft.Network/virtualWans@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    allowBranchToBranchTraffic: true
    disableVpnEncryption: false
    office365LocalBreakoutCategory: 'None'
    type: 'Standard'
  }
}

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Description
Виртуальный концентратор Модуль ресурсов AVM для виртуального концентратора

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Файл Bicep Description
создание сервера маршрутизации в новой подсети Этот шаблон развертывает сервер маршрутизации в подсети с именем RouteServerSubnet.
Создание ресурсов виртуальной глобальной сети Этот шаблон позволяет создавать ресурсы виртуальной глобальной сети, включая виртуальную глобальную сеть, виртуальный концентратор, VPN-шлюз, VPN-сайт и VPN-подключение.
Защищенные виртуальные центры Этот шаблон создает защищенный виртуальный концентратор с помощью брандмауэра Azure для защиты облачного сетевого трафика, предназначенного для Интернета.

Определение ресурса шаблона ARM

Тип ресурса virtualHubs можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/virtualHubs, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Network/virtualHubs",
  "apiVersion": "2025-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "addressPrefix": "string",
    "allowBranchToBranchTraffic": "bool",
    "azureFirewall": {
      "id": "string"
    },
    "expressRouteGateway": {
      "id": "string"
    },
    "hubRoutingPreference": "string",
    "p2SVpnGateway": {
      "id": "string"
    },
    "preferredRoutingGateway": "string",
    "routeTable": {
      "routes": [
        {
          "addressPrefixes": [ "string" ],
          "nextHopIpAddress": "string"
        }
      ]
    },
    "securityPartnerProvider": {
      "id": "string"
    },
    "securityProviderName": "string",
    "sku": "string",
    "virtualHubRouteTableV2s": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "attachedConnections": [ "string" ],
          "routes": [
            {
              "destinations": [ "string" ],
              "destinationType": "string",
              "nextHops": [ "string" ],
              "nextHopType": "string"
            }
          ]
        }
      }
    ],
    "virtualRouterAsn": "int",
    "virtualRouterAutoScaleConfiguration": {
      "minCapacity": "int"
    },
    "virtualRouterIps": [ "string" ],
    "virtualWan": {
      "id": "string"
    },
    "vpnGateway": {
      "id": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

Microsoft.Network/virtualHubs

Имя Description Ценность
apiVersion Версия API '2025-03-01'
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства виртуального концентратора. Свойства VirtualHub
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса "Microsoft.Network/virtualHubs"

Теги ресурса

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Свойства VirtualHub

Имя Description Ценность
addressПрефикс Префикс адреса для этого ВиртуальногоHub. струна
allowBranchToBranchTraffic Пометка для управления транзитом для концентратора VirtualRouter. bool
azureFirewall AzureFirewall, связанный с этим VirtualHub. Подресурс
expressRouteGateway ExpressRouteGateway, связанный с этим VirtualHub. Подресурс
hubRoutingPreference HubRoutingPreference этого ВиртуальногоHub. AsPath
ExpressRoute
"VpnGateway"
Шлюз p2SVpnGateway P2SVpnGateway, связанный с этим VirtualHub. Подресурс
предпочтительное значениеRoutingGateway Предпочтительный шлюз для маршрутизации локального трафика ExpressRoute
'None'
"VpnGateway"
RouteTable Маршрутная таблица, связанная с этим виртуальным концентратором. Таблица маршрутов VirtualHubRoute
securityPartnerProvider SecurityPartnerProvider, связанный с этим VirtualHub. Подресурс
securityProviderName Имя поставщика безопасности. струна
sku SKU этого ВиртуальногоHub. струна
virtualHubRouteTableV2s Список всех таблиц маршрутов виртуального концентратора версии 2, связанных с этим VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn Виртуальный маршрутизатор ASN. int

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 4294967295
virtualRouterAutoScaleConfiguration Конфигурация автомасштабирования маршрутизатора VirtualHub. VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)
virtualRouterIps Ip-адреса VirtualRouter. строка[]
virtualWan Виртуальная глобальная сеть, к которой принадлежит VirtualHub. Подресурс
vpnШлюз VpnGateway, связанный с этим VirtualHub. Подресурс

Виртуальный HubRoute

Имя Description Ценность
addressПрефиксы Список всех адресовPrefixes. строка[]
nextHopIpAddress Ip-адрес NextHop. струна

Таблица маршрутов VirtualHubRoute

Имя Description Ценность
routes Список всех маршрутов. VirtualHubRoute[]

VirtualHubRouteTableV2

Имя Description Ценность
id Идентификатор ресурса. струна
имя Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. струна
properties Свойства таблицы маршрутов виртуального концентратора версии 2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Имя Description Ценность
присоединенные подключения Список всех подключений, подключенных к этой таблице маршрутов версии 2. строка[]
routes Список всех маршрутов. VirtualHubRouteV2[]

VirtualHubRouteV2

Имя Description Ценность
destinations Список всех назначений. строка[]
Тип назначения Тип назначений. струна
следующийХмель Ip-адрес NextHops. строка[]
nextHopType Тип следующего прыжка. струна

VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)

Имя Description Ценность
минПроизводительность Минимальное количество единиц масштабирования для маршрутизатора VirtualHub. int

Ограничения целостности:
Минимальное значение = 0

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
сервер маршрутизации Azure в пиринге BGP с quagga

Развертывание в Azure
Этот шаблон развертывает сервер маршрутизатора и виртуальную машину Ubuntu с помощью Quagga. Между сервером маршрутизатора и Quagga устанавливаются два внешних сеанса BGP. Установка и настройка Quagga выполняется расширением пользовательских скриптов Azure для Linux
развертывание виртуальной глобальной сети Azure (vWAN) с несколькими центрами

Развертывание в Azure
Этот шаблон позволяет создать развертывание виртуальной глобальной сети Azure (vWAN), включая все шлюзы и подключения виртуальной сети.
развертывании нескольких концентраторов Azure vWAN с пользовательскими таблицами маршрутизации

Развертывание в Azure
Этот шаблон позволяет создать развертывание виртуальной глобальной сети Azure (vWAN), включая все шлюзы и подключения виртуальной сети, и продемонстрировать использование таблиц маршрутов для пользовательской маршрутизации.
создание сервера маршрутизации в новой подсети

Развертывание в Azure
Этот шаблон развертывает сервер маршрутизации в подсети с именем RouteServerSubnet.
Создание ресурсов виртуальной глобальной сети

Развертывание в Azure
Этот шаблон позволяет создавать ресурсы виртуальной глобальной сети, включая виртуальную глобальную сеть, виртуальный концентратор, VPN-шлюз, VPN-сайт и VPN-подключение.
Защищенные виртуальные центры

Развертывание в Azure
Этот шаблон создает защищенный виртуальный концентратор с помощью брандмауэра Azure для защиты облачного сетевого трафика, предназначенного для Интернета.
развертывание VWAN P2S с несколькими адресными пулами и группами пользователей

Развертывание в Azure
Этот шаблон развертывает виртуальную глобальную сеть Azure (vWAN) с помощью P2S, настроенной с несколькими пулами адресов и группами пользователей.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса virtualHubs можно развернуть с помощью операций, предназначенных для следующих операций:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/virtualHubs, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualHubs@2025-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      addressPrefix = "string"
      allowBranchToBranchTraffic = bool
      azureFirewall = {
        id = "string"
      }
      expressRouteGateway = {
        id = "string"
      }
      hubRoutingPreference = "string"
      p2SVpnGateway = {
        id = "string"
      }
      preferredRoutingGateway = "string"
      routeTable = {
        routes = [
          {
            addressPrefixes = [
              "string"
            ]
            nextHopIpAddress = "string"
          }
        ]
      }
      securityPartnerProvider = {
        id = "string"
      }
      securityProviderName = "string"
      sku = "string"
      virtualHubRouteTableV2s = [
        {
          id = "string"
          name = "string"
          properties = {
            attachedConnections = [
              "string"
            ]
            routes = [
              {
                destinations = [
                  "string"
                ]
                destinationType = "string"
                nextHops = [
                  "string"
                ]
                nextHopType = "string"
              }
            ]
          }
        }
      ]
      virtualRouterAsn = int
      virtualRouterAutoScaleConfiguration = {
        minCapacity = int
      }
      virtualRouterIps = [
        "string"
      ]
      virtualWan = {
        id = "string"
      }
      vpnGateway = {
        id = "string"
      }
    }
  }
}

Значения свойств

Microsoft.Network/virtualHubs

Имя Description Ценность
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства виртуального концентратора. Свойства VirtualHub
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.Network/virtualHubs@2025-03-01"

Теги ресурса

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Свойства VirtualHub

Имя Description Ценность
addressПрефикс Префикс адреса для этого ВиртуальногоHub. струна
allowBranchToBranchTraffic Пометка для управления транзитом для концентратора VirtualRouter. bool
azureFirewall AzureFirewall, связанный с этим VirtualHub. Подресурс
expressRouteGateway ExpressRouteGateway, связанный с этим VirtualHub. Подресурс
hubRoutingPreference HubRoutingPreference этого ВиртуальногоHub. AsPath
ExpressRoute
"VpnGateway"
Шлюз p2SVpnGateway P2SVpnGateway, связанный с этим VirtualHub. Подресурс
предпочтительное значениеRoutingGateway Предпочтительный шлюз для маршрутизации локального трафика ExpressRoute
'None'
"VpnGateway"
RouteTable Маршрутная таблица, связанная с этим виртуальным концентратором. Таблица маршрутов VirtualHubRoute
securityPartnerProvider SecurityPartnerProvider, связанный с этим VirtualHub. Подресурс
securityProviderName Имя поставщика безопасности. струна
sku SKU этого ВиртуальногоHub. струна
virtualHubRouteTableV2s Список всех таблиц маршрутов виртуального концентратора версии 2, связанных с этим VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn Виртуальный маршрутизатор ASN. int

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 4294967295
virtualRouterAutoScaleConfiguration Конфигурация автомасштабирования маршрутизатора VirtualHub. VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)
virtualRouterIps Ip-адреса VirtualRouter. строка[]
virtualWan Виртуальная глобальная сеть, к которой принадлежит VirtualHub. Подресурс
vpnШлюз VpnGateway, связанный с этим VirtualHub. Подресурс

Виртуальный HubRoute

Имя Description Ценность
addressПрефиксы Список всех адресовPrefixes. строка[]
nextHopIpAddress Ip-адрес NextHop. струна

Таблица маршрутов VirtualHubRoute

Имя Description Ценность
routes Список всех маршрутов. VirtualHubRoute[]

VirtualHubRouteTableV2

Имя Description Ценность
id Идентификатор ресурса. струна
имя Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. струна
properties Свойства таблицы маршрутов виртуального концентратора версии 2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Имя Description Ценность
присоединенные подключения Список всех подключений, подключенных к этой таблице маршрутов версии 2. строка[]
routes Список всех маршрутов. VirtualHubRouteV2[]

VirtualHubRouteV2

Имя Description Ценность
destinations Список всех назначений. строка[]
Тип назначения Тип назначений. струна
следующийХмель Ip-адрес NextHops. строка[]
nextHopType Тип следующего прыжка. струна

VirtualRouterAutoScaleConfiguration (Конфигурация VirtualRouterAutoScale)

Имя Description Ценность
минПроизводительность Минимальное количество единиц масштабирования для маршрутизатора VirtualHub. int

Ограничения целостности:
Минимальное значение = 0

Примеры использования

Примеры Terraform

Простой пример развертывания виртуального концентратора в виртуальной глобальной сети.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "virtualWan" {
  type      = "Microsoft.Network/virtualWans@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      allowBranchToBranchTraffic     = true
      disableVpnEncryption           = false
      office365LocalBreakoutCategory = "None"
      type                           = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualHub" {
  type      = "Microsoft.Network/virtualHubs@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressPrefix        = "10.0.0.0/24"
      hubRoutingPreference = "ExpressRoute"
      virtualRouterAutoScaleConfiguration = {
        minCapacity = 2
      }
      virtualWan = {
        id = azapi_resource.virtualWan.id
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}