Microsoft.Network virtualNetworks/virtualNetworkPeerings 2023-04-01

Definición de recursos de Bicep

El tipo de recurso virtualNetworks/virtualNetworkPeerings se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

virtualNetworks/virtualNetworkPeerings

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.
string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: virtualNetworks
properties Propiedades del emparejamiento de red virtual. VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Nombre Descripción Valor
allowForwardedTraffic Si se permitirá o no el tráfico reenviado desde las máquinas virtuales de la red virtual local en la red virtual remota. bool
allowGatewayTransit Si los vínculos de puerta de enlace se pueden usar en redes virtuales remotas para vincular a esta red virtual. bool
allowVirtualNetworkAccess Si las máquinas virtuales del espacio de red virtual local podrían acceder a las máquinas virtuales en el espacio de red virtual remoto. bool
doNotVerifyRemoteGateways Si es necesario comprobar el estado de aprovisionamiento de la puerta de enlace remota. bool
peeringState Estado del emparejamiento de red virtual. 'Conectado'
'Desconectado'
'Iniciado'
peeringSyncLevel Estado de sincronización de emparejamiento del emparejamiento de la red virtual. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Referencia al espacio de direcciones emparejado con la red virtual remota. AddressSpace
remoteBgpCommunities Referencia a las comunidades Bgp de la red virtual remota. VirtualNetworkBgpCommunities
remoteVirtualNetwork Referencia a la red virtual remota. La red virtual remota puede estar en la misma región o en otra (versión preliminar). Consulte aquí para registrarse en la versión preliminar y obtener más información (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referencia al espacio de direcciones actual de la red virtual remota. AddressSpace
useRemoteGateways Si se pueden usar puertas de enlace remotas en esta red virtual. Si la marca se establece en true y allowGatewayTransit en el emparejamiento remoto también es true, la red virtual usará puertas de enlace de red virtual remota para el tránsito. Solo un emparejamiento puede tener esta marca establecida en true. Esta marca no se puede establecer si la red virtual ya tiene una puerta de enlace. bool

AddressSpace

Nombre Descripción Valor
addressPrefixes Lista de bloques de direcciones reservados para esta red virtual en notación CIDR. string[]

VirtualNetworkBgpCommunities

Nombre Descripción Valor
virtualNetworkCommunity Comunidad BGP asociada a la red virtual. string (obligatorio)

SubResource

Nombre Descripción Value
id Identificador del recurso. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Implementación de un espacio aislado de topología en estrella tipo hub-and-spoke

Implementación en Azure
Esta plantilla crea una configuración básica de topología en estrella tipo hub-and-spoke. Crea una red virtual de concentrador con subredes DMZ, administración, compartido y puerta de enlace (opcionalmente), con dos redes virtuales de radio (desarrollo y producción) que contienen una subred de carga de trabajo cada una. También implementa una Jump-Host de Windows en la subred de administración del centro de conectividad y establece emparejamientos de red virtual entre el concentrador y los dos radios.
Load Balancer pública encadenada a un Load Balancer de puerta de enlace

Implementación en Azure
Esta plantilla permite implementar una Standard Load Balancer pública encadenada a un Load Balancer de puerta de enlace. El tráfico entrante desde Internet se enruta a la puerta de enlace Load Balancer con máquinas virtuales Linux (NVA) en el grupo de back-end.
Implementación de la replicación de HBase con dos redes virtuales en una región

Implementación en Azure
Esta plantilla permite configurar un entorno de HBase de red con dos clústeres de HBase en dos redes virtuales de la misma región para configurar la replicación de HBase.
Uso de Azure Firewall como proxy DNS en una topología de radio de & concentrador

Implementación en Azure
En este ejemplo se muestra cómo implementar una topología en estrella tipo hub-and-spoke en Azure mediante el Azure Firewall. La red virtual del concentrador actúa como punto central de conectividad a muchas redes virtuales de radio que están conectadas a la red virtual de concentrador a través del emparejamiento de redes virtuales.
Create un espacio aislado de Azure Firewall con tunelización forzada

Implementación en Azure
Esta plantilla crea un espacio aislado Azure Firewall (Linux) con una fuerza de firewall tunelizado a través de otro firewall en una red virtual emparejada.
Implementación de un host bastión en un centro de conectividad Virtual Network

Implementación en Azure
Esta plantilla crea dos redes virtuales con emparejamientos, un host de Bastion en la red virtual del concentrador y una máquina virtual Linux en la red virtual de radio.
Emparejar dos redes virtuales existentes dentro de una sola región

Implementación en Azure
Esta plantilla permite conectar dos redes virtuales desde los mismos grupos de recursos o diferentes de la misma región mediante el emparejamiento de VNet.
Create una conexión de red virtual a red virtual mediante emparejamiento de vNet

Implementación en Azure
Esta plantilla le permite conectar dos redes virtuales mediante emparejamiento de vNet.

Definición de recursos de plantilla de ARM

El tipo de recurso virtualNetworks/virtualNetworkPeerings se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, agregue el siguiente código JSON a la plantilla.

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

virtualNetworks/virtualNetworkPeerings

Nombre Descripción Value
type Tipo de recurso "Microsoft.Network/virtualNetworks/virtualNetworkPeerings"
apiVersion La versión de la API de recursos '2023-04-01'
name El nombre del recurso

Consulte cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json.
string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
properties Propiedades del emparejamiento de redes virtuales. VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Nombre Descripción Valor
allowForwardedTraffic Si se permitirá o no el tráfico reenviado desde las máquinas virtuales de la red virtual local en la red virtual remota. bool
allowGatewayTransit Si se pueden usar vínculos de puerta de enlace en redes virtuales remotas para vincular a esta red virtual. bool
allowVirtualNetworkAccess Si las máquinas virtuales del espacio de red virtual local podrían acceder a las máquinas virtuales en el espacio de red virtual remoto. bool
doNotVerifyRemoteGateways Si es necesario comprobar el estado de aprovisionamiento de la puerta de enlace remota. bool
peeringState Estado del emparejamiento de red virtual. "Conectado"
'Desconectado'
'Iniciado'
peeringSyncLevel Estado de sincronización de emparejamiento del emparejamiento de la red virtual. 'FullyInSync'
'LocalAndRemoteNotInSync'
'LocalNotInSync'
'RemoteNotInSync'
remoteAddressSpace Referencia al espacio de direcciones emparejado con la red virtual remota. AddressSpace
remoteBgpCommunities Referencia a las comunidades Bgp de la red virtual remota. VirtualNetworkBgpCommunities
remoteVirtualNetwork Referencia a la red virtual remota. La red virtual remota puede estar en la misma región o en otra (versión preliminar). Consulte aquí para registrarse en la versión preliminar y obtener más información (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referencia al espacio de direcciones actual de la red virtual remota. AddressSpace
useRemoteGateways Si se pueden usar puertas de enlace remotas en esta red virtual. Si la marca se establece en true y allowGatewayTransit en el emparejamiento remoto también es true, la red virtual usará puertas de enlace de red virtual remota para el tránsito. Solo un emparejamiento puede tener esta marca establecida en true. Esta marca no se puede establecer si la red virtual ya tiene una puerta de enlace. bool

AddressSpace

Nombre Descripción Valor
addressPrefixes Lista de bloques de direcciones reservados para esta red virtual en notación CIDR. string[]

VirtualNetworkBgpCommunities

Nombre Descripción Valor
virtualNetworkCommunity Comunidad BGP asociada a la red virtual. string (obligatorio)

SubResource

Nombre Descripción Value
id Identificador del recurso. string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Implementación de un espacio aislado de topología en estrella tipo hub-and-spoke

Implementación en Azure
Esta plantilla crea una configuración básica de topología en estrella tipo hub-and-spoke. Crea una red virtual de concentrador con subredes DMZ, administración, compartido y puerta de enlace (opcionalmente), con dos redes virtuales radiales (desarrollo y producción) que contienen una subred de carga de trabajo cada una. También implementa una Jump-Host de Windows en la subred De administración del CONCENTRADOR y establece emparejamientos de red virtual entre el centro y los dos radios.
Load Balancer pública encadenada a un Load Balancer de puerta de enlace

Implementación en Azure
Esta plantilla permite implementar una Standard Load Balancer pública encadenada a un Load Balancer de puerta de enlace. El tráfico entrante desde Internet se enruta a la puerta de enlace Load Balancer con máquinas virtuales Linux (NVA) en el grupo de back-end.
Implementación de la replicación de HBase con dos redes virtuales en una región

Implementación en Azure
Esta plantilla permite configurar un entorno de HBase de red con dos clústeres de HBase dentro de dos redes virtuales en la misma región para configurar la replicación de HBase.
Uso de Azure Firewall como proxy DNS en una topología de radio de & concentrador

Implementación en Azure
En este ejemplo se muestra cómo implementar una topología en estrella tipo hub-and-spoke en Azure mediante el Azure Firewall. La red virtual del concentrador actúa como un punto central de conectividad a muchas redes virtuales de radio que están conectadas a la red virtual del concentrador a través del emparejamiento de redes virtuales.
Create un espacio aislado de Azure Firewall con tunelización forzada

Implementación en Azure
Esta plantilla crea un espacio aislado de Azure Firewall (Linux) con una fuerza de firewall tunelizado a través de otro firewall en una red virtual emparejada.
Implementación de un host de Bastion en un centro de conectividad Virtual Network

Implementación en Azure
Esta plantilla crea dos redes virtuales con emparejamientos, un host de Bastion en la red virtual de concentrador y una máquina virtual Linux en la red virtual radial.
Emparejar dos redes virtuales existentes dentro de una sola región

Implementación en Azure
Esta plantilla permite conectar dos redes virtuales desde los mismos grupos de recursos o diferentes de la misma región mediante el emparejamiento de VNet.
Create una conexión de red virtual a red virtual mediante emparejamiento de red virtual

Implementación en Azure
Esta plantilla le permite conectar dos redes virtuales mediante el emparejamiento de vNet.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso virtualNetworks/virtualNetworkPeerings se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Network/virtualNetworks/virtualNetworkPeerings, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

virtualNetworks/virtualNetworkPeerings

Nombre Descripción Value
type Tipo de recurso "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-04-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: virtualNetworks
properties Propiedades del emparejamiento de red virtual. VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Nombre Descripción Valor
allowForwardedTraffic Si se permitirá o no el tráfico reenviado desde las máquinas virtuales de la red virtual local en la red virtual remota. bool
allowGatewayTransit Si los vínculos de puerta de enlace se pueden usar en redes virtuales remotas para vincular a esta red virtual. bool
allowVirtualNetworkAccess Si las máquinas virtuales del espacio de red virtual local podrían acceder a las máquinas virtuales en el espacio de red virtual remoto. bool
doNotVerifyRemoteGateways Si es necesario comprobar el estado de aprovisionamiento de la puerta de enlace remota. bool
peeringState Estado del emparejamiento de red virtual. "Conectado"
"Desconectado"
"Iniciado"
peeringSyncLevel Estado de sincronización de emparejamiento del emparejamiento de la red virtual. "FullyInSync"
"LocalAndRemoteNotInSync"
"LocalNotInSync"
"RemoteNotInSync"
remoteAddressSpace Referencia al espacio de direcciones emparejado con la red virtual remota. AddressSpace
remoteBgpCommunities Referencia a las comunidades Bgp de la red virtual remota. VirtualNetworkBgpCommunities
remoteVirtualNetwork Referencia a la red virtual remota. La red virtual remota puede estar en la misma región o en otra (versión preliminar). Consulte aquí para registrarse en la versión preliminar y obtener más información (/azure/virtual-network/virtual-network-create-peering). SubResource
remoteVirtualNetworkAddressSpace Referencia al espacio de direcciones actual de la red virtual remota. AddressSpace
useRemoteGateways Si se pueden usar puertas de enlace remotas en esta red virtual. Si la marca se establece en true y allowGatewayTransit en el emparejamiento remoto también es true, la red virtual usará puertas de enlace de red virtual remota para el tránsito. Solo un emparejamiento puede tener esta marca establecida en true. Esta marca no se puede establecer si la red virtual ya tiene una puerta de enlace. bool

AddressSpace

Nombre Descripción Valor
addressPrefixes Lista de bloques de direcciones reservados para esta red virtual en notación CIDR. string[]

VirtualNetworkBgpCommunities

Nombre Descripción Valor
virtualNetworkCommunity Comunidad BGP asociada a la red virtual. string (obligatorio)

SubResource

Nombre Descripción Value
id Identificador del recurso. string