Microsoft.Network virtualNetworks/virtualNetworkPeerings
- 最新
- 2024-03-01
- 2024-01-01
- 2023-11-01
- 2023-09-01
- 2023-06-01
- 2023-05-01
- 2023-04-01
- 2023-02-01
- 2022-11-01
- 2022-09-01
- 2022-07-01
- 2022-05-01
- 2022-01-01
- 2021-08-01
- 2021-05-01
- 2021-03-01
- 2021-02-01
- 2020-11-01
- 2020-08-01
- 2020-07-01
- 2020-06-01
- 2020-05-01
- 2020-04-01
- 2020-03-01
- 2019-12-01
- 2019-11-01
- 2019-09-01
- 2019-08-01
- 2019-07-01
- 2019-06-01
- 2019-04-01
- 2019-02-01
- 2018-12-01
- 2018-11-01
- 2018-10-01
- 2018-08-01
- 2018-07-01
- 2018-06-01
- 2018-04-01
- 2018-02-01
- 2018-01-01
- 2017-11-01
- 2017-10-01
- 2017-09-01
- 2017-08-01
- 2017-06-01
- 2017-03-30
- 2017-03-01
- 2016-12-01
- 2016-09-01
- 2016-06-01
Bicep 資源定義
virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源，請將下列 Bicep 新增至範本。
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
}
}
屬性值
AddressSpace
| 名字 | 描述 | 價值 |
|---|---|---|
| addressPrefixes | 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 | string[] |
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-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"
}
}
屬性值
AddressSpace
| 名字 | 描述 | 價值 |
|---|---|---|
| addressPrefixes | 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 | string[] |
Microsoft.Network/virtualNetworks/virtualNetworkPeerings
| 名字 | 描述 | 價值 |
|---|---|---|
| apiVersion | API 版本 | '2024-03-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 遊戲開發人員虛擬機包含 Unreal 等授權引擎。 |
|
使用 vNet 對等互連建立 vNet 對 vNet 連線
|
此範本可讓您使用 vNet 對等互連來連線兩個 vNet |
|
使用強制通道建立 Azure 防火牆沙箱
|
此範本會建立一個 Azure 防火牆沙箱 （Linux），其中一個防火牆強制透過對等互連 VNET 中的另一個防火牆進行通道 |
|
在中樞虛擬網路中部署 Bastion 主機
|
此範本會建立兩個具有對等互連的 vNet、中樞 vNet 中的 Bastion 主機，以及輪輻 vNet 中的 Linux VM |
|
部署中樞和輪輻拓撲沙盒
|
此範本會建立基本的中樞和輪輻拓撲設定。 它會建立具有 DMZ、管理、共用和閘道子網的中樞 VNet（選擇性），其中兩個輪輻 VNet（開發和生產環境）包含每個工作負載子網。 它也會在中樞的管理子網上部署 Windows Jump-Host，並在中樞與兩個輪輻之間建立 VNet 對等互連。 |
|
在一個區域中部署具有兩個 VNet 的 HBase 複寫
|
此範本可讓您在相同區域中的兩個 VNet 內設定具有兩個 HBase 叢集的 HBase 環境，以設定 HBase 複寫。 |
|
將單一區域內的兩個現有 VNet 對等互連
|
此範本可讓您使用 VNet 對等互連，從相同區域中的相同或不同資源群組連線兩個 VNET |
|
已鏈結至閘道 Load Balancer 的公用 Load Balancer
|
此範本可讓您部署鏈結至閘道 Load Balancer 的公用標準 Load Balancer。 來自因特網的流量會路由傳送至後端集區中具有Linux VM（NVA）的網關負載平衡器。 |
|
使用 Azure 防火牆作為中樞 & 輪輻拓撲中的 DNS Proxy
|
此範例示範如何使用 Azure 防火牆在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的中央點。 |
Terraform （AzAPI 提供者） 資源定義
virtualNetworks/virtualNetworkPeerings 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Network/virtualNetworks/virtualNetworkPeerings 資源，請將下列 Terraform 新增至範本。
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
}
})
}
屬性值
AddressSpace
| 名字 | 描述 | 價值 |
|---|---|---|
| addressPrefixes | 以 CIDR 表示法保留給此虛擬網路的位址區塊清單。 | string[] |
Microsoft.Network/virtualNetworks/virtualNetworkPeerings
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源名稱 | 字串 （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型的資源標識碼：virtualNetworks |
| 性能 | 虛擬網路對等互連的屬性。 | VirtualNetworkPeeringPropertiesFormat |
| 類型 | 資源類型 | “Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-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 |