Microsoft.Network virtualNetworks/virtualNetworkPeerings 2023-04-01
Bicep 資源定義
virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。
資源格式
若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源，請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
allowForwardedTraffic: bool
allowGatewayTransit: bool
allowVirtualNetworkAccess: bool
doNotVerifyRemoteGateways: bool
peeringState: 'string'
peeringSyncLevel: 'string'
remoteAddressSpace: {
addressPrefixes: [
'string'
]
}
remoteBgpCommunities: {
virtualNetworkCommunity: 'string'
}
remoteVirtualNetwork: {
id: 'string'
}
remoteVirtualNetworkAddressSpace: {
addressPrefixes: [
'string'
]
}
useRemoteGateways: bool
}
}
屬性值
virtualNetworks/virtualNetworkPeerings
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 資源名稱 瞭解如何在 Bicep 中設定子資源的名稱和類型。 |
字串 (必要) 字元限制：1-80 合法字元： 英數字元、底線、句號和連字號。 以英數字元開頭。 以英數字元或底線結尾。 |
| 父系 (parent) | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源之外宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型資源的符號名稱： virtualNetworks |
| properties | 虛擬網路對等互連的屬性。 | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| 名稱 | 描述 | 值 |
|---|---|---|
| allowForwardedTraffic | 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 | bool |
| allowGatewayTransit | 如果閘道連結可用於遠端虛擬網路，以連結至此虛擬網路。 | bool |
| allowVirtualNetworkAccess | 局域網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 | bool |
| doNotVerifyRemoteGateways | 如果需要驗證遠端閘道的布建狀態。 | bool |
| peeringState | 虛擬網路對等互連的狀態。 | 'Connected' 'Disconnected' 'Initiated' |
| peeringSyncLevel | 虛擬網路對等互連的對等互連同步處理狀態。 | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | 與遠端虛擬網路對等互連之位址空間的參考。 | AddressSpace |
| remoteBgp 社群 | 遠端虛擬網路 Bgp 社群的參考。 | VirtualNetworkBgp 社群 |
| remoteVirtualNetwork | 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域中， (預覽) 。 請參閱這裡以註冊預覽版，並深入瞭解 /azure/virtual-network/virtual-network-create-peering) (。 | SubResource |
| remoteVirtualNetworkAddressSpace | 遠端虛擬網路目前位址空間的參考。 | AddressSpace |
| useRemoteGateways | 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true，而允許遠端對等互連上的 AllowGatewayTransit 也是 true，虛擬網路將會使用遠端虛擬網路的閘道進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道，則無法設定此旗標。 | bool |
AddressSpace
| 名稱 | 描述 | 值 |
|---|---|---|
| addressPrefixes | 在 CIDR 表示法中保留給此虛擬網路的位址區塊清單。 | string[] |
VirtualNetworkBgp 社群
| 名稱 | 描述 | 值 |
|---|---|---|
| virtualNetworkCommunity | 與虛擬網路相關聯的 BGP 社群。 | 字串 (必要) |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源識別碼。 | 字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
部署中樞和輪輻拓撲沙盒 |
此範本會建立基本的中樞和輪輻拓撲設定。 它會建立具有 DMZ、管理、共用和閘道 (選擇性) 的中樞 VNet，其中兩個輪輻 VNet (開發和生產) 每個子網都包含工作負載子網。 它也會在中樞的管理子網上部署 Windows Jump-Host，並在中樞與兩個輪輻之間建立 VNet 對等互連。 |
| 已鏈結至閘道 Load Balancer 的公用 Load Balancer |
此範本可讓您部署鏈結至閘道 Load Balancer 的公用 Standard Load Balancer。 從因特網傳入的流量會路由傳送至閘道 Load Balancer，並在後端集區中使用linux VM (NVA) 。 |
| 在一個區域中部署具有兩個 VNet 的 HBase 複寫 |
此範本可讓您在相同區域中的兩個 VNet 內設定具有兩個 HBase 叢集的 HBase 環境，以設定 HBase 複寫。 |
| 使用 Azure 防火牆 作為中樞 & 輪輻拓撲中的 DNS Proxy |
此範例示範如何使用 Azure 防火牆 在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路的許多輪輻虛擬網路的中央點。 |
| 使用強制通道 Create Azure 防火牆 沙箱 |
此範本會建立 Azure 防火牆 沙箱 (Linux) ，其中一個防火牆強制透過對等互連 VNET 中的另一個防火牆進行通道 |
| 在中樞 虛擬網路 部署 Bastion 主機 |
此範本會建立兩個具有對等互連的 vNet、中樞 vNet 中的 Bastion 主機，以及輪輻 vNet 中的 Linux VM |
| 將單一區域內的兩個現有 VNet 對等互連 |
此範本可讓您使用 VNet 對等互連，從相同或不同的資源群組連線兩個 VNET |
| 使用 vNet 對等互連 Create vNet 對 vNet 連線 |
此範本可讓您使用 vNet 對等互連來連線兩個 vNet |
ARM 範本資源定義
virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。
資源格式
若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源，請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.Network/virtualNetworks/virtualNetworkPeerings",
"apiVersion": "2023-04-01",
"name": "string",
"properties": {
"allowForwardedTraffic": "bool",
"allowGatewayTransit": "bool",
"allowVirtualNetworkAccess": "bool",
"doNotVerifyRemoteGateways": "bool",
"peeringState": "string",
"peeringSyncLevel": "string",
"remoteAddressSpace": {
"addressPrefixes": [ "string" ]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "string"
},
"remoteVirtualNetwork": {
"id": "string"
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [ "string" ]
},
"useRemoteGateways": "bool"
}
}
屬性值
virtualNetworks/virtualNetworkPeerings
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings' |
| apiVersion | 資源 API 版本 | '2023-04-01' |
| NAME | 資源名稱 請參閱如何在 JSON ARM 樣本中設定子資源的名稱和類型。 |
字串 (必要) 字元限制：1-80 合法字元： 英數字元、底線、句號和連字號。 以英數字元開頭。 以英數字元或底線結尾。 |
| properties | 虛擬網路對等互連的屬性。 | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| 名稱 | 描述 | 值 |
|---|---|---|
| allowForwardedTraffic | 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 | bool |
| allowGatewayTransit | 如果閘道連結可用於遠端虛擬網路，以連結至此虛擬網路。 | bool |
| allowVirtualNetworkAccess | 局域網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 | bool |
| doNotVerifyRemoteGateways | 如果需要驗證遠端閘道的布建狀態。 | bool |
| peeringState | 虛擬網路對等互連的狀態。 | 'Connected' 'Disconnected' 'Initiated' |
| peeringSyncLevel | 虛擬網路對等互連的對等互連同步處理狀態。 | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | 與遠端虛擬網路對等互連之位址空間的參考。 | AddressSpace |
| remoteBgp 社群 | 遠端虛擬網路 Bgp 社群的參考。 | VirtualNetworkBgp 社群 |
| remoteVirtualNetwork | 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域， (預覽) 。 請參閱這裡以註冊預覽，並深入瞭解 (/azure/virtual-network/virtual-network-create-peering) 。 | SubResource |
| remoteVirtualNetworkAddressSpace | 遠端虛擬網路目前位址空間的參考。 | AddressSpace |
| useRemoteGateways | 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true，而且遠端對等互連上的allowGatewayTransit也成立，虛擬網路將會使用遠端虛擬網路的閘道來進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道，則無法設定此旗標。 | bool |
AddressSpace
| 名稱 | 描述 | 值 |
|---|---|---|
| addressPrefixes | 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 | string[] |
VirtualNetworkBgp 社群
| 名稱 | 描述 | 值 |
|---|---|---|
| virtualNetworkCo一 | 與虛擬網路相關聯的 BGP 社群。 | 需要字串 () |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源識別碼。 | 字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
| 部署中樞和輪輻拓撲沙盒 |
此範本會建立基本的中樞和輪輻拓撲設定。 它會建立具有 DMZ、管理、共用和閘道 (選擇性) 的中樞 VNet，其中兩個輪輻 VNet (開發和生產) 包含工作負載子網。 它也會在中樞的管理子網上部署 Windows Jump-Host，並在中樞與兩個輪輻之間建立 VNet 對等互連。 |
| 已鏈結至閘道的公用 Load Balancer Load Balancer |
此範本可讓您部署鏈結至閘道 Load Balancer 的公用 Standard Load Balancer。 從因特網傳入的流量會透過linux VM (後端集區中的 NVA) 路由傳送至閘道 Load Balancer。 |
| 在一個區域中部署具有兩個 VNet 的 HBase 複寫 |
此範本可讓您在相同區域中的兩個 VNet 內設定具有兩個 HBase 叢集的N HBase 環境，以設定 HBase 複寫。 |
| 使用 Azure 防火牆 作為中樞 & 輪輻拓撲中的 DNS Proxy |
此範例示範如何使用 Azure 防火牆 在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的連線中心點。 |
| 使用強制通道 Create Azure 防火牆 沙箱 |
此範本會建立 Azure 防火牆 沙箱 (Linux) ，其中一個防火牆強制透過對等互連 VNET 中的另一個防火牆進行通道 |
| 在中樞 虛擬網路 部署 Bastion 主機 |
此範本會建立兩個具有對等互連的 vNet、中樞 vNet 中的 Bastion 主機，以及輪輻 vNet 中的 Linux VM |
| 將單一區域內的兩個現有 VNet 對等互連 |
此範本可讓您使用 VNet 對等互連，從相同區域中的相同或不同資源群組連線兩個 VNET |
| 使用 vNet 對等互連 Create vNet 對 vNet 連線 |
此範本可讓您使用 vNet 對等互連連線兩個 vNet |
Terraform (AzAPI 提供者) 資源定義
virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
allowForwardedTraffic = bool
allowGatewayTransit = bool
allowVirtualNetworkAccess = bool
doNotVerifyRemoteGateways = bool
peeringState = "string"
peeringSyncLevel = "string"
remoteAddressSpace = {
addressPrefixes = [
"string"
]
}
remoteBgpCommunities = {
virtualNetworkCommunity = "string"
}
remoteVirtualNetwork = {
id = "string"
}
remoteVirtualNetworkAddressSpace = {
addressPrefixes = [
"string"
]
}
useRemoteGateways = bool
}
})
}
屬性值
virtualNetworks/virtualNetworkPeerings
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01” |
| NAME | 資源名稱 | 需要字串 () 字元限制：1-80 合法字元： 英數字元、底線、句號和連字號。 以英數字元開頭。 以英數字元或底線結尾。 |
| parent_id | 此資源父系之資源的標識碼。 | 類型資源的標識碼： virtualNetworks |
| properties | 虛擬網路對等互連的屬性。 | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| 名稱 | 描述 | 值 |
|---|---|---|
| allowForwardedTraffic | 遠端虛擬網路中是否允許/不允許來自本機虛擬網路中 VM 的轉送流量。 | bool |
| allowGatewayTransit | 如果閘道連結可用於遠端虛擬網路，則連結至此虛擬網路。 | bool |
| allowVirtualNetworkAccess | 本機虛擬網路空間中的 VM 是否能夠存取遠端虛擬網路空間中的 VM。 | bool |
| doNotVerifyRemoteGateways | 如果需要驗證遠端閘道的布建狀態。 | bool |
| peeringState | 虛擬網路對等互連的狀態。 | “Connected” “Disconnected” “起始” |
| peeringSyncLevel | 虛擬網路對等互連的對等互連同步處理狀態。 | “FullyInSync” “LocalAndRemoteNotInSync” “LocalNotInSync” “RemoteNotInSync” |
| remoteAddressSpace | 與遠端虛擬網路對等互連之位址空間的參考。 | AddressSpace |
| remoteBgp 社群 | 遠端虛擬網路 Bgp 社群的參考。 | VirtualNetworkBgp 社群 |
| remoteVirtualNetwork | 遠端虛擬網路的參考。 遠端虛擬網路可以位於相同或不同的區域， (預覽) 。 請參閱這裡以註冊預覽，並深入瞭解 (/azure/virtual-network/virtual-network-create-peering) 。 | SubResource |
| remoteVirtualNetworkAddressSpace | 遠端虛擬網路目前位址空間的參考。 | AddressSpace |
| useRemoteGateways | 如果遠端閘道可用於此虛擬網路。 如果旗標設定為 true，而且遠端對等互連上的allowGatewayTransit也成立，虛擬網路將會使用遠端虛擬網路的閘道來進行傳輸。 只有一個對等互連可以將此旗標設定為 true。 如果虛擬網路已經有閘道，則無法設定此旗標。 | bool |
AddressSpace
| 名稱 | 描述 | 值 |
|---|---|---|
| addressPrefixes | 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 | string[] |
VirtualNetworkBgp 社群
| 名稱 | 描述 | 值 |
|---|---|---|
| virtualNetworkCo一 | 與虛擬網路相關聯的 BGP 社群。 | 需要字串 () |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源識別碼。 | 字串 |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應