Microsoft.Network virtualNetworks/virtualNetworkPeerings 2022-05-01
Definição de recurso do Bicep
O tipo de recurso virtualNetworks/virtualNetworkPeerings pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2022-05-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
}
}
Valores de propriedade
virtualNetworks/virtualNetworkPeerings
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Caracteres alfanuméricos, sublinhados, pontos e hifens. Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado. |
| pai | No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte Recurso filho fora do recurso pai. |
Nome simbólico para o recurso do tipo: virtualNetworks |
| properties | Propriedades do emparelhamento de rede virtual. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Nome | Descrição | Valor |
|---|---|---|
| allowForwardedTraffic | Se o tráfego encaminhado das VMs na rede virtual local será permitido/não permitido na rede virtual remota. | bool |
| allowGatewayTransit | Se os links de gateway puderem ser usados na rede virtual remota para vincular a essa rede virtual. | bool |
| allowVirtualNetworkAccess | Se as VMs no espaço de rede virtual local seriam capazes de acessar as VMs no espaço de rede virtual remoto. | bool |
| doNotVerifyRemoteGateways | Se precisarmos verificar o estado de provisionamento do gateway remoto. | bool |
| peeringState | O status do emparelhamento de rede virtual. | 'Conectado' 'Desconectado' 'Iniciado' |
| peeringSyncLevel | A sincronização de emparelhamento status do emparelhamento de rede virtual. | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | A referência ao espaço de endereço emparelhado com a rede virtual remota. | AddressSpace |
| remoteBgpCommunities | A referência às Comunidades Bgp da rede virtual remota. | VirtualNetworkBgpCommunities |
| remoteVirtualNetwork | A referência à rede virtual remota. A rede virtual remota pode estar na mesma região ou em uma região diferente (versão prévia). Confira aqui para se registrar na versão prévia e saber mais (/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | A referência ao espaço de endereço atual da rede virtual remota. | AddressSpace |
| useRemoteGateways | Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for verdadeiro, a rede virtual usará gateways de rede virtual remota para trânsito. Somente um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não poderá ser definido se a rede virtual já tiver um gateway. | bool |
AddressSpace
| Nome | Descrição | Valor |
|---|---|---|
| addressPrefixes | Uma lista de blocos de endereços reservados para essa rede virtual na notação CIDR. | string[] |
VirtualNetworkBgpCommunities
| Nome | Descrição | Valor |
|---|---|---|
| virtualNetworkCommunity | A comunidade BGP associada à rede virtual. | cadeia de caracteres (obrigatório) |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso. | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
Implantar uma área restrita de topologia hub e spoke |
Esse modelo cria uma configuração básica de topologia hub-and-spoke. Ele cria uma VNet do Hub com sub-redes DMZ, Gerenciamento, Compartilhado e Gateway (opcionalmente), com duas VNets Spoke (desenvolvimento e produção) contendo uma sub-rede de carga de trabalho cada uma. Ele também implanta uma Jump-Host do Windows na sub-rede Gerenciamento do HUB e estabelece emparelhamentos de VNet entre o Hub e os dois spokes. |
| Load Balancer público encadeado a uma Load Balancer de Gateway |
Esse modelo permite implantar uma Standard Load Balancer pública encadeada em um gateway Load Balancer. O tráfego recebido da Internet é roteado para o gateway Load Balancer com NVAs (VMs linux) no pool de back-end. |
| Implantar a replicação do HBase com duas VNets em uma região |
Esse modelo permite que você configure o ambiente AN HBase com dois clusters HBase em duas VNets na mesma região para configurar a replicação do HBase. |
| Usar Firewall do Azure como um proxy DNS em uma topologia Hub & Spoke |
Este exemplo mostra como implantar uma topologia hub-spoke no Azure usando o Firewall do Azure. A rede virtual do hub atua como um ponto central de conectividade para muitas redes virtuais spoke conectadas à rede virtual do hub por meio do emparelhamento de rede virtual. |
| Create uma área restrita Firewall do Azure com túnel forçado |
Este modelo cria uma área restrita Firewall do Azure (Linux) com uma força de firewall em túnel por meio de outro firewall em uma VNET emparelhada |
| Implantar um host bastion em um hub Rede Virtual |
Este modelo cria duas vNets com emparelhamentos, um host Bastion na vNet do Hub e uma VM Linux na vNet spoke |
| Emparelhar duas VNets existentes em uma única região |
Esse modelo permite que você conecte dois VNETs dos mesmos grupos de recursos ou diferentes na mesma região usando o emparelhamento VNet |
| Create uma conexão vNet com vNet usando o emparelhamento vNet |
Este modelo permite que você conecte duas vNets usando o emparelhamento vNet |
Definição de recurso de modelo do ARM
O tipo de recurso virtualNetworks/virtualNetworkPeerings pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.Network/virtualNetworks/virtualNetworkPeerings",
"apiVersion": "2022-05-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"
}
}
Valores de propriedade
virtualNetworks/virtualNetworkPeerings
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings' |
| apiVersion | A versão da API de recursos | '2022-05-01' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Caracteres alfanuméricos, sublinhados, pontos e hifens. Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado. |
| properties | Propriedades do emparelhamento de rede virtual. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Nome | Descrição | Valor |
|---|---|---|
| allowForwardedTraffic | Se o tráfego encaminhado das VMs na rede virtual local será permitido/não permitido na rede virtual remota. | bool |
| allowGatewayTransit | Se os links de gateway puderem ser usados na rede virtual remota para vincular a essa rede virtual. | bool |
| allowVirtualNetworkAccess | Se as VMs no espaço de rede virtual local seriam capazes de acessar as VMs no espaço de rede virtual remoto. | bool |
| doNotVerifyRemoteGateways | Se precisarmos verificar o estado de provisionamento do gateway remoto. | bool |
| peeringState | O status do emparelhamento de rede virtual. | 'Conectado' 'Desconectado' 'Iniciado' |
| peeringSyncLevel | A sincronização de emparelhamento status do emparelhamento de rede virtual. | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | A referência ao espaço de endereço emparelhado com a rede virtual remota. | AddressSpace |
| remoteBgpCommunities | A referência às Comunidades Bgp da rede virtual remota. | VirtualNetworkBgpCommunities |
| remoteVirtualNetwork | A referência à rede virtual remota. A rede virtual remota pode estar na mesma região ou em uma região diferente (versão prévia). Confira aqui para se registrar para a versão prévia e saiba mais (/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | A referência ao espaço de endereço atual da rede virtual remota. | AddressSpace |
| useRemoteGateways | Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for verdadeiro, a rede virtual usará gateways de rede virtual remota para trânsito. Somente um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não poderá ser definido se a rede virtual já tiver um gateway. | bool |
AddressSpace
| Nome | Descrição | Valor |
|---|---|---|
| addressPrefixes | Uma lista de blocos de endereço reservados para essa rede virtual na notação CIDR. | string[] |
VirtualNetworkBgpCommunities
| Nome | Descrição | Valor |
|---|---|---|
| virtualNetworkCommunity | A comunidade BGP associada à rede virtual. | cadeia de caracteres (obrigatório) |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso. | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
| Implantar uma área restrita de topologia hub e spoke |
Este modelo cria uma configuração básica de topologia hub-and-spoke. Ele cria uma VNet do Hub com sub-redes DMZ, Gerenciamento, Compartilhado e Gateway (opcionalmente), com duas VNets Spoke (desenvolvimento e produção) contendo uma sub-rede de carga de trabalho cada uma. Ele também implanta uma Jump-Host do Windows na sub-rede gerenciamento do HUB e estabelece emparelhamentos de VNet entre o Hub e os dois spokes. |
| Load Balancer público encadeado a um gateway Load Balancer |
Esse modelo permite que você implante uma Standard Load Balancer pública encadeada a um gateway Load Balancer. O tráfego de entrada da Internet é roteado para o gateway Load Balancer com NVAs (VMs linux) no pool de back-end. |
| Implantar a replicação do HBase com duas VNets em uma região |
Esse modelo permite configurar um ambiente HBase de AN com dois clusters HBase em duas VNets na mesma região para configurar a replicação do HBase. |
| Usar Firewall do Azure como proxy DNS em uma topologia Hub & Spoke |
Este exemplo mostra como implantar uma topologia hub-spoke no Azure usando o Firewall do Azure. A rede virtual do hub atua como um ponto central de conectividade para muitas redes virtuais spoke conectadas à rede virtual do hub por meio do emparelhamento de rede virtual. |
| Create uma área restrita Firewall do Azure com túnel forçado |
Este modelo cria uma área restrita Firewall do Azure (Linux) com um firewall forçado por túnel por meio de outro firewall em uma VNET emparelhada |
| Implantar um host do Bastion em um hub Rede Virtual |
Este modelo cria duas vNets com emparelhamentos, um host Bastion na vNet do Hub e uma VM Linux na vNet spoke |
| Emparelhar duas VNets existentes em uma única região |
Esse modelo permite que você conecte dois VNETs dos mesmos grupos de recursos ou de diferentes grupos de recursos na mesma região usando o emparelhamento VNet |
| Create uma conexão vNet para vNet usando o emparelhamento vNet |
Este modelo permite que você conecte duas vNets usando o emparelhamento vNet |
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso virtualNetworks/virtualNetworkPeerings pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o Terraform a seguir ao modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2022-05-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
}
})
}
Valores de propriedade
virtualNetworks/virtualNetworkPeerings
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2022-05-01" |
| name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Caracteres alfanuméricos, sublinhados, pontos e hifens. Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado. |
| parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: virtualNetworks |
| properties | Propriedades do emparelhamento de rede virtual. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Nome | Descrição | Valor |
|---|---|---|
| allowForwardedTraffic | Se o tráfego encaminhado das VMs na rede virtual local será permitido/não permitido na rede virtual remota. | bool |
| allowGatewayTransit | Se os links de gateway puderem ser usados na rede virtual remota para vincular a essa rede virtual. | bool |
| allowVirtualNetworkAccess | Se as VMs no espaço de rede virtual local seriam capazes de acessar as VMs no espaço de rede virtual remoto. | bool |
| doNotVerifyRemoteGateways | Se precisarmos verificar o estado de provisionamento do gateway remoto. | bool |
| peeringState | O status do emparelhamento de rede virtual. | "Conectado" "Desconectado" "Iniciado" |
| peeringSyncLevel | A sincronização de emparelhamento status do emparelhamento de rede virtual. | "FullyInSync" "LocalAndRemoteNotInSync" "LocalNotInSync" "RemoteNotInSync" |
| remoteAddressSpace | A referência ao espaço de endereço emparelhado com a rede virtual remota. | AddressSpace |
| remoteBgpCommunities | A referência às Comunidades Bgp da rede virtual remota. | VirtualNetworkBgpCommunities |
| remoteVirtualNetwork | A referência à rede virtual remota. A rede virtual remota pode estar na mesma região ou em uma região diferente (versão prévia). Confira aqui para se registrar na versão prévia e saber mais (/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | A referência ao espaço de endereço atual da rede virtual remota. | AddressSpace |
| useRemoteGateways | Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for verdadeiro, a rede virtual usará gateways de rede virtual remota para trânsito. Somente um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não poderá ser definido se a rede virtual já tiver um gateway. | bool |
AddressSpace
| Nome | Descrição | Valor |
|---|---|---|
| addressPrefixes | Uma lista de blocos de endereços reservados para essa rede virtual na notação CIDR. | string[] |
VirtualNetworkBgpCommunities
| Nome | Descrição | Valor |
|---|---|---|
| virtualNetworkCommunity | A comunidade BGP associada à rede virtual. | cadeia de caracteres (obrigatório) |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso. | string |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de