Udostępnij za pośrednictwem


Microsoft.Network virtualNetworks/virtualNetworkPeerings 2024-01-01

Definicja zasobu Bicep

Typ zasobu virtualNetworks/virtualNetworkPeerings można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/virtualNetworks/virtualNetworkPeerings, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-01-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
  }
}

Wartości właściwości

Przestrzeń adresowa

Nazwa Opis Wartość
addressPrefixes (prefiksy adresów) Lista bloków adresów zarezerwowanych dla tej sieci wirtualnej w notacji CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: virtualNetworks
Właściwości Właściwości komunikacji równorzędnej sieci wirtualnej. VirtualNetworkPeeringPropertiesFormat

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. struna

VirtualNetworkBgpCommunities

Nazwa Opis Wartość
virtualNetworkCommunity Społeczność protokołu BGP skojarzona z siecią wirtualną. ciąg (wymagany)

VirtualNetworkPeeringPropertiesFormat

Nazwa Opis Wartość
allowForwardedTraffic Czy ruch przekazywany z maszyn wirtualnych w lokalnej sieci wirtualnej będzie dozwolony/niedozwolony w zdalnej sieci wirtualnej. Bool
allowGatewayTransit Jeśli łącza bramy mogą być używane w zdalnej sieci wirtualnej w celu połączenia z tą siecią wirtualną. Bool
allowVirtualNetworkAccess Czy maszyny wirtualne w lokalnej przestrzeni sieci wirtualnej będą mogły uzyskiwać dostęp do maszyn wirtualnych w zdalnej przestrzeni sieci wirtualnej. Bool
doNotVerifyRemoteGateways Jeśli musimy zweryfikować stan aprowizacji bramy zdalnej. Bool
enableOnlyIPv6Peering Czy tylko przestrzeń adresowa Ipv6 jest równorzędna dla komunikacji równorzędnej podsieci. Bool
localAddressSpace Lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
localSubnetNames Lista nazw podsieci lokalnych, które są równorzędne podsieci z zdalną siecią wirtualną. string[]
localVirtualNetworkAddressSpace Bieżąca lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
peerCompleteVnets Czy kompletna przestrzeń adresowa sieci wirtualnej jest równorzędna. Bool
peeringState Stan komunikacji równorzędnej sieci wirtualnej. "Połączono"
"Rozłączono"
"Zainicjowano"
komunikacja równorzędnaSyncLevel Stan synchronizacji komunikacji równorzędnej komunikacji równorzędnej sieci wirtualnej. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Odwołanie do przestrzeni adresowej równorzędnej z zdalną siecią wirtualną. Przestrzeni adresowej
remoteBgpCommunities Odwołanie do społeczności Bgp zdalnej sieci wirtualnej. VirtualNetworkBgpCommunities
remoteSubnetNames Lista nazw zdalnych podsieci z zdalnej sieci wirtualnej, która jest równorzędna podsieci. string[]
remoteVirtualNetwork Odwołanie do zdalnej sieci wirtualnej. Zdalna sieć wirtualna może znajdować się w tym samym lub innym regionie (wersja zapoznawcza). Zobacz tutaj, aby zarejestrować się w celu uzyskania wersji zapoznawczej i dowiedzieć się więcej (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Odwołanie do bieżącej przestrzeni adresowej zdalnej sieci wirtualnej. Przestrzeni adresowej
useRemoteGateways Jeśli bramy zdalne mogą być używane w tej sieci wirtualnej. Jeśli flaga ma wartość true, a właściwość allowGatewayTransit w zdalnej komunikacji równorzędnej ma również wartość true, sieć wirtualna będzie używać bram zdalnej sieci wirtualnej do przesyłania. Tylko jedna komunikacja równorzędna może mieć tę flagę ustawioną na wartość true. Nie można ustawić tej flagi, jeśli sieć wirtualna ma już bramę. Bool

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep Opis
maszyny wirtualnej dewelopera gier platformy Azure Maszyna wirtualna dewelopera gier platformy Azure obejmuje aparaty licencsed, takie jak Unreal.
Tworzenie połączenia między sieciami wirtualnymi przy użyciu komunikacji równorzędnej sieci wirtualnych Ten szablon umożliwia łączenie dwóch sieci wirtualnych przy użyciu komunikacji równorzędnej sieci wirtualnych
wdrażanie hosta bastionu w sieci wirtualnej koncentratora Ten szablon tworzy dwie sieci wirtualne z komunikacją równorzędną, hostem bastionu w sieci wirtualnej piasty i maszyną wirtualną z systemem Linux w sieci wirtualnej będącej szprychą
równorzędne dwie istniejące sieci wirtualne w jednym regionie Ten szablon umożliwia łączenie dwóch sieci wirtualnych z tych samych lub różnych grup zasobów w tym samym regionie przy użyciu komunikacji równorzędnej sieci wirtualnych
publicznego modułu równoważenia obciążenia połączonego z usługą Load Balancer bramy Ten szablon umożliwia wdrożenie modułu równoważenia obciążenia w warstwie Standardowa w warstwie Standardowa połączonego z modułem równoważenia obciążenia bramy. Ruch przychodzący z Internetu jest kierowany do modułu równoważenia obciążenia bramy z maszynami wirtualnymi z systemem Linux (WUS) w puli zaplecza.
użyj usługi Azure Firewall jako serwera proxy DNS w topologii gwiazdy & piasty W tym przykładzie pokazano, jak wdrożyć topologię piasty i szprych na platformie Azure przy użyciu usługi Azure Firewall. Sieć wirtualna piasty działa jako centralny punkt łączności z wieloma sieciami wirtualnymi szprych, które są połączone z siecią wirtualną koncentratora za pośrednictwem komunikacji równorzędnej sieci wirtualnych.

Definicja zasobu szablonu usługi ARM

Typ zasobu virtualNetworks/virtualNetworkPeerings można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/virtualNetworks/virtualNetworkPeerings, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Przestrzeń adresowa

Nazwa Opis Wartość
addressPrefixes (prefiksy adresów) Lista bloków adresów zarezerwowanych dla tej sieci wirtualnej w notacji CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2024-01-01'
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości komunikacji równorzędnej sieci wirtualnej. VirtualNetworkPeeringPropertiesFormat
typ Typ zasobu "Microsoft.Network/virtualNetworks/virtualNetworkPeerings"

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. struna

VirtualNetworkBgpCommunities

Nazwa Opis Wartość
virtualNetworkCommunity Społeczność protokołu BGP skojarzona z siecią wirtualną. ciąg (wymagany)

VirtualNetworkPeeringPropertiesFormat

Nazwa Opis Wartość
allowForwardedTraffic Czy ruch przekazywany z maszyn wirtualnych w lokalnej sieci wirtualnej będzie dozwolony/niedozwolony w zdalnej sieci wirtualnej. Bool
allowGatewayTransit Jeśli łącza bramy mogą być używane w zdalnej sieci wirtualnej w celu połączenia z tą siecią wirtualną. Bool
allowVirtualNetworkAccess Czy maszyny wirtualne w lokalnej przestrzeni sieci wirtualnej będą mogły uzyskiwać dostęp do maszyn wirtualnych w zdalnej przestrzeni sieci wirtualnej. Bool
doNotVerifyRemoteGateways Jeśli musimy zweryfikować stan aprowizacji bramy zdalnej. Bool
enableOnlyIPv6Peering Czy tylko przestrzeń adresowa Ipv6 jest równorzędna dla komunikacji równorzędnej podsieci. Bool
localAddressSpace Lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
localSubnetNames Lista nazw podsieci lokalnych, które są równorzędne podsieci z zdalną siecią wirtualną. string[]
localVirtualNetworkAddressSpace Bieżąca lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
peerCompleteVnets Czy kompletna przestrzeń adresowa sieci wirtualnej jest równorzędna. Bool
peeringState Stan komunikacji równorzędnej sieci wirtualnej. "Połączono"
"Rozłączono"
"Zainicjowano"
komunikacja równorzędnaSyncLevel Stan synchronizacji komunikacji równorzędnej komunikacji równorzędnej sieci wirtualnej. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Odwołanie do przestrzeni adresowej równorzędnej z zdalną siecią wirtualną. Przestrzeni adresowej
remoteBgpCommunities Odwołanie do społeczności Bgp zdalnej sieci wirtualnej. VirtualNetworkBgpCommunities
remoteSubnetNames Lista nazw zdalnych podsieci z zdalnej sieci wirtualnej, która jest równorzędna podsieci. string[]
remoteVirtualNetwork Odwołanie do zdalnej sieci wirtualnej. Zdalna sieć wirtualna może znajdować się w tym samym lub innym regionie (wersja zapoznawcza). Zobacz tutaj, aby zarejestrować się w celu uzyskania wersji zapoznawczej i dowiedzieć się więcej (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Odwołanie do bieżącej przestrzeni adresowej zdalnej sieci wirtualnej. Przestrzeni adresowej
useRemoteGateways Jeśli bramy zdalne mogą być używane w tej sieci wirtualnej. Jeśli flaga ma wartość true, a właściwość allowGatewayTransit w zdalnej komunikacji równorzędnej ma również wartość true, sieć wirtualna będzie używać bram zdalnej sieci wirtualnej do przesyłania. Tylko jedna komunikacja równorzędna może mieć tę flagę ustawioną na wartość true. Nie można ustawić tej flagi, jeśli sieć wirtualna ma już bramę. Bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon Opis
maszyny wirtualnej dewelopera gier platformy Azure

wdrażanie w usłudze Azure
Maszyna wirtualna dewelopera gier platformy Azure obejmuje aparaty licencsed, takie jak Unreal.
Tworzenie połączenia między sieciami wirtualnymi przy użyciu komunikacji równorzędnej sieci wirtualnych

wdrażanie w usłudze Azure
Ten szablon umożliwia łączenie dwóch sieci wirtualnych przy użyciu komunikacji równorzędnej sieci wirtualnych
Tworzenie piaskownicy usługi Azure Firewall z wymuszonym tunelowaniem

wdrażanie w usłudze Azure
Ten szablon tworzy piaskownicę usługi Azure Firewall (Linux) z jedną zaporą wymuszoną tunelowaną przez inną zaporę w równorzędnej sieci wirtualnej
wdrażanie hosta bastionu w sieci wirtualnej koncentratora

wdrażanie w usłudze Azure
Ten szablon tworzy dwie sieci wirtualne z komunikacją równorzędną, hostem bastionu w sieci wirtualnej piasty i maszyną wirtualną z systemem Linux w sieci wirtualnej będącej szprychą
wdrażanie piaskownicy topologii piasty i szprych

wdrażanie w usłudze Azure
Ten szablon tworzy podstawową konfigurację topologii piasty i szprych. Tworzy ona sieć wirtualną piasty z podsieciami DMZ, zarządzaniem, współdzieloną i bramą (opcjonalnie) z dwiema sieciami wirtualnymi szprych (programowanie i produkcja) zawierającą podsieć obciążenia. Wdraża również Jump-Host systemu Windows w podsieci Zarządzania centrum i ustanawia wirtualne sieci równorzędne między piastą a dwiema szprychami.
wdrażanie replikacji bazy HBase z dwiema sieciami wirtualnymi w jednym regionie

wdrażanie w usłudze Azure
Ten szablon umożliwia skonfigurowanie środowiska HBase sieci HBase z dwoma klastrami HBase w dwóch sieciach wirtualnych w tym samym regionie na potrzeby konfigurowania replikacji bazy danych HBase.
równorzędne dwie istniejące sieci wirtualne w jednym regionie

wdrażanie w usłudze Azure
Ten szablon umożliwia łączenie dwóch sieci wirtualnych z tych samych lub różnych grup zasobów w tym samym regionie przy użyciu komunikacji równorzędnej sieci wirtualnych
publicznego modułu równoważenia obciążenia połączonego z usługą Load Balancer bramy

wdrażanie w usłudze Azure
Ten szablon umożliwia wdrożenie modułu równoważenia obciążenia w warstwie Standardowa w warstwie Standardowa połączonego z modułem równoważenia obciążenia bramy. Ruch przychodzący z Internetu jest kierowany do modułu równoważenia obciążenia bramy z maszynami wirtualnymi z systemem Linux (WUS) w puli zaplecza.
użyj usługi Azure Firewall jako serwera proxy DNS w topologii gwiazdy & piasty

wdrażanie w usłudze Azure
W tym przykładzie pokazano, jak wdrożyć topologię piasty i szprych na platformie Azure przy użyciu usługi Azure Firewall. Sieć wirtualna piasty działa jako centralny punkt łączności z wieloma sieciami wirtualnymi szprych, które są połączone z siecią wirtualną koncentratora za pośrednictwem komunikacji równorzędnej sieci wirtualnych.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu virtualNetworks/virtualNetworkPeerings można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/virtualNetworks/virtualNetworkPeerings, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-01-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
    }
  })
}

Wartości właściwości

Przestrzeń adresowa

Nazwa Opis Wartość
addressPrefixes (prefiksy adresów) Lista bloków adresów zarezerwowanych dla tej sieci wirtualnej w notacji CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: virtualNetworks
Właściwości Właściwości komunikacji równorzędnej sieci wirtualnej. VirtualNetworkPeeringPropertiesFormat
typ Typ zasobu "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-01-01"

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. struna

VirtualNetworkBgpCommunities

Nazwa Opis Wartość
virtualNetworkCommunity Społeczność protokołu BGP skojarzona z siecią wirtualną. ciąg (wymagany)

VirtualNetworkPeeringPropertiesFormat

Nazwa Opis Wartość
allowForwardedTraffic Czy ruch przekazywany z maszyn wirtualnych w lokalnej sieci wirtualnej będzie dozwolony/niedozwolony w zdalnej sieci wirtualnej. Bool
allowGatewayTransit Jeśli łącza bramy mogą być używane w zdalnej sieci wirtualnej w celu połączenia z tą siecią wirtualną. Bool
allowVirtualNetworkAccess Czy maszyny wirtualne w lokalnej przestrzeni sieci wirtualnej będą mogły uzyskiwać dostęp do maszyn wirtualnych w zdalnej przestrzeni sieci wirtualnej. Bool
doNotVerifyRemoteGateways Jeśli musimy zweryfikować stan aprowizacji bramy zdalnej. Bool
enableOnlyIPv6Peering Czy tylko przestrzeń adresowa Ipv6 jest równorzędna dla komunikacji równorzędnej podsieci. Bool
localAddressSpace Lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
localSubnetNames Lista nazw podsieci lokalnych, które są równorzędne podsieci z zdalną siecią wirtualną. string[]
localVirtualNetworkAddressSpace Bieżąca lokalna przestrzeń adresowa lokalnej sieci wirtualnej, która jest równorzędna. Przestrzeni adresowej
peerCompleteVnets Czy kompletna przestrzeń adresowa sieci wirtualnej jest równorzędna. Bool
peeringState Stan komunikacji równorzędnej sieci wirtualnej. "Połączono"
"Rozłączono"
"Zainicjowano"
komunikacja równorzędnaSyncLevel Stan synchronizacji komunikacji równorzędnej komunikacji równorzędnej sieci wirtualnej. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Odwołanie do przestrzeni adresowej równorzędnej z zdalną siecią wirtualną. Przestrzeni adresowej
remoteBgpCommunities Odwołanie do społeczności Bgp zdalnej sieci wirtualnej. VirtualNetworkBgpCommunities
remoteSubnetNames Lista nazw zdalnych podsieci z zdalnej sieci wirtualnej, która jest równorzędna podsieci. string[]
remoteVirtualNetwork Odwołanie do zdalnej sieci wirtualnej. Zdalna sieć wirtualna może znajdować się w tym samym lub innym regionie (wersja zapoznawcza). Zobacz tutaj, aby zarejestrować się w celu uzyskania wersji zapoznawczej i dowiedzieć się więcej (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Odwołanie do bieżącej przestrzeni adresowej zdalnej sieci wirtualnej. Przestrzeni adresowej
useRemoteGateways Jeśli bramy zdalne mogą być używane w tej sieci wirtualnej. Jeśli flaga ma wartość true, a właściwość allowGatewayTransit w zdalnej komunikacji równorzędnej ma również wartość true, sieć wirtualna będzie używać bram zdalnej sieci wirtualnej do przesyłania. Tylko jedna komunikacja równorzędna może mieć tę flagę ustawioną na wartość true. Nie można ustawić tej flagi, jeśli sieć wirtualna ma już bramę. Bool