共用方式為


Microsoft.Network virtualNetworks/virtualNetworkPeerings

Bicep 資源定義

virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源,請將下列 Bicep 新增至範本。

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

屬性值

AddressSpace

名字 描述 價值
addressPrefixes 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 string[]
ipamPoolPrefixAllocations 配置IP位址前置的IPAM集區清單。 IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

名字 描述 價值
numberOfIpAddresses 要配置的IP位址數目。 字串
IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

名字 描述 價值
id 相關聯 Azure IpamPool 資源的資源標識碼。 字串

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

名字 描述 價值
名字 資源名稱 字串 (必要)
父母 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增這個屬性。

如需詳細資訊,請參閱 父資源外部的子資源
類型的資源符號名稱:virtualNetworks
性能 虛擬網路對等互連的屬性。 VirtualNetworkPeeringPropertiesFormat

SubResource

名字 描述 價值
id 資源標識碼。 字串

VirtualNetworkBgp 社群

名字 描述 價值
virtualNetworkCommunity 與虛擬網路相關聯的 BGP 社群。 字串 (必要)

VirtualNetworkPeeringPropertiesFormat

名字 描述 價值
allowForwardedTraffic 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 bool
allowGatewayTransit 如果閘道連結可用於遠端虛擬網路,以連結至此虛擬網路。 bool
allowVirtualNetworkAccess 本機虛擬網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 bool
doNotVerifyRemoteGateways 如果需要驗證遠端閘道的布建狀態。 bool
enableOnlyIPv6Peering 子網對等互連是否只對等互連 Ipv6 位址空間。 bool
localAddressSpace 對等互連之本機虛擬網路的本機位址空間。 AddressSpace
localSubnetNames 與遠端虛擬網路對等互連的子網名稱清單。 string[]
localVirtualNetworkAddressSpace 對等互連之本機虛擬網路的目前本機位址空間。 AddressSpace
peerCompleteVnets 完整的虛擬網路位址空間是否對等互連。 bool
peeringState 虛擬網路對等互連的狀態。 'Connected'
'Disconnected'
'Initiated'
peeringSyncLevel 虛擬網路對等互連的對等互連同步處理狀態。 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace 與遠端虛擬網路對等互連之位址空間的參考。 AddressSpace
remoteBgpCommunities 遠端虛擬網路 Bgp 社群的參考。 VirtualNetworkBgpCommunities
remoteSubnetNames 來自子網對等互連之遠端虛擬網路的遠端子網名稱清單。 string[]
remoteVirtualNetwork 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域(預覽)。 請參閱這裡以註冊預覽,並深入瞭解 (/azure/virtual-network/virtual-network-create-peering)。 SubResource
remoteVirtualNetworkAddressSpace 遠端虛擬網路目前位址空間的參考。 AddressSpace
useRemoteGateways 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true,而遠端對等互連上的 allowGatewayTransit 也是 true,虛擬網路將會使用遠端虛擬網路的閘道進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道,則無法設定此旗標。 bool

快速入門範例

下列快速入門範例會部署此資源類型。

Bicep 檔案 描述
Azure Game 開發人員虛擬機 Azure 遊戲開發人員虛擬機包含 Unreal 等授權引擎。
使用 vNet 對等互連建立 vNet 對 vNet 連線 此範本可讓您使用 vNet 對等互連來連線兩個 vNet
在中樞虛擬網路中部署 Bastion 主機 此範本會建立兩個具有對等互連的 vNet、中樞 vNet 中的 Bastion 主機,以及輪輻 vNet 中的 Linux VM
將單一區域內的兩個現有 VNet 對等互連 此範本可讓您使用 VNet 對等互連,從相同區域中的相同或不同資源群組連線兩個 VNET
已鏈結至閘道 Load Balancer 的公用 Load Balancer 此範本可讓您部署鏈結至閘道 Load Balancer 的公用標準 Load Balancer。 來自因特網的流量會路由傳送至後端集區中具有Linux VM(NVA)的網關負載平衡器。
使用 Azure 防火牆作為中樞 & 輪輻拓撲中的 DNS Proxy 此範例示範如何使用 Azure 防火牆在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的中央點。

ARM 樣本資源定義

virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源,請將下列 JSON 新增至範本。

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

屬性值

AddressSpace

名字 描述 價值
addressPrefixes 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 string[]
ipamPoolPrefixAllocations 配置IP位址前置的IPAM集區清單。 IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

名字 描述 價值
numberOfIpAddresses 要配置的IP位址數目。 字串
IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

名字 描述 價值
id 相關聯 Azure IpamPool 資源的資源標識碼。 字串

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

名字 描述 價值
apiVersion API 版本 '2024-05-01'
名字 資源名稱 字串 (必要)
性能 虛擬網路對等互連的屬性。 VirtualNetworkPeeringPropertiesFormat
類型 資源類型 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'

SubResource

名字 描述 價值
id 資源標識碼。 字串

VirtualNetworkBgp 社群

名字 描述 價值
virtualNetworkCommunity 與虛擬網路相關聯的 BGP 社群。 字串 (必要)

VirtualNetworkPeeringPropertiesFormat

名字 描述 價值
allowForwardedTraffic 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 bool
allowGatewayTransit 如果閘道連結可用於遠端虛擬網路,以連結至此虛擬網路。 bool
allowVirtualNetworkAccess 本機虛擬網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 bool
doNotVerifyRemoteGateways 如果需要驗證遠端閘道的布建狀態。 bool
enableOnlyIPv6Peering 子網對等互連是否只對等互連 Ipv6 位址空間。 bool
localAddressSpace 對等互連之本機虛擬網路的本機位址空間。 AddressSpace
localSubnetNames 與遠端虛擬網路對等互連的子網名稱清單。 string[]
localVirtualNetworkAddressSpace 對等互連之本機虛擬網路的目前本機位址空間。 AddressSpace
peerCompleteVnets 完整的虛擬網路位址空間是否對等互連。 bool
peeringState 虛擬網路對等互連的狀態。 'Connected'
'Disconnected'
'Initiated'
peeringSyncLevel 虛擬網路對等互連的對等互連同步處理狀態。 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace 與遠端虛擬網路對等互連之位址空間的參考。 AddressSpace
remoteBgpCommunities 遠端虛擬網路 Bgp 社群的參考。 VirtualNetworkBgpCommunities
remoteSubnetNames 來自子網對等互連之遠端虛擬網路的遠端子網名稱清單。 string[]
remoteVirtualNetwork 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域(預覽)。 請參閱這裡以註冊預覽,並深入瞭解 (/azure/virtual-network/virtual-network-create-peering)。 SubResource
remoteVirtualNetworkAddressSpace 遠端虛擬網路目前位址空間的參考。 AddressSpace
useRemoteGateways 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true,而遠端對等互連上的 allowGatewayTransit 也是 true,虛擬網路將會使用遠端虛擬網路的閘道進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道,則無法設定此旗標。 bool

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
Azure Game 開發人員虛擬機

部署至 Azure
Azure 遊戲開發人員虛擬機包含 Unreal 等授權引擎。
使用 vNet 對等互連建立 vNet 對 vNet 連線

部署至 Azure
此範本可讓您使用 vNet 對等互連來連線兩個 vNet
使用強制通道建立 Azure 防火牆沙箱

部署至 Azure
此範本會建立一個 Azure 防火牆沙箱 (Linux),其中一個防火牆強制透過對等互連 VNET 中的另一個防火牆進行通道
在中樞虛擬網路中部署 Bastion 主機

部署至 Azure
此範本會建立兩個具有對等互連的 vNet、中樞 vNet 中的 Bastion 主機,以及輪輻 vNet 中的 Linux VM
部署中樞和輪輻拓撲沙盒

部署至 Azure
此範本會建立基本的中樞和輪輻拓撲設定。 它會建立具有 DMZ、管理、共用和閘道子網的中樞 VNet(選擇性),其中兩個輪輻 VNet(開發和生產環境)包含每個工作負載子網。 它也會在中樞的管理子網上部署 Windows Jump-Host,並在中樞與兩個輪輻之間建立 VNet 對等互連。
在一個區域中部署具有兩個 VNet 的 HBase 複寫

部署至 Azure
此範本可讓您在相同區域中的兩個 VNet 內設定具有兩個 HBase 叢集的 HBase 環境,以設定 HBase 複寫。
將單一區域內的兩個現有 VNet 對等互連

部署至 Azure
此範本可讓您使用 VNet 對等互連,從相同區域中的相同或不同資源群組連線兩個 VNET
已鏈結至閘道 Load Balancer 的公用 Load Balancer

部署至 Azure
此範本可讓您部署鏈結至閘道 Load Balancer 的公用標準 Load Balancer。 來自因特網的流量會路由傳送至後端集區中具有Linux VM(NVA)的網關負載平衡器。
使用 Azure 防火牆作為中樞 & 輪輻拓撲中的 DNS Proxy

部署至 Azure
此範例示範如何使用 Azure 防火牆在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的中央點。

Terraform (AzAPI 提供者) 資源定義

virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源,請將下列 Terraform 新增至範本。

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

屬性值

AddressSpace

名字 描述 價值
addressPrefixes 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 string[]
ipamPoolPrefixAllocations 配置IP位址前置的IPAM集區清單。 IpamPoolPrefixAllocation[]

IpamPoolPrefixAllocation

名字 描述 價值
numberOfIpAddresses 要配置的IP位址數目。 字串
IpamPoolPrefixAllocationPool

IpamPoolPrefixAllocationPool

名字 描述 價值
id 相關聯 Azure IpamPool 資源的資源標識碼。 字串

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

名字 描述 價值
名字 資源名稱 字串 (必要)
parent_id 此資源為父系之資源的標識碼。 類型的資源標識碼:virtualNetworks
性能 虛擬網路對等互連的屬性。 VirtualNetworkPeeringPropertiesFormat
類型 資源類型 “Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-05-01”

SubResource

名字 描述 價值
id 資源標識碼。 字串

VirtualNetworkBgp 社群

名字 描述 價值
virtualNetworkCommunity 與虛擬網路相關聯的 BGP 社群。 字串 (必要)

VirtualNetworkPeeringPropertiesFormat

名字 描述 價值
allowForwardedTraffic 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 bool
allowGatewayTransit 如果閘道連結可用於遠端虛擬網路,以連結至此虛擬網路。 bool
allowVirtualNetworkAccess 本機虛擬網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 bool
doNotVerifyRemoteGateways 如果需要驗證遠端閘道的布建狀態。 bool
enableOnlyIPv6Peering 子網對等互連是否只對等互連 Ipv6 位址空間。 bool
localAddressSpace 對等互連之本機虛擬網路的本機位址空間。 AddressSpace
localSubnetNames 與遠端虛擬網路對等互連的子網名稱清單。 string[]
localVirtualNetworkAddressSpace 對等互連之本機虛擬網路的目前本機位址空間。 AddressSpace
peerCompleteVnets 完整的虛擬網路位址空間是否對等互連。 bool
peeringState 虛擬網路對等互連的狀態。 'Connected'
'Disconnected'
'Initiated'
peeringSyncLevel 虛擬網路對等互連的對等互連同步處理狀態。 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace 與遠端虛擬網路對等互連之位址空間的參考。 AddressSpace
remoteBgpCommunities 遠端虛擬網路 Bgp 社群的參考。 VirtualNetworkBgpCommunities
remoteSubnetNames 來自子網對等互連之遠端虛擬網路的遠端子網名稱清單。 string[]
remoteVirtualNetwork 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域(預覽)。 請參閱這裡以註冊預覽,並深入瞭解 (/azure/virtual-network/virtual-network-create-peering)。 SubResource
remoteVirtualNetworkAddressSpace 遠端虛擬網路目前位址空間的參考。 AddressSpace
useRemoteGateways 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true,而遠端對等互連上的 allowGatewayTransit 也是 true,虛擬網路將會使用遠端虛擬網路的閘道進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道,則無法設定此旗標。 bool