Dela via

Microsoft.Network virtualNetworks/virtualNetworkPeerings 2024-05-01

  • Artikel

Bicep-resursdefinition

Resurstypen virtualNetworks/virtualNetworkPeerings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/virtualNetworks/virtualNetworkPeerings-resurs lägger du till följande Bicep i mallen.

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

Egenskapsvärden

AddressSpace

Namn Beskrivning Värde
addressPrefixes En lista över adressblock som är reserverade för det här virtuella nätverket i CIDR-notation. string[]
ipamPoolPrefixAllocations En lista över IPAM-pooler som allokerar IP-adressprefix. IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

Namn Beskrivning Värde
numberOfIpAddresses Antal IP-adresser som ska allokeras. sträng
pöl IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

Namn Beskrivning Värde
Id Resurs-ID för den associerade Azure IpamPool-resursen. sträng

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Namn Beskrivning Värde
Namn Resursnamnet sträng (krävs)
förälder I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.		 Symboliskt namn för resurs av typen: virtualNetworks
Egenskaper Egenskaper för peering för det virtuella nätverket. VirtualNetworkPeeringPropertiesFormat

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng

VirtualNetworkBgpCommunities

Namn Beskrivning Värde
virtualNetworkCommunity BGP-communityn som är associerad med det virtuella nätverket. sträng (krävs)

VirtualNetworkPeeringPropertiesFormat

Namn Beskrivning Värde
allowForwardedTraffic Om den vidarebefordrade trafiken från de virtuella datorerna i det lokala virtuella nätverket tillåts/tillåts inte i det virtuella fjärrnätverket. Bool
allowGatewayTransit Om gatewaylänkar kan användas i fjärranslutna virtuella nätverk för att länka till det här virtuella nätverket. Bool
allowVirtualNetworkAccess Om de virtuella datorerna i det lokala virtuella nätverksutrymmet skulle kunna komma åt de virtuella datorerna i fjärranslutna virtuella nätverk. Bool
doNotVerifyRemoteGateways Om vi behöver verifiera etableringstillståndet för fjärrgatewayen. Bool
enableOnlyIPv6Peering Om endast Ipv6-adressutrymme är peer-kopplat för undernätspeering. Bool
localAddressSpace Det lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
localSubnetNames Lista över lokala undernätsnamn som är peer-kopplade till det virtuella fjärrnätverket. string[]
localVirtualNetworkAddressSpace Det aktuella lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
peerCompleteVnets Om fullständigt adressutrymme för virtuellt nätverk är peer-kopplat. Bool
peeringState Status för peering för det virtuella nätverket. "Ansluten"
"Frånkopplad"
"Initierad"
peeringSyncLevel Peeringsynkroniseringsstatus för peering för det virtuella nätverket. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Referensen till adressutrymmet som är peerkopplat med det fjärranslutna virtuella nätverket. AddressSpace
remoteBgpCommunities Referensen till det fjärranslutna virtuella nätverkets Bgp Communities. VirtualNetworkBgpCommunities
remoteSubnetNames Lista över fjärrundernätsnamn från fjärranslutna virtuella nätverk som är peer-kopplade undernät. string[]
remoteVirtualNetwork Referensen till det virtuella fjärrnätverket. Det virtuella fjärrnätverket kan finnas i samma eller en annan region (förhandsversion). Se här för att registrera dig för förhandsversionen och läs mer (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referensen till det aktuella adressutrymmet för det fjärranslutna virtuella nätverket. AddressSpace
useRemoteGateways Om fjärrgatewayer kan användas i det här virtuella nätverket. Om flaggan är inställd på true och allowGatewayTransit på fjärrpeering också är sant, använder det virtuella nätverket gatewayer för fjärranslutna virtuella nätverk för överföring. Endast en peering kan ha den här flaggan inställd på true. Det går inte att ange den här flaggan om det virtuella nätverket redan har en gateway. Bool

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil Beskrivning
Azure Game Developer Virtual Machine Azure Game Developer Virtual Machine innehåller Licencsed-motorer som Unreal.
Skapa en vNet-till-vNet-anslutning med vNet-peering Med den här mallen kan du ansluta två virtuella nätverk med vNet-peering
Distribuera en Bastion-värd i ett virtuellt navnätverk Den här mallen skapar två virtuella nätverk med peerings, en Bastion-värd i det virtuella hubbnätverket och en virtuell Linux-dator i det virtuella ekernätverket
Peer två befintliga virtuella nätverk inom en enda region Med den här mallen kan du ansluta två virtuella nätverk från samma eller olika resursgrupper i samma region med VNet-peering
offentlig lastbalanserare som är länkad till en Gateway Load Balancer- Med den här mallen kan du distribuera en offentlig standardlastbalanserare som är länkad till en gatewaylastbalanserare. Trafiken som inkommandes från Internet dirigeras till Gateway Load Balancer med virtuella Linux-datorer (NVA) i serverdelspoolen.
Använda Azure Firewall som EN DNS-proxy i en Topologi för Hub & Spoke Det här exemplet visar hur du distribuerar en hub-spoke-topologi i Azure med hjälp av Azure Firewall. Det virtuella hubbnätverket fungerar som en central anslutningspunkt för många virtuella ekernätverk som är anslutna till det virtuella hubbnätverket via peering för virtuella nätverk.

Resursdefinition för ARM-mall

Resurstypen virtualNetworks/virtualNetworkPeerings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/virtualNetworks/virtualNetworkPeerings-resurs lägger du till följande JSON i mallen.

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

Egenskapsvärden

AddressSpace

Namn Beskrivning Värde
addressPrefixes En lista över adressblock som är reserverade för det här virtuella nätverket i CIDR-notation. string[]
ipamPoolPrefixAllocations En lista över IPAM-pooler som allokerar IP-adressprefix. IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

Namn Beskrivning Värde
numberOfIpAddresses Antal IP-adresser som ska allokeras. sträng
pöl IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

Namn Beskrivning Värde
Id Resurs-ID för den associerade Azure IpamPool-resursen. sträng

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Namn Beskrivning Värde
apiVersion API-versionen '2024-05-01'
Namn Resursnamnet sträng (krävs)
Egenskaper Egenskaper för peering för det virtuella nätverket. VirtualNetworkPeeringPropertiesFormat
typ Resurstypen "Microsoft.Network/virtualNetworks/virtualNetworkPeerings"

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng

VirtualNetworkBgpCommunities

Namn Beskrivning Värde
virtualNetworkCommunity BGP-communityn som är associerad med det virtuella nätverket. sträng (krävs)

VirtualNetworkPeeringPropertiesFormat

Namn Beskrivning Värde
allowForwardedTraffic Om den vidarebefordrade trafiken från de virtuella datorerna i det lokala virtuella nätverket tillåts/tillåts inte i det virtuella fjärrnätverket. Bool
allowGatewayTransit Om gatewaylänkar kan användas i fjärranslutna virtuella nätverk för att länka till det här virtuella nätverket. Bool
allowVirtualNetworkAccess Om de virtuella datorerna i det lokala virtuella nätverksutrymmet skulle kunna komma åt de virtuella datorerna i fjärranslutna virtuella nätverk. Bool
doNotVerifyRemoteGateways Om vi behöver verifiera etableringstillståndet för fjärrgatewayen. Bool
enableOnlyIPv6Peering Om endast Ipv6-adressutrymme är peer-kopplat för undernätspeering. Bool
localAddressSpace Det lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
localSubnetNames Lista över lokala undernätsnamn som är peer-kopplade till det virtuella fjärrnätverket. string[]
localVirtualNetworkAddressSpace Det aktuella lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
peerCompleteVnets Om fullständigt adressutrymme för virtuellt nätverk är peer-kopplat. Bool
peeringState Status för peering för det virtuella nätverket. "Ansluten"
"Frånkopplad"
"Initierad"
peeringSyncLevel Peeringsynkroniseringsstatus för peering för det virtuella nätverket. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Referensen till adressutrymmet som är peerkopplat med det fjärranslutna virtuella nätverket. AddressSpace
remoteBgpCommunities Referensen till det fjärranslutna virtuella nätverkets Bgp Communities. VirtualNetworkBgpCommunities
remoteSubnetNames Lista över fjärrundernätsnamn från fjärranslutna virtuella nätverk som är peer-kopplade undernät. string[]
remoteVirtualNetwork Referensen till det virtuella fjärrnätverket. Det virtuella fjärrnätverket kan finnas i samma eller en annan region (förhandsversion). Se här för att registrera dig för förhandsversionen och läs mer (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referensen till det aktuella adressutrymmet för det fjärranslutna virtuella nätverket. AddressSpace
useRemoteGateways Om fjärrgatewayer kan användas i det här virtuella nätverket. Om flaggan är inställd på true och allowGatewayTransit på fjärrpeering också är sant, använder det virtuella nätverket gatewayer för fjärranslutna virtuella nätverk för överföring. Endast en peering kan ha den här flaggan inställd på true. Det går inte att ange den här flaggan om det virtuella nätverket redan har en gateway. Bool

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Azure Game Developer Virtual Machine

Distribuera till Azure 		Azure Game Developer Virtual Machine innehåller Licencsed-motorer som Unreal.
Skapa en vNet-till-vNet-anslutning med vNet-peering

Distribuera till Azure 		Med den här mallen kan du ansluta två virtuella nätverk med vNet-peering
Skapa en sandbox-miljö i Azure Firewall med tvingad tunneltrafik

Distribuera till Azure 		Den här mallen skapar en Sandbox-miljö i Azure Firewall (Linux) med en brandväggskraft som går via en annan brandvägg i ett peer-kopplat virtuellt nätverk
Distribuera en Bastion-värd i ett virtuellt navnätverk

Distribuera till Azure 		Den här mallen skapar två virtuella nätverk med peerings, en Bastion-värd i det virtuella hubbnätverket och en virtuell Linux-dator i det virtuella ekernätverket
Distribuera en sandbox-topologi för hubb- och ekertopologi

Distribuera till Azure 		Den här mallen skapar en grundläggande topologikonfiguration för nav och eker. Det skapar ett virtuellt hubbnätverk med undernäten DMZ, Management, Shared och Gateway (valfritt), med två virtuella ekernätverk (utveckling och produktion) som innehåller ett arbetsbelastningsundernät vardera. Den distribuerar också en Windows-Jump-Host i undernätet Hantering för hubben och upprättar VNet-peerings mellan hubben och de två ekrarna.
Distribuera HBase-replikering med två virtuella nätverk i en region

Distribuera till Azure 		Med den här mallen kan du konfigurera en HBase-miljö med två HBase-kluster inom två virtuella nätverk i samma region för att konfigurera HBase-replikering.
Peer två befintliga virtuella nätverk inom en enda region

Distribuera till Azure 		Med den här mallen kan du ansluta två virtuella nätverk från samma eller olika resursgrupper i samma region med VNet-peering
offentlig lastbalanserare som är länkad till en Gateway Load Balancer-

Distribuera till Azure 		Med den här mallen kan du distribuera en offentlig standardlastbalanserare som är länkad till en gatewaylastbalanserare. Trafiken som inkommandes från Internet dirigeras till Gateway Load Balancer med virtuella Linux-datorer (NVA) i serverdelspoolen.
Använda Azure Firewall som EN DNS-proxy i en Topologi för Hub & Spoke

Distribuera till Azure 		Det här exemplet visar hur du distribuerar en hub-spoke-topologi i Azure med hjälp av Azure Firewall. Det virtuella hubbnätverket fungerar som en central anslutningspunkt för många virtuella ekernätverk som är anslutna till det virtuella hubbnätverket via peering för virtuella nätverk.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen virtualNetworks/virtualNetworkPeerings kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/virtualNetworks/virtualNetworkPeerings-resurs lägger du till följande Terraform i mallen.

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

Egenskapsvärden

AddressSpace

Namn Beskrivning Värde
addressPrefixes En lista över adressblock som är reserverade för det här virtuella nätverket i CIDR-notation. string[]
ipamPoolPrefixAllocations En lista över IPAM-pooler som allokerar IP-adressprefix. IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

Namn Beskrivning Värde
numberOfIpAddresses Antal IP-adresser som ska allokeras. sträng
pöl IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

Namn Beskrivning Värde
Id Resurs-ID för den associerade Azure IpamPool-resursen. sträng

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Namn Beskrivning Värde
Namn Resursnamnet sträng (krävs)
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: virtualNetworks
Egenskaper Egenskaper för peering för det virtuella nätverket. VirtualNetworkPeeringPropertiesFormat
typ Resurstypen "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-05-01"

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng

VirtualNetworkBgpCommunities

Namn Beskrivning Värde
virtualNetworkCommunity BGP-communityn som är associerad med det virtuella nätverket. sträng (krävs)

VirtualNetworkPeeringPropertiesFormat

Namn Beskrivning Värde
allowForwardedTraffic Om den vidarebefordrade trafiken från de virtuella datorerna i det lokala virtuella nätverket tillåts/tillåts inte i det virtuella fjärrnätverket. Bool
allowGatewayTransit Om gatewaylänkar kan användas i fjärranslutna virtuella nätverk för att länka till det här virtuella nätverket. Bool
allowVirtualNetworkAccess Om de virtuella datorerna i det lokala virtuella nätverksutrymmet skulle kunna komma åt de virtuella datorerna i fjärranslutna virtuella nätverk. Bool
doNotVerifyRemoteGateways Om vi behöver verifiera etableringstillståndet för fjärrgatewayen. Bool
enableOnlyIPv6Peering Om endast Ipv6-adressutrymme är peer-kopplat för undernätspeering. Bool
localAddressSpace Det lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
localSubnetNames Lista över lokala undernätsnamn som är peer-kopplade till det virtuella fjärrnätverket. string[]
localVirtualNetworkAddressSpace Det aktuella lokala adressutrymmet för det lokala virtuella nätverket som är peer-kopplat. AddressSpace
peerCompleteVnets Om fullständigt adressutrymme för virtuellt nätverk är peer-kopplat. Bool
peeringState Status för peering för det virtuella nätverket. "Ansluten"
"Frånkopplad"
"Initierad"
peeringSyncLevel Peeringsynkroniseringsstatus för peering för det virtuella nätverket. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Referensen till adressutrymmet som är peerkopplat med det fjärranslutna virtuella nätverket. AddressSpace
remoteBgpCommunities Referensen till det fjärranslutna virtuella nätverkets Bgp Communities. VirtualNetworkBgpCommunities
remoteSubnetNames Lista över fjärrundernätsnamn från fjärranslutna virtuella nätverk som är peer-kopplade undernät. string[]
remoteVirtualNetwork Referensen till det virtuella fjärrnätverket. Det virtuella fjärrnätverket kan finnas i samma eller en annan region (förhandsversion). Se här för att registrera dig för förhandsversionen och läs mer (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referensen till det aktuella adressutrymmet för det fjärranslutna virtuella nätverket. AddressSpace
useRemoteGateways Om fjärrgatewayer kan användas i det här virtuella nätverket. Om flaggan är inställd på true och allowGatewayTransit på fjärrpeering också är sant, använder det virtuella nätverket gatewayer för fjärranslutna virtuella nätverk för överföring. Endast en peering kan ha den här flaggan inställd på true. Det går inte att ange den här flaggan om det virtuella nätverket redan har en gateway. Bool