Compartilhar via


Microsoft.Network virtualHubs

Definição de recurso do Bicep

O tipo de recurso virtualHubs pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/virtualHubs, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Network/virtualHubs@2025-03-01' = {
  scope: resourceSymbolicName or scope
  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'
  }
}

Valores de propriedade

Microsoft.Network/virtualHubs

Nome Descrição Valor
local Local do recurso. cadeia
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do hub virtual. Propriedades do VirtualHub
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Tags de recursos

Nome Descrição Valor

Sub-Recurso

Nome Descrição Valor
id ID do recurso. cadeia

Propriedades do VirtualHub

Nome Descrição Valor
addressPrefix Prefixo de endereço para este VirtualHub. cadeia
allowBranchToBranchTraffic Sinalizar para controlar o trânsito para o hub VirtualRouter. Bool
azureFirewall O azureFirewall associado a este VirtualHub. sub-recurso
ExpressRouteGateway O expressRouteGateway associado a este VirtualHub. sub-recurso
Preferência de roteamento de hub O hubRoutingPreference deste VirtualHub. 'ASPath'
'ExpressRoute'
'VpnGateway'
p2SVpnGateway O P2SVpnGateway associado a este VirtualHub. sub-recurso
preferredRoutingGateway O gateway preferencial para rotear o tráfego local 'ExpressRoute'
'Nenhum'
'VpnGateway'
Tabela de rotas A routeTable associada a esse hub virtual. virtualHubRouteTable
securityPartnerProvider O securityPartnerProvider associado a este VirtualHub. sub-recurso
nome_do_provedor de segurança O nome do Provedor de Segurança. cadeia
Sku O sku deste VirtualHub. cadeia
virtualHubRouteTableV2s Lista de todas as tabelas de rotas do hub virtual v2 associadas a este VirtualHub. VirtualHubRouteTableV2 []
virtualRouterAsn ASN do VirtualRouter. int

Restrições:
Valor mínimo = 0
Valor máximo = 4294967295
virtualRouterAutoScaleConfiguration A configuração de dimensionamento automático do Roteador do VirtualHub. virtualRouterAutoScaleConfiguration
virtualRouterIps IPs do VirtualRouter. cadeia de caracteres[]
virtualWan O VirtualWAN ao qual o VirtualHub pertence. sub-recurso
vpnGateway O VpnGateway associado a este VirtualHub. sub-recurso

Rota do VirtualHubRoute

Nome Descrição Valor
addressPrefixos Lista de todos os addressPrefixes. cadeia de caracteres[]
PróximoEndereço HopIp Endereço ip NextHop. cadeia

VirtualHubRouteTable

Nome Descrição Valor
Rotas Lista de todas as rotas. do VirtualHubRoute []

VirtualHubRouteTableV2

Nome Descrição Valor
id ID do recurso. cadeia
nome O nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia
Propriedades Propriedades da tabela de rotas do hub virtual v2. virtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nome Descrição Valor
AttachedConnections Lista de todas as conexões anexadas a esta tabela de rotas v2. cadeia de caracteres[]
Rotas Lista de todas as rotas. VirtualHubRouteV2 []

VirtualHubRouteV2

Nome Descrição Valor
Destinos Lista de todos os destinos. cadeia de caracteres[]
destinationType O tipo de destinos. cadeia
PróximoLúpulo Endereço ip NextHops. cadeia de caracteres[]
próximoTipo de salto O tipo de próximo salto. cadeia

VirtualRouterAutoScaleConfiguration

Nome Descrição Valor
capacidade mínima O número mínimo de unidades de escala para o Roteador do VirtualHub. int

Restrições:
Valor mínimo = 0

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Descrição
do Hub Virtual Módulo de recurso AVM para o Hub Virtual

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
criar um servidor de rota em um novo de sub-rede Esse modelo implanta um Servidor de Rota em uma sub-rede chamada RouteServerSubnet.
cria recursos de WAN Virtual Esse modelo permite que você crie recursos de WAN virtual, incluindo WAN Virtual, Hub Virtual, Gateway de VPN, Site de VPN e um Vpn Connecton.
hubs virtuais protegidos Esse modelo cria um hub virtual seguro usando o Firewall do Azure para proteger o tráfego de rede de nuvem destinado à Internet.

Definição de recurso de modelo do ARM

O tipo de recurso virtualHubs pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso microsoft.network/virtualHubs, adicione o JSON a seguir ao seu modelo.

{
  "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"
  }
}

Valores de propriedade

Microsoft.Network/virtualHubs

Nome Descrição Valor
apiVersion A versão da API '2025-03-01'
local Local do recurso. cadeia
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do hub virtual. Propriedades do VirtualHub
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Network/virtualHubs'

Tags de recursos

Nome Descrição Valor

Sub-Recurso

Nome Descrição Valor
id ID do recurso. cadeia

Propriedades do VirtualHub

Nome Descrição Valor
addressPrefix Prefixo de endereço para este VirtualHub. cadeia
allowBranchToBranchTraffic Sinalizar para controlar o trânsito para o hub VirtualRouter. Bool
azureFirewall O azureFirewall associado a este VirtualHub. sub-recurso
ExpressRouteGateway O expressRouteGateway associado a este VirtualHub. sub-recurso
Preferência de roteamento de hub O hubRoutingPreference deste VirtualHub. 'ASPath'
'ExpressRoute'
'VpnGateway'
p2SVpnGateway O P2SVpnGateway associado a este VirtualHub. sub-recurso
preferredRoutingGateway O gateway preferencial para rotear o tráfego local 'ExpressRoute'
'Nenhum'
'VpnGateway'
Tabela de rotas A routeTable associada a esse hub virtual. virtualHubRouteTable
securityPartnerProvider O securityPartnerProvider associado a este VirtualHub. sub-recurso
nome_do_provedor de segurança O nome do Provedor de Segurança. cadeia
Sku O sku deste VirtualHub. cadeia
virtualHubRouteTableV2s Lista de todas as tabelas de rotas do hub virtual v2 associadas a este VirtualHub. VirtualHubRouteTableV2 []
virtualRouterAsn ASN do VirtualRouter. int

Restrições:
Valor mínimo = 0
Valor máximo = 4294967295
virtualRouterAutoScaleConfiguration A configuração de dimensionamento automático do Roteador do VirtualHub. virtualRouterAutoScaleConfiguration
virtualRouterIps IPs do VirtualRouter. cadeia de caracteres[]
virtualWan O VirtualWAN ao qual o VirtualHub pertence. sub-recurso
vpnGateway O VpnGateway associado a este VirtualHub. sub-recurso

Rota do VirtualHubRoute

Nome Descrição Valor
addressPrefixos Lista de todos os addressPrefixes. cadeia de caracteres[]
PróximoEndereço HopIp Endereço ip NextHop. cadeia

VirtualHubRouteTable

Nome Descrição Valor
Rotas Lista de todas as rotas. do VirtualHubRoute []

VirtualHubRouteTableV2

Nome Descrição Valor
id ID do recurso. cadeia
nome O nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia
Propriedades Propriedades da tabela de rotas do hub virtual v2. virtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nome Descrição Valor
AttachedConnections Lista de todas as conexões anexadas a esta tabela de rotas v2. cadeia de caracteres[]
Rotas Lista de todas as rotas. VirtualHubRouteV2 []

VirtualHubRouteV2

Nome Descrição Valor
Destinos Lista de todos os destinos. cadeia de caracteres[]
destinationType O tipo de destinos. cadeia
PróximoLúpulo Endereço ip NextHops. cadeia de caracteres[]
próximoTipo de salto O tipo de próximo salto. cadeia

VirtualRouterAutoScaleConfiguration

Nome Descrição Valor
capacidade mínima O número mínimo de unidades de escala para o Roteador do VirtualHub. int

Restrições:
Valor mínimo = 0

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo Descrição
Servidor de Rotas do Azure no emparelhamento BGP com o Quagga

Implantar no Azure
Este modelo implanta um Servidor roteador e uma VM do Ubuntu com Quagga. Duas sessões BGP externas são estabelecidas entre o Servidor roteador e o Quagga. A instalação e a configuração do Quagga são executadas pela extensão de script personalizado do Azure para linux
implantação de vários hubs da WAN Virtual do Azure (vWAN)

Implantar no Azure
Esse modelo permite que você crie uma implantação de vários hubs da WAN Virtual do Azure (vWAN), incluindo todos os gateways e conexões VNET.
implantação de vários hubs vWAN do Azure com tabelas de roteamento personalizadas

Implantar no Azure
Esse modelo permite que você crie uma implantação de vários hubs da WAN Virtual do Azure (vWAN), incluindo todos os gateways e conexões VNET, e demonstre o uso de Tabelas de Rota para roteamento personalizado.
criar um servidor de rota em um novo de sub-rede

Implantar no Azure
Esse modelo implanta um Servidor de Rota em uma sub-rede chamada RouteServerSubnet.
cria recursos de WAN Virtual

Implantar no Azure
Esse modelo permite que você crie recursos de WAN virtual, incluindo WAN Virtual, Hub Virtual, Gateway de VPN, Site de VPN e um Vpn Connecton.
hubs virtuais protegidos

Implantar no Azure
Esse modelo cria um hub virtual seguro usando o Firewall do Azure para proteger o tráfego de rede de nuvem destinado à Internet.
implantação do vWAN P2S com pool de vários endereços e grupos de usuários

Implantar no Azure
Este modelo implanta a WAN Virtual do Azure (vWAN) com um P2S configurado com vários pools de endereços e grupos de usuários

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso virtualHubs pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/virtualHubs, adicione o Terraform a seguir ao seu modelo.

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"
      }
    }
  }
}

Valores de propriedade

Microsoft.Network/virtualHubs

Nome Descrição Valor
local Local do recurso. cadeia
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
Propriedades Propriedades do hub virtual. Propriedades do VirtualHub
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Network/virtualHubs@2025-03-01"

Tags de recursos

Nome Descrição Valor

Sub-Recurso

Nome Descrição Valor
id ID do recurso. cadeia

Propriedades do VirtualHub

Nome Descrição Valor
addressPrefix Prefixo de endereço para este VirtualHub. cadeia
allowBranchToBranchTraffic Sinalizar para controlar o trânsito para o hub VirtualRouter. Bool
azureFirewall O azureFirewall associado a este VirtualHub. sub-recurso
ExpressRouteGateway O expressRouteGateway associado a este VirtualHub. sub-recurso
Preferência de roteamento de hub O hubRoutingPreference deste VirtualHub. 'ASPath'
'ExpressRoute'
'VpnGateway'
p2SVpnGateway O P2SVpnGateway associado a este VirtualHub. sub-recurso
preferredRoutingGateway O gateway preferencial para rotear o tráfego local 'ExpressRoute'
'Nenhum'
'VpnGateway'
Tabela de rotas A routeTable associada a esse hub virtual. virtualHubRouteTable
securityPartnerProvider O securityPartnerProvider associado a este VirtualHub. sub-recurso
nome_do_provedor de segurança O nome do Provedor de Segurança. cadeia
Sku O sku deste VirtualHub. cadeia
virtualHubRouteTableV2s Lista de todas as tabelas de rotas do hub virtual v2 associadas a este VirtualHub. VirtualHubRouteTableV2 []
virtualRouterAsn ASN do VirtualRouter. int

Restrições:
Valor mínimo = 0
Valor máximo = 4294967295
virtualRouterAutoScaleConfiguration A configuração de dimensionamento automático do Roteador do VirtualHub. virtualRouterAutoScaleConfiguration
virtualRouterIps IPs do VirtualRouter. cadeia de caracteres[]
virtualWan O VirtualWAN ao qual o VirtualHub pertence. sub-recurso
vpnGateway O VpnGateway associado a este VirtualHub. sub-recurso

Rota do VirtualHubRoute

Nome Descrição Valor
addressPrefixos Lista de todos os addressPrefixes. cadeia de caracteres[]
PróximoEndereço HopIp Endereço ip NextHop. cadeia

VirtualHubRouteTable

Nome Descrição Valor
Rotas Lista de todas as rotas. do VirtualHubRoute []

VirtualHubRouteTableV2

Nome Descrição Valor
id ID do recurso. cadeia
nome O nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia
Propriedades Propriedades da tabela de rotas do hub virtual v2. virtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nome Descrição Valor
AttachedConnections Lista de todas as conexões anexadas a esta tabela de rotas v2. cadeia de caracteres[]
Rotas Lista de todas as rotas. VirtualHubRouteV2 []

VirtualHubRouteV2

Nome Descrição Valor
Destinos Lista de todos os destinos. cadeia de caracteres[]
destinationType O tipo de destinos. cadeia
PróximoLúpulo Endereço ip NextHops. cadeia de caracteres[]
próximoTipo de salto O tipo de próximo salto. cadeia

VirtualRouterAutoScaleConfiguration

Nome Descrição Valor
capacidade mínima O número mínimo de unidades de escala para o Roteador do VirtualHub. int

Restrições:
Valor mínimo = 0

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Hub Virtual em uma WAN Virtual.

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    = ["*"]
}