Partager via


Microsoft.Network virtualHubs 2025-01-01

Définition de ressource Bicep

Le type de ressource virtualHubs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/virtualHubs, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Network/virtualHubs@2025-01-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'
  }
}

Valeurs de propriété

Microsoft.Network/virtualHubs

Nom Descriptif Valeur
location Emplacement des ressources. ficelle
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du hub virtuel. VirtualHubPropriétés
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ResourceTags

Nom Descriptif Valeur

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle

VirtualHubPropriétés

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse pour ce VirtualHub. ficelle
allowBranchToBranchTraffic Indicateur pour contrôler le transit pour le hub VirtualRouter. bool
azureFirewall L’azureFirewall associé à ce VirtualHub. Sous-ressource
expressRouteGateway expressRouteGateway associé à ce VirtualHub. Sous-ressource
hubRoutingPreference Le hubRoutingPreference de ce VirtualHub. 'ASPath'
'ExpressRoute'
'Passerelle VPN'
p2SVpnGateway Le P2SVpnGateway associé à ce VirtualHub. Sous-ressource
preferredRoutingGateway La passerelle préférée pour acheminer le trafic sur site 'ExpressRoute'
'None'
'Passerelle VPN'
routeTable Route Table associée à ce hub virtuel. VirtualHubRouteTable
securityPartnerProvider Le securityPartnerProvider associé à ce VirtualHub. Sous-ressource
securityProviderName Nom du fournisseur de sécurité. ficelle
sku Le sku de ce VirtualHub. ficelle
virtualHubRouteTableV2s Liste de toutes les tables de routage v2 du hub virtuel associées à ce VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn ASN VirtualRouter. int

Constraints:
Valeur minimale = 0
Valeur maximale = 4294967295
virtualRouterAutoScaleConfiguration Configuration de la mise à l’échelle automatique du routeur VirtualHub. VirtualRouterAutoScaleConfiguration
virtualRouterIps IP du routeur virtuel. chaîne de caractères[]
virtuelWan Le VirtualWAN auquel appartient le VirtualHub. Sous-ressource
vpnPasserelle Le VpnGateway associé à ce VirtualHub. Sous-ressource

VirtualHubRoute (en anglais)

Nom Descriptif Valeur
adressePréfixes Liste de tous les addressPrefixes. chaîne de caractères[]
suivantHopIpAddress Adresse IP NextHop. ficelle

VirtualHubRouteTable

Nom Descriptif Valeur
routes Liste de tous les itinéraires. VirtualHubRoute[]

VirtualHubRouteTableV2

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle
nom Nom de la ressource unique au sein d’un groupe de ressources. Ce nom peut être utilisé pour accéder à la ressource. ficelle
Propriétés Propriétés de la table de routage du hub virtuel v2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nom Descriptif Valeur
attachedConnections Liste de toutes les connexions rattachées à cette table de routage v2. chaîne de caractères[]
routes Liste de tous les itinéraires. VirtualHubRouteV2[]

VirtualHubRouteV2

Nom Descriptif Valeur
destinations Liste de toutes les destinations. chaîne de caractères[]
destinationType Le type de destinations. ficelle
suivantHoublon Adresse IP NextHops. chaîne de caractères[]
nextHopType Le type de sauts suivants. ficelle

VirtualRouterAutoScaleConfiguration

Nom Descriptif Valeur
minCapacité Nombre minimal d’unités d’échelle pour VirtualHub Router. int

Constraints:
Valeur minimale = 0

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Hub virtuel Module de ressources AVM pour Virtual Hub

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
créer un serveur de routage dans un nouveau sous-réseau Ce modèle déploie un serveur de routage dans un sous-réseau nommé RouteServerSubnet.
Crée des ressources Virtual WAN Ce modèle vous permet de créer des ressources WAN virtuelles, notamment Virtual WAN, Virtual Hub, VPN Gateway, VPN Site et VPN Connecton.
hubs virtuels sécurisés Ce modèle crée un hub virtuel sécurisé à l’aide du Pare-feu Azure pour sécuriser votre trafic réseau cloud destiné à Internet.

Définition de ressource de modèle ARM

Le type de ressource virtualHubs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/virtualHubs, ajoutez le fichier JSON suivant à votre modèle.

{
  "type": "Microsoft.Network/virtualHubs",
  "apiVersion": "2025-01-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"
  }
}

Valeurs de propriété

Microsoft.Network/virtualHubs

Nom Descriptif Valeur
apiVersion Version de l’API '2025-01-01'
location Emplacement des ressources. ficelle
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du hub virtuel. VirtualHubPropriétés
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource « Microsoft.Network/virtualHubs »

ResourceTags

Nom Descriptif Valeur

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle

VirtualHubPropriétés

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse pour ce VirtualHub. ficelle
allowBranchToBranchTraffic Indicateur pour contrôler le transit pour le hub VirtualRouter. bool
azureFirewall L’azureFirewall associé à ce VirtualHub. Sous-ressource
expressRouteGateway expressRouteGateway associé à ce VirtualHub. Sous-ressource
hubRoutingPreference Le hubRoutingPreference de ce VirtualHub. 'ASPath'
'ExpressRoute'
'Passerelle VPN'
p2SVpnGateway Le P2SVpnGateway associé à ce VirtualHub. Sous-ressource
preferredRoutingGateway La passerelle préférée pour acheminer le trafic sur site 'ExpressRoute'
'None'
'Passerelle VPN'
routeTable Route Table associée à ce hub virtuel. VirtualHubRouteTable
securityPartnerProvider Le securityPartnerProvider associé à ce VirtualHub. Sous-ressource
securityProviderName Nom du fournisseur de sécurité. ficelle
sku Le sku de ce VirtualHub. ficelle
virtualHubRouteTableV2s Liste de toutes les tables de routage v2 du hub virtuel associées à ce VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn ASN VirtualRouter. int

Constraints:
Valeur minimale = 0
Valeur maximale = 4294967295
virtualRouterAutoScaleConfiguration Configuration de la mise à l’échelle automatique du routeur VirtualHub. VirtualRouterAutoScaleConfiguration
virtualRouterIps IP du routeur virtuel. chaîne de caractères[]
virtuelWan Le VirtualWAN auquel appartient le VirtualHub. Sous-ressource
vpnPasserelle Le VpnGateway associé à ce VirtualHub. Sous-ressource

VirtualHubRoute (en anglais)

Nom Descriptif Valeur
adressePréfixes Liste de tous les addressPrefixes. chaîne de caractères[]
suivantHopIpAddress Adresse IP NextHop. ficelle

VirtualHubRouteTable

Nom Descriptif Valeur
routes Liste de tous les itinéraires. VirtualHubRoute[]

VirtualHubRouteTableV2

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle
nom Nom de la ressource unique au sein d’un groupe de ressources. Ce nom peut être utilisé pour accéder à la ressource. ficelle
Propriétés Propriétés de la table de routage du hub virtuel v2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nom Descriptif Valeur
attachedConnections Liste de toutes les connexions rattachées à cette table de routage v2. chaîne de caractères[]
routes Liste de tous les itinéraires. VirtualHubRouteV2[]

VirtualHubRouteV2

Nom Descriptif Valeur
destinations Liste de toutes les destinations. chaîne de caractères[]
destinationType Le type de destinations. ficelle
suivantHoublon Adresse IP NextHops. chaîne de caractères[]
nextHopType Le type de sauts suivants. ficelle

VirtualRouterAutoScaleConfiguration

Nom Descriptif Valeur
minCapacité Nombre minimal d’unités d’échelle pour VirtualHub Router. int

Constraints:
Valeur minimale = 0

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Template Descriptif
Serveur de routage Azure dans le peering BGP avec Quagga

Déployer sur Azure
Ce modèle déploie un serveur routeur et une machine virtuelle Ubuntu avec Quagga. Deux sessions BGP externes sont établies entre le serveur routeur et Quagga. L’installation et la configuration de Quagga sont exécutées par l’extension de script personnalisé Azure pour Linux
déploiement multi-hub Azure Virtual WAN (vWAN)

Déployer sur Azure
Ce modèle vous permet de créer un déploiement multi-hub Azure Virtual WAN (vWAN), y compris toutes les passerelles et connexions de réseau virtuel.
déploiement multi-hub Azure vWAN avec des tables de routage personnalisées

Déployer sur Azure
Ce modèle vous permet de créer un déploiement multi-hub Azure Virtual WAN (vWAN), y compris toutes les passerelles et connexions de réseau virtuel, et d’illustrer l’utilisation des tables de routage pour le routage personnalisé.
créer un serveur de routage dans un nouveau sous-réseau

Déployer sur Azure
Ce modèle déploie un serveur de routage dans un sous-réseau nommé RouteServerSubnet.
Crée des ressources Virtual WAN

Déployer sur Azure
Ce modèle vous permet de créer des ressources WAN virtuelles, notamment Virtual WAN, Virtual Hub, VPN Gateway, VPN Site et VPN Connecton.
hubs virtuels sécurisés

Déployer sur Azure
Ce modèle crée un hub virtuel sécurisé à l’aide du Pare-feu Azure pour sécuriser votre trafic réseau cloud destiné à Internet.
déploiement vWAN P2S avec un pool d’adresses multiples et des groupes d’utilisateurs

Déployer sur Azure
Ce modèle déploie Azure Virtual WAN (vWAN) avec un P2S configuré avec plusieurs groupes d’adresses et groupes d’utilisateurs

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource virtualHubs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/virtualHubs, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualHubs@2025-01-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"
      }
    }
  }
}

Valeurs de propriété

Microsoft.Network/virtualHubs

Nom Descriptif Valeur
location Emplacement des ressources. ficelle
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du hub virtuel. VirtualHubPropriétés
tags Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Network/virtualHubs@2025-01-01 »

ResourceTags

Nom Descriptif Valeur

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle

VirtualHubPropriétés

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse pour ce VirtualHub. ficelle
allowBranchToBranchTraffic Indicateur pour contrôler le transit pour le hub VirtualRouter. bool
azureFirewall L’azureFirewall associé à ce VirtualHub. Sous-ressource
expressRouteGateway expressRouteGateway associé à ce VirtualHub. Sous-ressource
hubRoutingPreference Le hubRoutingPreference de ce VirtualHub. 'ASPath'
'ExpressRoute'
'Passerelle VPN'
p2SVpnGateway Le P2SVpnGateway associé à ce VirtualHub. Sous-ressource
preferredRoutingGateway La passerelle préférée pour acheminer le trafic sur site 'ExpressRoute'
'None'
'Passerelle VPN'
routeTable Route Table associée à ce hub virtuel. VirtualHubRouteTable
securityPartnerProvider Le securityPartnerProvider associé à ce VirtualHub. Sous-ressource
securityProviderName Nom du fournisseur de sécurité. ficelle
sku Le sku de ce VirtualHub. ficelle
virtualHubRouteTableV2s Liste de toutes les tables de routage v2 du hub virtuel associées à ce VirtualHub. VirtualHubRouteTableV2[]
virtualRouterAsn ASN VirtualRouter. int

Constraints:
Valeur minimale = 0
Valeur maximale = 4294967295
virtualRouterAutoScaleConfiguration Configuration de la mise à l’échelle automatique du routeur VirtualHub. VirtualRouterAutoScaleConfiguration
virtualRouterIps IP du routeur virtuel. chaîne de caractères[]
virtuelWan Le VirtualWAN auquel appartient le VirtualHub. Sous-ressource
vpnPasserelle Le VpnGateway associé à ce VirtualHub. Sous-ressource

VirtualHubRoute (en anglais)

Nom Descriptif Valeur
adressePréfixes Liste de tous les addressPrefixes. chaîne de caractères[]
suivantHopIpAddress Adresse IP NextHop. ficelle

VirtualHubRouteTable

Nom Descriptif Valeur
routes Liste de tous les itinéraires. VirtualHubRoute[]

VirtualHubRouteTableV2

Nom Descriptif Valeur
pièce d'identité ID de ressource. ficelle
nom Nom de la ressource unique au sein d’un groupe de ressources. Ce nom peut être utilisé pour accéder à la ressource. ficelle
Propriétés Propriétés de la table de routage du hub virtuel v2. VirtualHubRouteTableV2Properties

VirtualHubRouteTableV2Properties

Nom Descriptif Valeur
attachedConnections Liste de toutes les connexions rattachées à cette table de routage v2. chaîne de caractères[]
routes Liste de tous les itinéraires. VirtualHubRouteV2[]

VirtualHubRouteV2

Nom Descriptif Valeur
destinations Liste de toutes les destinations. chaîne de caractères[]
destinationType Le type de destinations. ficelle
suivantHoublon Adresse IP NextHops. chaîne de caractères[]
nextHopType Le type de sauts suivants. ficelle

VirtualRouterAutoScaleConfiguration

Nom Descriptif Valeur
minCapacité Nombre minimal d’unités d’échelle pour VirtualHub Router. int

Constraints:
Valeur minimale = 0

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement d’un hub virtuel au sein d’un WAN virtuel.

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