Partilhar via

Microsoft.Network virtualNetworks/virtualNetworkPeerings 2023-04-01

  • Artigo

Definição de recursos do bíceps

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

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

Formato do recurso

Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o seguinte Bíceps ao seu modelo.

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

EndereçoEspaço

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

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Designação Descrição Valor
Designação O nome do recurso string (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 recurso do tipo: virtualNetworks
propriedades Propriedades do emparelhamento de rede virtual. VirtualNetworkPeeringPropertiesFormat

Subrecurso

Designação Descrição Valor
ID ID do recurso. string

VirtualNetworkBgpCommunities

Designação Descrição Valor
Comunidade virtualNetworkCommunity A comunidade BGP associada à rede virtual. string (obrigatório)

VirtualNetworkPeeringPropertiesFormat

Designação 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 podem ser usados em 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 remota. Bool
doNotVerifyRemoteGateways Se precisarmos verificar o estado de provisionamento do gateway remoto. Bool
emparelhamentoEstado O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
emparelhamentoSyncLevel O status de sincronização de emparelhamento do emparelhamento de rede virtual. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace [en] 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 regiões diferentes (visualização). Consulte aqui para se registar para a pré-visualização 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 gateways remotos podem ser usados nesta rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for true, a rede virtual usará gateways de rede virtual remota para trânsito. Apenas um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não pode 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
Máquina Virtual do Desenvolvedor de Jogos do Azure A Máquina Virtual do Desenvolvedor de Jogos do Azure inclui Mecanismos Licenciados como o Unreal.
Criar uma conexão vNet para vNet usando o emparelhamento vNet Este modelo permite que você conecte duas vNets usando vNet Peering
Implantar um host Bastion em um hub de Rede Virtual Este modelo cria duas vNets com pares, um host Bastion no Hub vNet e uma VM Linux no spoke vNet
Emparelhar duas VNets existentes dentro de uma única região Este modelo permite conectar duas VNETs do mesmo grupo de recursos ou de grupos de recursos diferentes na mesma região usando o emparelhamento de rede virtual
Balanceador de Carga Público encadeado a um Gateway Load Balancer Este modelo permite implantar um Balanceador de Carga Padrão Público encadeado a um Balanceador de Carga de Gateway. O tráfego recebido da Internet é roteado para o Balanceador de Carga de Gateway com VMs linux (NVAs) no pool de back-end.
Usar o Firewall do Azure como um proxy DNS em um de 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 para muitas redes virtuais faladas que estão conectadas à rede virtual do hub por meio do emparelhamento de rede virtual.

Definição de recurso de modelo ARM

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

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

Formato do recurso

Para criar um recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, adicione o seguinte JSON ao seu modelo.

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

Valores de propriedade

EndereçoEspaço

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

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Designação Descrição Valor
apiVersion A versão api '2023-04-01'
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do emparelhamento de rede virtual. VirtualNetworkPeeringPropertiesFormat
tipo O tipo de recurso 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'

Subrecurso

Designação Descrição Valor
ID ID do recurso. string

VirtualNetworkBgpCommunities

Designação Descrição Valor
Comunidade virtualNetworkCommunity A comunidade BGP associada à rede virtual. string (obrigatório)

VirtualNetworkPeeringPropertiesFormat

Designação 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 podem ser usados em 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 remota. Bool
doNotVerifyRemoteGateways Se precisarmos verificar o estado de provisionamento do gateway remoto. Bool
emparelhamentoEstado O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
emparelhamentoSyncLevel O status de sincronização de emparelhamento do emparelhamento de rede virtual. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace [en] 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 regiões diferentes (visualização). Consulte aqui para se registar para a pré-visualização 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 gateways remotos podem ser usados nesta rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for true, a rede virtual usará gateways de rede virtual remota para trânsito. Apenas um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não pode 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
Máquina Virtual do Desenvolvedor de Jogos do Azure

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

Implantar no Azure 		Este modelo permite que você conecte duas vNets usando vNet Peering
Criar uma área restrita do Firewall do Azure com de encapsulamento forçado

Implantar no Azure 		Este modelo cria uma área restrita do Firewall do Azure (Linux) com uma força de firewall encapsulada por 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 pares, um host Bastion no Hub vNet e uma VM Linux no spoke vNet
Implantar uma área restrita de topologia Hub e Spoke

Implantar no Azure 		Este modelo cria uma configuração básica de topologia hub-and-spoke. Ele cria uma VNet Hub com sub-redes DMZ, Management, Shared e Gateway (opcionalmente), com duas VNets Spoke (desenvolvimento e produção) contendo uma sub-rede de carga de trabalho cada. Ele também implanta um Jump-Host Windows na sub-rede Gerenciamento do HUB e estabelece emparelhamentos VNet entre o Hub e os dois raios.
Implantar a replicação do HBase com duas VNets em uma região

Implantar no Azure 		Este modelo permite configurar o ambiente aN HBase com dois clusters HBase dentro de duas VNets na mesma região para configurar a replicação do HBase.
Emparelhar duas VNets existentes dentro de uma única região

Implantar no Azure 		Este modelo permite conectar duas VNETs do mesmo grupo de recursos ou de grupos de recursos diferentes na mesma região usando o emparelhamento de rede virtual
Balanceador de Carga Público encadeado a um Gateway Load Balancer

Implantar no Azure 		Este modelo permite implantar um Balanceador de Carga Padrão Público encadeado a um Balanceador de Carga de Gateway. O tráfego recebido da Internet é roteado para o Balanceador de Carga de Gateway com VMs linux (NVAs) no pool de back-end.
Usar o Firewall do Azure como um proxy DNS em um de 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 para muitas redes virtuais faladas que estão conectadas à rede virtual do hub por meio do emparelhamento de rede virtual.

Definição de recursos Terraform (provedor AzAPI)

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

  • Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01"
  name = "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

EndereçoEspaço

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

Microsoft.Network/virtualNetworks/virtualNetworkPeerings

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: virtualNetworks
propriedades Propriedades do emparelhamento de rede virtual. VirtualNetworkPeeringPropertiesFormat
tipo O tipo de recurso "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01"

Subrecurso

Designação Descrição Valor
ID ID do recurso. string

VirtualNetworkBgpCommunities

Designação Descrição Valor
Comunidade virtualNetworkCommunity A comunidade BGP associada à rede virtual. string (obrigatório)

VirtualNetworkPeeringPropertiesFormat

Designação 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 podem ser usados em 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 remota. Bool
doNotVerifyRemoteGateways Se precisarmos verificar o estado de provisionamento do gateway remoto. Bool
emparelhamentoEstado O status do emparelhamento de rede virtual. 'Conectado'
'Desconectado'
'Iniciado'
emparelhamentoSyncLevel O status de sincronização de emparelhamento do emparelhamento de rede virtual. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace [en] 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 regiões diferentes (visualização). Consulte aqui para se registar para a pré-visualização 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 gateways remotos podem ser usados nesta rede virtual. Se o sinalizador estiver definido como true e allowGatewayTransit no emparelhamento remoto também for true, a rede virtual usará gateways de rede virtual remota para trânsito. Apenas um emparelhamento pode ter esse sinalizador definido como true. Esse sinalizador não pode ser definido se a rede virtual já tiver um gateway. Bool