Compartilhar via

Microsoft.Network virtualNetworks/virtualNetworkPeerings 2024-01-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso virtualNetworks/virtualNetworkPeerings pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o Bicep a seguir ao seu modelo.

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

Valores de propriedade

AddressSpace

Nome Descrição Valor
addressPrefixes Uma lista de blocos de endereço reservados para essa rede virtual na notação CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
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
Propriedades Propriedades do emparelhamento de rede virtual. virtualNetworkPeeringPropertiesFormat

SubResource

Nome Descrição Valor
id ID do recurso. corda

VirtualNetworkBgpCommunities

Nome Descrição Valor
virtualNetworkCommunity A comunidade BGP associada à rede virtual. cadeia de caracteres (obrigatório)

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
enableOnlyIPv6Peering Se apenas o espaço de endereço Ipv6 é emparelhado para emparelhamento de sub-rede. Bool
localAddressSpace O espaço de endereço local da rede virtual local emparelhada. do AddressSpace
localSubnetNames Lista de nomes de sub-rede locais que são emparelhados com a rede virtual remota. string[]
localVirtualNetworkAddressSpace O espaço de endereço local atual da rede virtual local emparelhada. do AddressSpace
peerCompleteVnets Se o espaço de endereço de rede virtual completo está emparelhado. Bool
peeringState O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
peeringSyncLevel O status de sincronização de emparelhamento 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. do AddressSpace
remoteBgpCommunities A referência às Comunidades bgp da rede virtual remota. VirtualNetworkBgpCommunities
remoteSubnetNames Lista de nomes de sub-rede remota da rede virtual remota que são emparelhados com sub-rede. string[]
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). Veja aqui para se registrar na versão prévia e saiba mais (/azure/virtual-network/virtual-network-create-peering). sub-recurso
remoteVirtualNetworkAddressSpace A referência ao espaço de endereço atual da rede virtual remota. do AddressSpace
useRemoteGateways Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador for 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

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
de Máquina Virtual do Desenvolvedor de Jogos do Azure A Máquina Virtual do Desenvolvedor de Jogos do Azure inclui mecanismos licencsed como o Unreal.
Criar uma conexão vNet com vNet usando de emparelhamento vNet Este modelo permite que você conecte duas vNets usando o emparelhamento vNet
implantar um host bastion em um hub de Rede Virtual Este modelo cria duas vNets com emparelhamentos, um host bastion na vNet hub e uma VM Linux na vNet spoke
emparelhar duas VNets existentes em uma única região Este modelo permite que você conecte dois VNETs dos mesmos ou diferentes grupos de recursos na mesma região usando o emparelhamento VNet
Load Balancer Público encadeado a um do Balanceador de Carga do Gateway Esse modelo permite implantar um Load Balancer Padrão Público encadeado em um Load Balancer de Gateway. O tráfego de entrada da Internet é roteado para o Gateway Load Balancer com NVAs (VMs linux) no pool de back-end.
usar o Firewall do Azure como proxy DNS em uma topologia do 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 com muitas redes virtuais spoke conectadas à rede virtual do hub por meio do emparelhamento de rede virtual.

Definição de recurso de modelo do ARM

O tipo de recurso virtualNetworks/virtualNetworkPeerings pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de 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": "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"
  }
}

Valores de propriedade

AddressSpace

Nome Descrição Valor
addressPrefixes Uma lista de blocos de endereço reservados para essa rede virtual na notação CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrição Valor
apiVersion A versão da API '2024-01-01'
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do emparelhamento de rede virtual. virtualNetworkPeeringPropertiesFormat
tipo O tipo de recurso 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'

SubResource

Nome Descrição Valor
id ID do recurso. corda

VirtualNetworkBgpCommunities

Nome Descrição Valor
virtualNetworkCommunity A comunidade BGP associada à rede virtual. cadeia de caracteres (obrigatório)

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
enableOnlyIPv6Peering Se apenas o espaço de endereço Ipv6 é emparelhado para emparelhamento de sub-rede. Bool
localAddressSpace O espaço de endereço local da rede virtual local emparelhada. do AddressSpace
localSubnetNames Lista de nomes de sub-rede locais que são emparelhados com a rede virtual remota. string[]
localVirtualNetworkAddressSpace O espaço de endereço local atual da rede virtual local emparelhada. do AddressSpace
peerCompleteVnets Se o espaço de endereço de rede virtual completo está emparelhado. Bool
peeringState O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
peeringSyncLevel O status de sincronização de emparelhamento 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. do AddressSpace
remoteBgpCommunities A referência às Comunidades bgp da rede virtual remota. VirtualNetworkBgpCommunities
remoteSubnetNames Lista de nomes de sub-rede remota da rede virtual remota que são emparelhados com sub-rede. string[]
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). Veja aqui para se registrar na versão prévia e saiba mais (/azure/virtual-network/virtual-network-create-peering). sub-recurso
remoteVirtualNetworkAddressSpace A referência ao espaço de endereço atual da rede virtual remota. do AddressSpace
useRemoteGateways Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador for 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

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
de Máquina Virtual do Desenvolvedor de Jogos do Azure

Implantar no Azure 		A Máquina Virtual do Desenvolvedor de Jogos do Azure inclui mecanismos licencsed como o Unreal.
Criar uma conexão vNet com vNet usando de emparelhamento vNet

Implantar no Azure 		Este modelo permite que você conecte duas vNets usando o emparelhamento vNet
Criar uma área restrita do Firewall do Azure com de túnel forçado

Implantar no Azure 		Este modelo cria uma área restrita do 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 de Rede Virtual

Implantar no Azure 		Este modelo cria duas vNets com emparelhamentos, um host bastion na vNet hub e uma VM Linux na vNet spoke
implantar uma área restrita de topologia hub e spoke

Implantar no Azure 		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 um Windows Jump-Host na sub-rede gerenciamento do HUB e estabelece emparelhamentos de VNet entre o Hub e os dois spokes.
implantar a replicação do HBase com duas VNets em uma região

Implantar no Azure 		Esse modelo permite que você configure um ambiente HBase de AN com dois clusters HBase em duas VNets na mesma região para configurar a replicação do HBase.
emparelhar duas VNets existentes em uma única região

Implantar no Azure 		Este modelo permite que você conecte dois VNETs dos mesmos ou diferentes grupos de recursos na mesma região usando o emparelhamento VNet
Load Balancer Público encadeado a um do Balanceador de Carga do Gateway

Implantar no Azure 		Esse modelo permite implantar um Load Balancer Padrão Público encadeado em um Load Balancer de Gateway. O tráfego de entrada da Internet é roteado para o Gateway Load Balancer com NVAs (VMs linux) no pool de back-end.
usar o Firewall do Azure como proxy DNS em uma topologia do Hub & Spoke

Implantar no Azure 		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 com muitas redes virtuais spoke conectadas à rede virtual do hub por meio do emparelhamento de rede virtual.

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 de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o Terraform a seguir ao seu modelo.

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

Valores de propriedade

AddressSpace

Nome Descrição Valor
addressPrefixes Uma lista de blocos de endereço reservados para essa rede virtual na notação CIDR. string[]

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: virtualNetworks
Propriedades Propriedades do emparelhamento de rede virtual. virtualNetworkPeeringPropertiesFormat
tipo O tipo de recurso "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-01-01"

SubResource

Nome Descrição Valor
id ID do recurso. corda

VirtualNetworkBgpCommunities

Nome Descrição Valor
virtualNetworkCommunity A comunidade BGP associada à rede virtual. cadeia de caracteres (obrigatório)

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
enableOnlyIPv6Peering Se apenas o espaço de endereço Ipv6 é emparelhado para emparelhamento de sub-rede. Bool
localAddressSpace O espaço de endereço local da rede virtual local emparelhada. do AddressSpace
localSubnetNames Lista de nomes de sub-rede locais que são emparelhados com a rede virtual remota. string[]
localVirtualNetworkAddressSpace O espaço de endereço local atual da rede virtual local emparelhada. do AddressSpace
peerCompleteVnets Se o espaço de endereço de rede virtual completo está emparelhado. Bool
peeringState O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
peeringSyncLevel O status de sincronização de emparelhamento 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. do AddressSpace
remoteBgpCommunities A referência às Comunidades bgp da rede virtual remota. VirtualNetworkBgpCommunities
remoteSubnetNames Lista de nomes de sub-rede remota da rede virtual remota que são emparelhados com sub-rede. string[]
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). Veja aqui para se registrar na versão prévia e saiba mais (/azure/virtual-network/virtual-network-create-peering). sub-recurso
remoteVirtualNetworkAddressSpace A referência ao espaço de endereço atual da rede virtual remota. do AddressSpace
useRemoteGateways Se os gateways remotos puderem ser usados nessa rede virtual. Se o sinalizador for 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