Microsoft.Network virtualNetworks/virtualNetworkPeerings

Scegliere una lingua di distribuzione

Definizione di risorsa Bicep

Il tipo di risorsa virtualNetworks/virtualNetworkPeerings può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworks/virtualNetworkPeerings, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

AddressSpace

Nome Descrizione Valore
addressPrefixes Elenco di blocchi di indirizzi riservati per questa rete virtuale nella notazione CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrizione Valore
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: virtualNetworks
proprietà Proprietà del peering di rete virtuale. VirtualNetworkPeeringPropertiesFormat

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

VirtualNetworkBgpCommunities

Nome Descrizione Valore
virtualNetworkCommunity Community BGP associata alla rete virtuale. stringa (obbligatorio)

VirtualNetworkPeeringPropertiesFormat

Nome Descrizione Valore
allowForwardedTraffic Indica se il traffico inoltrato dalle macchine virtuali nella rete virtuale locale sarà consentito/non consentito nella rete virtuale remota. Bool
allowGatewayTransit Se i collegamenti gateway possono essere usati nella rete virtuale remota per collegarsi a questa rete virtuale. Bool
allowVirtualNetworkAccess Indica se le macchine virtuali nello spazio di rete virtuale locale sarebbero in grado di accedere alle macchine virtuali nello spazio di rete virtuale remoto. Bool
doNotVerifyRemoteGateways Se è necessario verificare lo stato di provisioning del gateway remoto. Bool
enableOnlyIPv6Peering Indica se è stato eseguito il peering solo dello spazio indirizzi Ipv6 per il peering di subnet. Bool
localAddressSpace Spazio indirizzi locale della rete virtuale locale con peering. AddressSpace
localSubnetNames Elenco di nomi di subnet locali con peering con rete virtuale remota. string[]
localVirtualNetworkAddressSpace Spazio indirizzi locale corrente della rete virtuale locale con peering. AddressSpace
peerCompleteVnets Indica se lo spazio di indirizzi della rete virtuale completo è con peering. Bool
peeringState Stato del peering di rete virtuale. 'Connesso'
'Disconnesso'
'Avviato'
peeringSyncLevel Stato di sincronizzazione del peering del peering di rete virtuale. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Riferimento allo spazio indirizzi con peering con la rete virtuale remota. AddressSpace
remoteBgpCommunities Riferimento alle community Bgp della rete virtuale remota. VirtualNetworkBgpCommunities
remoteSubnetNames Elenco di nomi di subnet remote da una rete virtuale remota con peering. string[]
remoteVirtualNetwork Riferimento alla rete virtuale remota. La rete virtuale remota può trovarsi nella stessa area o in un'area diversa (anteprima). Vedere qui per registrarsi per l'anteprima e altre informazioni (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Riferimento allo spazio indirizzi corrente della rete virtuale remota. AddressSpace
useRemoteGateways Se i gateway remoti possono essere usati in questa rete virtuale. Se il flag è impostato su true e allowGatewayTransit nel peering remoto è true, anche la rete virtuale userà i gateway della rete virtuale remota per il transito. Solo un peering può avere questo flag impostato su true. Questo flag non può essere impostato se la rete virtuale dispone già di un gateway. Bool

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
macchina virtuale per sviluppatori di giochi di Azure La macchina virtuale per sviluppatori di giochi di Azure include motori con licenza come Unreal.
Creare una connessione da rete virtuale a rete virtuale usando il peering reti virtuali Questo modello consente di connettere due reti virtuali usando il peering reti virtuali
Distribuire un host Bastion in una rete virtuale hub Questo modello crea due reti virtuali con peering, un host Bastion nella rete virtuale hub e una macchina virtuale Linux nella rete virtuale spoke
eseguire il peering di due reti virtuali esistenti all'interno di una singola area Questo modello consente di connettere due reti virtuali dagli stessi gruppi di risorse o da gruppi di risorse diversi nella stessa area usando il peering reti virtuali
servizio di bilanciamento del carico pubblico concatenato a un servizio di bilanciamento del carico del gateway Questo modello consente di distribuire un'istanza di Load Balancer Standard pubblica concatenato a un servizio di bilanciamento del carico del gateway. Il traffico in ingresso da Internet viene instradato al servizio di bilanciamento del carico del gateway con macchine virtuali Linux nel pool back-end.
Usare Firewall di Azure come proxy DNS in una topologia hub & spoke Questo esempio illustra come distribuire una topologia hub-spoke in Azure usando Firewall di Azure. La rete virtuale hub funge da punto centrale di connettività a molte reti virtuali spoke connesse alla rete virtuale hub tramite peering di rete virtuale.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa virtualNetworks/virtualNetworkPeerings può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworks/virtualNetworkPeerings, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

AddressSpace

Nome Descrizione Valore
addressPrefixes Elenco di blocchi di indirizzi riservati per questa rete virtuale nella notazione CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrizione Valore
apiVersion Versione dell'API '2024-03-01'
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del peering di rete virtuale. VirtualNetworkPeeringPropertiesFormat
digitare Tipo di risorsa 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

VirtualNetworkBgpCommunities

Nome Descrizione Valore
virtualNetworkCommunity Community BGP associata alla rete virtuale. stringa (obbligatorio)

VirtualNetworkPeeringPropertiesFormat

Nome Descrizione Valore
allowForwardedTraffic Indica se il traffico inoltrato dalle macchine virtuali nella rete virtuale locale sarà consentito/non consentito nella rete virtuale remota. Bool
allowGatewayTransit Se i collegamenti gateway possono essere usati nella rete virtuale remota per collegarsi a questa rete virtuale. Bool
allowVirtualNetworkAccess Indica se le macchine virtuali nello spazio di rete virtuale locale sarebbero in grado di accedere alle macchine virtuali nello spazio di rete virtuale remoto. Bool
doNotVerifyRemoteGateways Se è necessario verificare lo stato di provisioning del gateway remoto. Bool
enableOnlyIPv6Peering Indica se è stato eseguito il peering solo dello spazio indirizzi Ipv6 per il peering di subnet. Bool
localAddressSpace Spazio indirizzi locale della rete virtuale locale con peering. AddressSpace
localSubnetNames Elenco di nomi di subnet locali con peering con rete virtuale remota. string[]
localVirtualNetworkAddressSpace Spazio indirizzi locale corrente della rete virtuale locale con peering. AddressSpace
peerCompleteVnets Indica se lo spazio di indirizzi della rete virtuale completo è con peering. Bool
peeringState Stato del peering di rete virtuale. 'Connesso'
'Disconnesso'
'Avviato'
peeringSyncLevel Stato di sincronizzazione del peering del peering di rete virtuale. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Riferimento allo spazio indirizzi con peering con la rete virtuale remota. AddressSpace
remoteBgpCommunities Riferimento alle community Bgp della rete virtuale remota. VirtualNetworkBgpCommunities
remoteSubnetNames Elenco di nomi di subnet remote da una rete virtuale remota con peering. string[]
remoteVirtualNetwork Riferimento alla rete virtuale remota. La rete virtuale remota può trovarsi nella stessa area o in un'area diversa (anteprima). Vedere qui per registrarsi per l'anteprima e altre informazioni (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Riferimento allo spazio indirizzi corrente della rete virtuale remota. AddressSpace
useRemoteGateways Se i gateway remoti possono essere usati in questa rete virtuale. Se il flag è impostato su true e allowGatewayTransit nel peering remoto è true, anche la rete virtuale userà i gateway della rete virtuale remota per il transito. Solo un peering può avere questo flag impostato su true. Questo flag non può essere impostato se la rete virtuale dispone già di un gateway. Bool

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
macchina virtuale per sviluppatori di giochi di Azure

Distribuire in Azure
La macchina virtuale per sviluppatori di giochi di Azure include motori con licenza come Unreal.
Creare una connessione da rete virtuale a rete virtuale usando il peering reti virtuali

Distribuire in Azure
Questo modello consente di connettere due reti virtuali usando il peering reti virtuali
Creare una sandbox di Firewall di Azure con di tunneling forzato

Distribuire in Azure
Questo modello crea una sandbox di Firewall di Azure (Linux) con un firewall sottoposto a tunneling attraverso un altro firewall in una rete virtuale con peering
Distribuire un host Bastion in una rete virtuale hub

Distribuire in Azure
Questo modello crea due reti virtuali con peering, un host Bastion nella rete virtuale hub e una macchina virtuale Linux nella rete virtuale spoke
Distribuire una sandbox della topologia Hub e Spoke

Distribuire in Azure
Questo modello crea una configurazione di topologia hub-spoke di base. Crea una rete virtuale hub con subnet dmz, gestione, condivisi e gateway (facoltativamente), con due reti virtuali spoke (sviluppo e produzione) contenenti ognuna una subnet del carico di lavoro. Distribuisce anche un Jump-Host Windows nella subnet di gestione dell'HUB e stabilisce i peering di reti virtuali tra l'hub e i due spoke.
Distribuire la replica HBase con due reti virtuali in un'area

Distribuire in Azure
Questo modello consente di configurare un ambiente HBaseN con due cluster HBase all'interno di due reti virtuali nella stessa area per la configurazione della replica HBase.
eseguire il peering di due reti virtuali esistenti all'interno di una singola area

Distribuire in Azure
Questo modello consente di connettere due reti virtuali dagli stessi gruppi di risorse o da gruppi di risorse diversi nella stessa area usando il peering reti virtuali
servizio di bilanciamento del carico pubblico concatenato a un servizio di bilanciamento del carico del gateway

Distribuire in Azure
Questo modello consente di distribuire un'istanza di Load Balancer Standard pubblica concatenato a un servizio di bilanciamento del carico del gateway. Il traffico in ingresso da Internet viene instradato al servizio di bilanciamento del carico del gateway con macchine virtuali Linux nel pool back-end.
Usare Firewall di Azure come proxy DNS in una topologia hub & spoke

Distribuire in Azure
Questo esempio illustra come distribuire una topologia hub-spoke in Azure usando Firewall di Azure. La rete virtuale hub funge da punto centrale di connettività a molte reti virtuali spoke connesse alla rete virtuale hub tramite peering di rete virtuale.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa virtualNetworks/virtualNetworkPeerings può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworks/virtualNetworkPeerings, aggiungere il codice Terraform seguente al modello.

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

Valori delle proprietà

AddressSpace

Nome Descrizione Valore
addressPrefixes Elenco di blocchi di indirizzi riservati per questa rete virtuale nella notazione CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrizione Valore
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: virtualNetworks
proprietà Proprietà del peering di rete virtuale. VirtualNetworkPeeringPropertiesFormat
digitare Tipo di risorsa "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01"

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

VirtualNetworkBgpCommunities

Nome Descrizione Valore
virtualNetworkCommunity Community BGP associata alla rete virtuale. stringa (obbligatorio)

VirtualNetworkPeeringPropertiesFormat

Nome Descrizione Valore
allowForwardedTraffic Indica se il traffico inoltrato dalle macchine virtuali nella rete virtuale locale sarà consentito/non consentito nella rete virtuale remota. Bool
allowGatewayTransit Se i collegamenti gateway possono essere usati nella rete virtuale remota per collegarsi a questa rete virtuale. Bool
allowVirtualNetworkAccess Indica se le macchine virtuali nello spazio di rete virtuale locale sarebbero in grado di accedere alle macchine virtuali nello spazio di rete virtuale remoto. Bool
doNotVerifyRemoteGateways Se è necessario verificare lo stato di provisioning del gateway remoto. Bool
enableOnlyIPv6Peering Indica se è stato eseguito il peering solo dello spazio indirizzi Ipv6 per il peering di subnet. Bool
localAddressSpace Spazio indirizzi locale della rete virtuale locale con peering. AddressSpace
localSubnetNames Elenco di nomi di subnet locali con peering con rete virtuale remota. string[]
localVirtualNetworkAddressSpace Spazio indirizzi locale corrente della rete virtuale locale con peering. AddressSpace
peerCompleteVnets Indica se lo spazio di indirizzi della rete virtuale completo è con peering. Bool
peeringState Stato del peering di rete virtuale. 'Connesso'
'Disconnesso'
'Avviato'
peeringSyncLevel Stato di sincronizzazione del peering del peering di rete virtuale. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Riferimento allo spazio indirizzi con peering con la rete virtuale remota. AddressSpace
remoteBgpCommunities Riferimento alle community Bgp della rete virtuale remota. VirtualNetworkBgpCommunities
remoteSubnetNames Elenco di nomi di subnet remote da una rete virtuale remota con peering. string[]
remoteVirtualNetwork Riferimento alla rete virtuale remota. La rete virtuale remota può trovarsi nella stessa area o in un'area diversa (anteprima). Vedere qui per registrarsi per l'anteprima e altre informazioni (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Riferimento allo spazio indirizzi corrente della rete virtuale remota. AddressSpace
useRemoteGateways Se i gateway remoti possono essere usati in questa rete virtuale. Se il flag è impostato su true e allowGatewayTransit nel peering remoto è true, anche la rete virtuale userà i gateway della rete virtuale remota per il transito. Solo un peering può avere questo flag impostato su true. Questo flag non può essere impostato se la rete virtuale dispone già di un gateway. Bool