Partager via


Microsoft.Network virtualNetworks/virtualNetworkPeerings

Définition de ressource Bicep

Le type de ressource virtualNetworks/virtualNetworkPeerings 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/virtualNetworks/virtualNetworkPeerings, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01' = {
  name: 'string'
  properties: {
    allowForwardedTraffic: bool
    allowGatewayTransit: bool
    allowVirtualNetworkAccess: bool
    doNotVerifyRemoteGateways: bool
    enableOnlyIPv6Peering: bool
    localAddressSpace: {
      addressPrefixes: [
        'string'
      ]
    }
    localSubnetNames: [
      'string'
    ]
    localVirtualNetworkAddressSpace: {
      addressPrefixes: [
        'string'
      ]
    }
    peerCompleteVnets: bool
    peeringState: 'string'
    peeringSyncLevel: 'string'
    remoteAddressSpace: {
      addressPrefixes: [
        'string'
      ]
    }
    remoteBgpCommunities: {
      virtualNetworkCommunity: 'string'
    }
    remoteSubnetNames: [
      'string'
    ]
    remoteVirtualNetwork: {
      id: 'string'
    }
    remoteVirtualNetworkAddressSpace: {
      addressPrefixes: [
        'string'
      ]
    }
    useRemoteGateways: bool
  }
}

Valeurs de propriété

AddressSpace

Nom Description Valeur
addressPrefixes Liste des blocs d’adresses réservés à ce réseau virtuel en notation CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : virtualNetworks
Propriétés Propriétés du peering de réseaux virtuels. VirtualNetworkPeeringPropertiesFormat

Sous-ressource

Nom Description Valeur
id ID de ressource. corde

VirtualNetworkBgpCommunities

Nom Description Valeur
virtualNetworkCommunity Communauté BGP associée au réseau virtuel. chaîne (obligatoire)

VirtualNetworkPeeringPropertiesFormat

Nom Description Valeur
allowForwardedTraffic Si le trafic transféré à partir des machines virtuelles du réseau virtuel local sera autorisé/interdit dans le réseau virtuel distant. Bool
allowGatewayTransit Si des liens de passerelle peuvent être utilisés dans le réseau virtuel distant pour établir un lien vers ce réseau virtuel. Bool
allowVirtualNetworkAccess Indique si les machines virtuelles de l’espace réseau virtuel local peuvent accéder aux machines virtuelles dans l’espace réseau virtuel distant. Bool
doNotVerifyRemoteGateways Si nous devons vérifier l’état d’approvisionnement de la passerelle distante. Bool
enableOnlyIPv6Peering Indique si seul l’espace d’adressage Ipv6 est appairé pour le peering de sous-réseaux. Bool
localAddressSpace Espace d’adressage local du réseau virtuel local appairé. AddressSpace
localSubnetNames Liste des noms de sous-réseaux locaux appairés avec un réseau virtuel distant. string[]
localVirtualNetworkAddressSpace Espace d’adressage local actuel du réseau virtuel local appairé. AddressSpace
peerCompleteVnets Indique si l’espace d’adressage de réseau virtuel complet est appairé. Bool
peeringState État du peering de réseau virtuel. 'Connecté'
'Déconnecté'
'Initié'
peeringSyncLevel État de synchronisation du peering du peering de réseaux virtuels. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Référence à l’espace d’adressage appairé au réseau virtuel distant. AddressSpace
remoteBgpCommunities Référence aux communautés Bgp du réseau virtuel distant. VirtualNetworkBgpCommunities
remoteSubnetNames Liste des noms de sous-réseaux distants à partir d’un réseau virtuel distant appairé. string[]
remoteVirtualNetwork Référence au réseau virtuel distant. Le réseau virtuel distant peut se trouver dans la même région ou dans une autre région (préversion). Consultez cet article pour vous inscrire à la préversion et en savoir plus (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Référence à l’espace d’adressage actuel du réseau virtuel distant. AddressSpace
useRemoteGateways Si des passerelles distantes peuvent être utilisées sur ce réseau virtuel. Si l’indicateur est défini sur true et que allowGatewayTransit sur le peering distant est également vrai, le réseau virtuel utilise des passerelles de réseau virtuel distant pour le transit. Un seul peering peut avoir cet indicateur défini sur true. Cet indicateur ne peut pas être défini si le réseau virtuel dispose déjà d’une passerelle. Bool

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
machine virtuelle développeur de jeux Azure La machine virtuelle développeur de jeux Azure inclut des moteurs licencsed comme Unreal.
Créer une connexion de réseau virtuel à réseau virtuel à l’aide d’un de peering de réseaux virtuels Ce modèle vous permet de connecter deux réseaux virtuels à l’aide du peering de réseaux virtuels
Déployer un hôte Bastion dans un de réseau virtuel hub Ce modèle crée deux réseaux virtuels avec des peerings, un hôte Bastion dans le réseau virtuel Hub et une machine virtuelle Linux dans le réseau virtuel spoke
Homologuer deux réseaux virtuels existants au sein d’une seule région Ce modèle vous permet de connecter deux réseaux virtuels à partir des groupes de ressources identiques ou différents dans la même région à l’aide du peering de réseaux virtuels
équilibreur de charge public chaîné à un équilibreur de charge de passerelle Ce modèle vous permet de déployer un équilibreur de charge standard public chaîné sur un équilibreur de charge de passerelle. Le trafic entrant à partir d’Internet est acheminé vers l’équilibreur de charge de passerelle avec des machines virtuelles Linux (NVA) dans le pool principal.
utiliser le Pare-feu Azure comme proxy DNS dans une topologie Hub & Spoke Cet exemple montre comment déployer une topologie hub-spoke dans Azure à l’aide du Pare-feu Azure. Le réseau virtuel hub agit comme un point central de connectivité à de nombreux réseaux virtuels spoke connectés au réseau virtuel hub via le peering de réseaux virtuels.

Définition de ressource de modèle ARM

Le type de ressource virtualNetworks/virtualNetworkPeerings 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/virtualNetworks/virtualNetworkPeerings, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Network/virtualNetworks/virtualNetworkPeerings",
  "apiVersion": "2024-03-01",
  "name": "string",
  "properties": {
    "allowForwardedTraffic": "bool",
    "allowGatewayTransit": "bool",
    "allowVirtualNetworkAccess": "bool",
    "doNotVerifyRemoteGateways": "bool",
    "enableOnlyIPv6Peering": "bool",
    "localAddressSpace": {
      "addressPrefixes": [ "string" ]
    },
    "localSubnetNames": [ "string" ],
    "localVirtualNetworkAddressSpace": {
      "addressPrefixes": [ "string" ]
    },
    "peerCompleteVnets": "bool",
    "peeringState": "string",
    "peeringSyncLevel": "string",
    "remoteAddressSpace": {
      "addressPrefixes": [ "string" ]
    },
    "remoteBgpCommunities": {
      "virtualNetworkCommunity": "string"
    },
    "remoteSubnetNames": [ "string" ],
    "remoteVirtualNetwork": {
      "id": "string"
    },
    "remoteVirtualNetworkAddressSpace": {
      "addressPrefixes": [ "string" ]
    },
    "useRemoteGateways": "bool"
  }
}

Valeurs de propriété

AddressSpace

Nom Description Valeur
addressPrefixes Liste des blocs d’adresses réservés à ce réseau virtuel en notation CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nom Description Valeur
apiVersion Version de l’API '2024-03-01'
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du peering de réseaux virtuels. VirtualNetworkPeeringPropertiesFormat
type Type de ressource 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'

Sous-ressource

Nom Description Valeur
id ID de ressource. corde

VirtualNetworkBgpCommunities

Nom Description Valeur
virtualNetworkCommunity Communauté BGP associée au réseau virtuel. chaîne (obligatoire)

VirtualNetworkPeeringPropertiesFormat

Nom Description Valeur
allowForwardedTraffic Si le trafic transféré à partir des machines virtuelles du réseau virtuel local sera autorisé/interdit dans le réseau virtuel distant. Bool
allowGatewayTransit Si des liens de passerelle peuvent être utilisés dans le réseau virtuel distant pour établir un lien vers ce réseau virtuel. Bool
allowVirtualNetworkAccess Indique si les machines virtuelles de l’espace réseau virtuel local peuvent accéder aux machines virtuelles dans l’espace réseau virtuel distant. Bool
doNotVerifyRemoteGateways Si nous devons vérifier l’état d’approvisionnement de la passerelle distante. Bool
enableOnlyIPv6Peering Indique si seul l’espace d’adressage Ipv6 est appairé pour le peering de sous-réseaux. Bool
localAddressSpace Espace d’adressage local du réseau virtuel local appairé. AddressSpace
localSubnetNames Liste des noms de sous-réseaux locaux appairés avec un réseau virtuel distant. string[]
localVirtualNetworkAddressSpace Espace d’adressage local actuel du réseau virtuel local appairé. AddressSpace
peerCompleteVnets Indique si l’espace d’adressage de réseau virtuel complet est appairé. Bool
peeringState État du peering de réseau virtuel. 'Connecté'
'Déconnecté'
'Initié'
peeringSyncLevel État de synchronisation du peering du peering de réseaux virtuels. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Référence à l’espace d’adressage appairé au réseau virtuel distant. AddressSpace
remoteBgpCommunities Référence aux communautés Bgp du réseau virtuel distant. VirtualNetworkBgpCommunities
remoteSubnetNames Liste des noms de sous-réseaux distants à partir d’un réseau virtuel distant appairé. string[]
remoteVirtualNetwork Référence au réseau virtuel distant. Le réseau virtuel distant peut se trouver dans la même région ou dans une autre région (préversion). Consultez cet article pour vous inscrire à la préversion et en savoir plus (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Référence à l’espace d’adressage actuel du réseau virtuel distant. AddressSpace
useRemoteGateways Si des passerelles distantes peuvent être utilisées sur ce réseau virtuel. Si l’indicateur est défini sur true et que allowGatewayTransit sur le peering distant est également vrai, le réseau virtuel utilise des passerelles de réseau virtuel distant pour le transit. Un seul peering peut avoir cet indicateur défini sur true. Cet indicateur ne peut pas être défini si le réseau virtuel dispose déjà d’une passerelle. Bool

Modèles de démarrage rapide

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

Modèle Description
machine virtuelle développeur de jeux Azure

Déployer sur Azure
La machine virtuelle développeur de jeux Azure inclut des moteurs licencsed comme Unreal.
Créer une connexion de réseau virtuel à réseau virtuel à l’aide d’un de peering de réseaux virtuels

Déployer sur Azure
Ce modèle vous permet de connecter deux réseaux virtuels à l’aide du peering de réseaux virtuels
Créer un bac à sable pare-feu Azure avec de tunneling forcé

Déployer sur Azure
Ce modèle crée un bac à sable pare-feu Azure (Linux) avec une force de pare-feu tunnelnée via un autre pare-feu dans un réseau virtuel appairé
Déployer un hôte Bastion dans un de réseau virtuel hub

Déployer sur Azure
Ce modèle crée deux réseaux virtuels avec des peerings, un hôte Bastion dans le réseau virtuel Hub et une machine virtuelle Linux dans le réseau virtuel spoke
Déployer un bac à sable de topologie hub-and-spoke

Déployer sur Azure
Ce modèle crée une configuration de topologie hub-and-spoke de base. Il crée un réseau virtuel Hub avec des sous-réseaux DMZ, Management, Shared and Gateway (éventuellement), avec deux réseaux virtuels Spoke (développement et production) contenant chacun un sous-réseau de charge de travail. Il déploie également une Jump-Host Windows sur le sous-réseau de gestion du hub et établit des peerings de réseaux virtuels entre le hub et les deux spokes.
Déployer la réplication HBase avec deux réseaux virtuels dans une région

Déployer sur Azure
Ce modèle vous permet de configurer un environnement HBaseN avec deux clusters HBase au sein de deux réseaux virtuels dans la même région pour la configuration de la réplication HBase.
Homologuer deux réseaux virtuels existants au sein d’une seule région

Déployer sur Azure
Ce modèle vous permet de connecter deux réseaux virtuels à partir des groupes de ressources identiques ou différents dans la même région à l’aide du peering de réseaux virtuels
équilibreur de charge public chaîné à un équilibreur de charge de passerelle

Déployer sur Azure
Ce modèle vous permet de déployer un équilibreur de charge standard public chaîné sur un équilibreur de charge de passerelle. Le trafic entrant à partir d’Internet est acheminé vers l’équilibreur de charge de passerelle avec des machines virtuelles Linux (NVA) dans le pool principal.
utiliser le Pare-feu Azure comme proxy DNS dans une topologie Hub & Spoke

Déployer sur Azure
Cet exemple montre comment déployer une topologie hub-spoke dans Azure à l’aide du Pare-feu Azure. Le réseau virtuel hub agit comme un point central de connectivité à de nombreux réseaux virtuels spoke connectés au réseau virtuel hub via le peering de réseaux virtuels.

Définition de ressource Terraform (fournisseur AzAPI)

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

  • groupes de ressources

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/virtualNetworks/virtualNetworkPeerings, ajoutez la terraform suivante à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01"
  name = "string"
  body = jsonencode({
    properties = {
      allowForwardedTraffic = bool
      allowGatewayTransit = bool
      allowVirtualNetworkAccess = bool
      doNotVerifyRemoteGateways = bool
      enableOnlyIPv6Peering = bool
      localAddressSpace = {
        addressPrefixes = [
          "string"
        ]
      }
      localSubnetNames = [
        "string"
      ]
      localVirtualNetworkAddressSpace = {
        addressPrefixes = [
          "string"
        ]
      }
      peerCompleteVnets = bool
      peeringState = "string"
      peeringSyncLevel = "string"
      remoteAddressSpace = {
        addressPrefixes = [
          "string"
        ]
      }
      remoteBgpCommunities = {
        virtualNetworkCommunity = "string"
      }
      remoteSubnetNames = [
        "string"
      ]
      remoteVirtualNetwork = {
        id = "string"
      }
      remoteVirtualNetworkAddressSpace = {
        addressPrefixes = [
          "string"
        ]
      }
      useRemoteGateways = bool
    }
  })
}

Valeurs de propriété

AddressSpace

Nom Description Valeur
addressPrefixes Liste des blocs d’adresses réservés à ce réseau virtuel en notation CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : virtualNetworks
Propriétés Propriétés du peering de réseaux virtuels. VirtualNetworkPeeringPropertiesFormat
type Type de ressource « Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01 »

Sous-ressource

Nom Description Valeur
id ID de ressource. corde

VirtualNetworkBgpCommunities

Nom Description Valeur
virtualNetworkCommunity Communauté BGP associée au réseau virtuel. chaîne (obligatoire)

VirtualNetworkPeeringPropertiesFormat

Nom Description Valeur
allowForwardedTraffic Si le trafic transféré à partir des machines virtuelles du réseau virtuel local sera autorisé/interdit dans le réseau virtuel distant. Bool
allowGatewayTransit Si des liens de passerelle peuvent être utilisés dans le réseau virtuel distant pour établir un lien vers ce réseau virtuel. Bool
allowVirtualNetworkAccess Indique si les machines virtuelles de l’espace réseau virtuel local peuvent accéder aux machines virtuelles dans l’espace réseau virtuel distant. Bool
doNotVerifyRemoteGateways Si nous devons vérifier l’état d’approvisionnement de la passerelle distante. Bool
enableOnlyIPv6Peering Indique si seul l’espace d’adressage Ipv6 est appairé pour le peering de sous-réseaux. Bool
localAddressSpace Espace d’adressage local du réseau virtuel local appairé. AddressSpace
localSubnetNames Liste des noms de sous-réseaux locaux appairés avec un réseau virtuel distant. string[]
localVirtualNetworkAddressSpace Espace d’adressage local actuel du réseau virtuel local appairé. AddressSpace
peerCompleteVnets Indique si l’espace d’adressage de réseau virtuel complet est appairé. Bool
peeringState État du peering de réseau virtuel. 'Connecté'
'Déconnecté'
'Initié'
peeringSyncLevel État de synchronisation du peering du peering de réseaux virtuels. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Référence à l’espace d’adressage appairé au réseau virtuel distant. AddressSpace
remoteBgpCommunities Référence aux communautés Bgp du réseau virtuel distant. VirtualNetworkBgpCommunities
remoteSubnetNames Liste des noms de sous-réseaux distants à partir d’un réseau virtuel distant appairé. string[]
remoteVirtualNetwork Référence au réseau virtuel distant. Le réseau virtuel distant peut se trouver dans la même région ou dans une autre région (préversion). Consultez cet article pour vous inscrire à la préversion et en savoir plus (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Référence à l’espace d’adressage actuel du réseau virtuel distant. AddressSpace
useRemoteGateways Si des passerelles distantes peuvent être utilisées sur ce réseau virtuel. Si l’indicateur est défini sur true et que allowGatewayTransit sur le peering distant est également vrai, le réseau virtuel utilise des passerelles de réseau virtuel distant pour le transit. Un seul peering peut avoir cet indicateur défini sur true. Cet indicateur ne peut pas être défini si le réseau virtuel dispose déjà d’une passerelle. Bool