Definición de recursos de Bicep
El tipo de recurso expressRouteGateways 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.
Para crear un recurso Microsoft.Network/expressRouteGateways, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Network/expressRouteGateways@2025-05-01' = {
location: 'string'
name: 'string'
properties: {
allowNonVirtualWanTraffic: bool
autoScaleConfiguration: {
bounds: {
max: int
min: int
}
}
expressRouteConnections: [
{
id: 'string'
name: 'string'
properties: {
authorizationKey: 'string'
enableInternetSecurity: bool
enablePrivateLinkFastPath: bool
expressRouteCircuitPeering: {
id: 'string'
}
expressRouteGatewayBypass: bool
routingConfiguration: {
associatedRouteTable: {
id: 'string'
}
inboundRouteMap: {
id: 'string'
}
outboundRouteMap: {
id: 'string'
}
propagatedRouteTables: {
ids: [
{
id: 'string'
}
]
labels: [
'string'
]
}
vnetRoutes: {
staticRoutes: [
{
addressPrefixes: [
'string'
]
name: 'string'
nextHopIpAddress: 'string'
}
]
staticRoutesConfig: {
vnetLocalRouteOverrideCriteria: 'string'
}
}
}
routingWeight: int
}
}
]
virtualHub: {
id: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Valores de propiedad
Microsoft.Network/expressRouteGateways
| Nombre |
Descripción |
Valor |
| ubicación |
Ubicación del recurso. |
cuerda |
| nombre |
El nombre del recurso |
string (obligatorio) |
| Propiedades |
Propiedades de la puerta de enlace de ExpressRoute. |
ExpressRouteGatewayProperties |
| Etiquetas |
Etiquetas de recursos |
Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
ExpressRouteCircuitPeeringId
| Nombre |
Descripción |
Valor |
| identificación |
Identificador del emparejamiento de circuitos ExpressRoute. |
cuerda |
ExpressRouteConnection
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
| nombre |
Nombre del recurso. |
string (obligatorio) |
| Propiedades |
Propiedades de la conexión de expressroute. |
ExpressRouteConnectionProperties |
ExpressRouteConnectionProperties
| Nombre |
Descripción |
Valor |
| authorizationKey |
Clave de autorización para establecer la conexión. |
cuerda |
| enable InternetSecurity |
Habilite la seguridad de Internet. |
Bool |
| enablePrivateLinkFastPath |
Omita la puerta de enlace de ExpressRoute al acceder a vínculos privados. FastPath de ExpressRoute (expressRouteGatewayBypass) debe estar habilitado. |
Bool |
| expressRouteCircuitPeering |
Emparejamiento de circuitos ExpressRoute. |
ExpressRouteCircuitPeeringId (obligatorio) |
| expressRouteGatewayBypass |
Habilite FastPath en el centro de firewall de vWan. |
Bool |
| routeConfiguration |
Configuración de enrutamiento que indica las tablas de rutas asociadas y propagadas en esta conexión. |
RoutingConfiguration |
| routingWeight |
Peso de enrutamiento asociado a la conexión. |
Int |
ExpressRouteGatewayProperties
| Nombre |
Descripción |
Valor |
| allowNonVirtualWanTraffic |
Configura esta puerta de enlace para aceptar el tráfico de redes que no son de Virtual WAN. |
Bool |
| autoScaleConfiguration |
Configuración para el escalado automático. |
ExpressRouteGatewayPropertiesAutoScaleConfiguration |
| expressRouteConnections |
Lista de conexiones de ExpressRoute a la puerta de enlace de ExpressRoute. |
expressRouteConnection [] |
| virtualHub |
Centro virtual donde está o se implementará la puerta de enlace de ExpressRoute. |
VirtualHubId (obligatorio) |
ExpressRouteGatewayPropertiesAutoScaleConfiguration
ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds
| Nombre |
Descripción |
Valor |
| máximo |
Número máximo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
| min |
Número mínimo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
PropagatedRouteTable
| Nombre |
Descripción |
Valor |
| Identificadores |
Lista de identificadores de recursos de todas las RouteTables. |
subrecurso[] |
| Etiquetas |
Lista de etiquetas. |
cadena[] |
Configuración de enrutamiento
| Nombre |
Descripción |
Valor |
| associatedRouteTable |
El identificador de recurso RouteTable asociado a este RoutingConfiguration. |
SubResource |
| inboundRouteMap |
El identificador de recurso del objeto RouteMap asociado a este Objeto RoutingConfiguration para las rutas aprendidas de entrada. |
SubResource |
| outboundRouteMap |
El identificador de recurso derouteMap asociado a este routingConfiguration para las rutas anunciadas salientes. |
SubResource |
| propagatedRouteTables |
Lista de RouteTables a las que anunciar las rutas. |
PropagatedRouteTable |
| vnetRoutes |
Lista de rutas que controlan el enrutamiento desde VirtualHub a una conexión de red virtual. |
VnetRoute de |
Ruta estática
| Nombre |
Descripción |
Valor |
| addressPrefixes |
Lista de todos los prefijos de dirección. |
cadena[] |
| nombre |
Nombre de StaticRoute que es único dentro de una instancia de VnetRoute. |
cuerda |
| nextHopIpAddress |
Dirección IP del próximo salto. |
cuerda |
StaticRoutesConfig
| Nombre |
Descripción |
Valor |
| vnetLocalRouteOverrideCriteria |
Parámetro que determina si se omite la NVA en la red virtual de radio para el tráfico con destino en radio. |
'Contiene' 'Igual' |
Subrecurso
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
VirtualHubId
| Nombre |
Descripción |
Valor |
| identificación |
El URI de recurso del centro virtual donde se va a implementar o la puerta de enlace de ExpressRoute. El recurso del centro virtual y el recurso de puerta de enlace de ExpressRoute residen en la misma suscripción. |
cuerda |
VnetRoute
| Nombre |
Descripción |
Valor |
| staticRoutes |
Lista de todas las rutas estáticas. |
StaticRoute [] |
| staticRoutesConfig |
Configuración de rutas estáticas en este HubVnetConnection. |
StaticRoutesConfig |
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Módulo |
Descripción |
|
de puerta de enlace de ExpressRoute |
Módulo de recursos de AVM para Express Route Gateway |
Definición de recursos de plantilla de ARM
El tipo de recurso expressRouteGateways 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.
Para crear un recurso Microsoft.Network/expressRouteGateways, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.Network/expressRouteGateways",
"apiVersion": "2025-05-01",
"name": "string",
"location": "string",
"properties": {
"allowNonVirtualWanTraffic": "bool",
"autoScaleConfiguration": {
"bounds": {
"max": "int",
"min": "int"
}
},
"expressRouteConnections": [
{
"id": "string",
"name": "string",
"properties": {
"authorizationKey": "string",
"enableInternetSecurity": "bool",
"enablePrivateLinkFastPath": "bool",
"expressRouteCircuitPeering": {
"id": "string"
},
"expressRouteGatewayBypass": "bool",
"routingConfiguration": {
"associatedRouteTable": {
"id": "string"
},
"inboundRouteMap": {
"id": "string"
},
"outboundRouteMap": {
"id": "string"
},
"propagatedRouteTables": {
"ids": [
{
"id": "string"
}
],
"labels": [ "string" ]
},
"vnetRoutes": {
"staticRoutes": [
{
"addressPrefixes": [ "string" ],
"name": "string",
"nextHopIpAddress": "string"
}
],
"staticRoutesConfig": {
"vnetLocalRouteOverrideCriteria": "string"
}
}
},
"routingWeight": "int"
}
}
],
"virtualHub": {
"id": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Valores de propiedad
Microsoft.Network/expressRouteGateways
| Nombre |
Descripción |
Valor |
| apiVersion |
La versión de api |
'2025-05-01' |
| ubicación |
Ubicación del recurso. |
cuerda |
| nombre |
El nombre del recurso |
string (obligatorio) |
| Propiedades |
Propiedades de la puerta de enlace de ExpressRoute. |
ExpressRouteGatewayProperties |
| Etiquetas |
Etiquetas de recursos |
Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| tipo |
El tipo de recurso |
'Microsoft.Network/expressRouteGateways' |
ExpressRouteCircuitPeeringId
| Nombre |
Descripción |
Valor |
| identificación |
Identificador del emparejamiento de circuitos ExpressRoute. |
cuerda |
ExpressRouteConnection
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
| nombre |
Nombre del recurso. |
string (obligatorio) |
| Propiedades |
Propiedades de la conexión de expressroute. |
ExpressRouteConnectionProperties |
ExpressRouteConnectionProperties
| Nombre |
Descripción |
Valor |
| authorizationKey |
Clave de autorización para establecer la conexión. |
cuerda |
| enable InternetSecurity |
Habilite la seguridad de Internet. |
Bool |
| enablePrivateLinkFastPath |
Omita la puerta de enlace de ExpressRoute al acceder a vínculos privados. FastPath de ExpressRoute (expressRouteGatewayBypass) debe estar habilitado. |
Bool |
| expressRouteCircuitPeering |
Emparejamiento de circuitos ExpressRoute. |
ExpressRouteCircuitPeeringId (obligatorio) |
| expressRouteGatewayBypass |
Habilite FastPath en el centro de firewall de vWan. |
Bool |
| routeConfiguration |
Configuración de enrutamiento que indica las tablas de rutas asociadas y propagadas en esta conexión. |
RoutingConfiguration |
| routingWeight |
Peso de enrutamiento asociado a la conexión. |
Int |
ExpressRouteGatewayProperties
| Nombre |
Descripción |
Valor |
| allowNonVirtualWanTraffic |
Configura esta puerta de enlace para aceptar el tráfico de redes que no son de Virtual WAN. |
Bool |
| autoScaleConfiguration |
Configuración para el escalado automático. |
ExpressRouteGatewayPropertiesAutoScaleConfiguration |
| expressRouteConnections |
Lista de conexiones de ExpressRoute a la puerta de enlace de ExpressRoute. |
expressRouteConnection [] |
| virtualHub |
Centro virtual donde está o se implementará la puerta de enlace de ExpressRoute. |
VirtualHubId (obligatorio) |
ExpressRouteGatewayPropertiesAutoScaleConfiguration
ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds
| Nombre |
Descripción |
Valor |
| máximo |
Número máximo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
| min |
Número mínimo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
PropagatedRouteTable
| Nombre |
Descripción |
Valor |
| Identificadores |
Lista de identificadores de recursos de todas las RouteTables. |
subrecurso[] |
| Etiquetas |
Lista de etiquetas. |
cadena[] |
Configuración de enrutamiento
| Nombre |
Descripción |
Valor |
| associatedRouteTable |
El identificador de recurso RouteTable asociado a este RoutingConfiguration. |
SubResource |
| inboundRouteMap |
El identificador de recurso del objeto RouteMap asociado a este Objeto RoutingConfiguration para las rutas aprendidas de entrada. |
SubResource |
| outboundRouteMap |
El identificador de recurso derouteMap asociado a este routingConfiguration para las rutas anunciadas salientes. |
SubResource |
| propagatedRouteTables |
Lista de RouteTables a las que anunciar las rutas. |
PropagatedRouteTable |
| vnetRoutes |
Lista de rutas que controlan el enrutamiento desde VirtualHub a una conexión de red virtual. |
VnetRoute de |
Ruta estática
| Nombre |
Descripción |
Valor |
| addressPrefixes |
Lista de todos los prefijos de dirección. |
cadena[] |
| nombre |
Nombre de StaticRoute que es único dentro de una instancia de VnetRoute. |
cuerda |
| nextHopIpAddress |
Dirección IP del próximo salto. |
cuerda |
StaticRoutesConfig
| Nombre |
Descripción |
Valor |
| vnetLocalRouteOverrideCriteria |
Parámetro que determina si se omite la NVA en la red virtual de radio para el tráfico con destino en radio. |
'Contiene' 'Igual' |
Subrecurso
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
VirtualHubId
| Nombre |
Descripción |
Valor |
| identificación |
El URI de recurso del centro virtual donde se va a implementar o la puerta de enlace de ExpressRoute. El recurso del centro virtual y el recurso de puerta de enlace de ExpressRoute residen en la misma suscripción. |
cuerda |
VnetRoute
| Nombre |
Descripción |
Valor |
| staticRoutes |
Lista de todas las rutas estáticas. |
StaticRoute [] |
| staticRoutesConfig |
Configuración de rutas estáticas en este HubVnetConnection. |
StaticRoutesConfig |
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
El tipo de recurso expressRouteGateways 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.
Para crear un recurso Microsoft.Network/expressRouteGateways, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/expressRouteGateways@2025-05-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
allowNonVirtualWanTraffic = bool
autoScaleConfiguration = {
bounds = {
max = int
min = int
}
}
expressRouteConnections = [
{
id = "string"
name = "string"
properties = {
authorizationKey = "string"
enableInternetSecurity = bool
enablePrivateLinkFastPath = bool
expressRouteCircuitPeering = {
id = "string"
}
expressRouteGatewayBypass = bool
routingConfiguration = {
associatedRouteTable = {
id = "string"
}
inboundRouteMap = {
id = "string"
}
outboundRouteMap = {
id = "string"
}
propagatedRouteTables = {
ids = [
{
id = "string"
}
]
labels = [
"string"
]
}
vnetRoutes = {
staticRoutes = [
{
addressPrefixes = [
"string"
]
name = "string"
nextHopIpAddress = "string"
}
]
staticRoutesConfig = {
vnetLocalRouteOverrideCriteria = "string"
}
}
}
routingWeight = int
}
}
]
virtualHub = {
id = "string"
}
}
}
}
Valores de propiedad
Microsoft.Network/expressRouteGateways
| Nombre |
Descripción |
Valor |
| ubicación |
Ubicación del recurso. |
cuerda |
| nombre |
El nombre del recurso |
string (obligatorio) |
| Propiedades |
Propiedades de la puerta de enlace de ExpressRoute. |
ExpressRouteGatewayProperties |
| Etiquetas |
Etiquetas de recursos |
Diccionario de nombres y valores de etiqueta. |
| tipo |
El tipo de recurso |
"Microsoft.Network/expressRouteGateways@2025-05-01" |
ExpressRouteCircuitPeeringId
| Nombre |
Descripción |
Valor |
| identificación |
Identificador del emparejamiento de circuitos ExpressRoute. |
cuerda |
ExpressRouteConnection
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
| nombre |
Nombre del recurso. |
string (obligatorio) |
| Propiedades |
Propiedades de la conexión de expressroute. |
ExpressRouteConnectionProperties |
ExpressRouteConnectionProperties
| Nombre |
Descripción |
Valor |
| authorizationKey |
Clave de autorización para establecer la conexión. |
cuerda |
| enable InternetSecurity |
Habilite la seguridad de Internet. |
Bool |
| enablePrivateLinkFastPath |
Omita la puerta de enlace de ExpressRoute al acceder a vínculos privados. FastPath de ExpressRoute (expressRouteGatewayBypass) debe estar habilitado. |
Bool |
| expressRouteCircuitPeering |
Emparejamiento de circuitos ExpressRoute. |
ExpressRouteCircuitPeeringId (obligatorio) |
| expressRouteGatewayBypass |
Habilite FastPath en el centro de firewall de vWan. |
Bool |
| routeConfiguration |
Configuración de enrutamiento que indica las tablas de rutas asociadas y propagadas en esta conexión. |
RoutingConfiguration |
| routingWeight |
Peso de enrutamiento asociado a la conexión. |
Int |
ExpressRouteGatewayProperties
| Nombre |
Descripción |
Valor |
| allowNonVirtualWanTraffic |
Configura esta puerta de enlace para aceptar el tráfico de redes que no son de Virtual WAN. |
Bool |
| autoScaleConfiguration |
Configuración para el escalado automático. |
ExpressRouteGatewayPropertiesAutoScaleConfiguration |
| expressRouteConnections |
Lista de conexiones de ExpressRoute a la puerta de enlace de ExpressRoute. |
expressRouteConnection [] |
| virtualHub |
Centro virtual donde está o se implementará la puerta de enlace de ExpressRoute. |
VirtualHubId (obligatorio) |
ExpressRouteGatewayPropertiesAutoScaleConfiguration
ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds
| Nombre |
Descripción |
Valor |
| máximo |
Número máximo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
| min |
Número mínimo de unidades de escalado implementadas para la puerta de enlace de ExpressRoute. |
Int |
PropagatedRouteTable
| Nombre |
Descripción |
Valor |
| Identificadores |
Lista de identificadores de recursos de todas las RouteTables. |
subrecurso[] |
| Etiquetas |
Lista de etiquetas. |
cadena[] |
Configuración de enrutamiento
| Nombre |
Descripción |
Valor |
| associatedRouteTable |
El identificador de recurso RouteTable asociado a este RoutingConfiguration. |
SubResource |
| inboundRouteMap |
El identificador de recurso del objeto RouteMap asociado a este Objeto RoutingConfiguration para las rutas aprendidas de entrada. |
SubResource |
| outboundRouteMap |
El identificador de recurso derouteMap asociado a este routingConfiguration para las rutas anunciadas salientes. |
SubResource |
| propagatedRouteTables |
Lista de RouteTables a las que anunciar las rutas. |
PropagatedRouteTable |
| vnetRoutes |
Lista de rutas que controlan el enrutamiento desde VirtualHub a una conexión de red virtual. |
VnetRoute de |
Ruta estática
| Nombre |
Descripción |
Valor |
| addressPrefixes |
Lista de todos los prefijos de dirección. |
cadena[] |
| nombre |
Nombre de StaticRoute que es único dentro de una instancia de VnetRoute. |
cuerda |
| nextHopIpAddress |
Dirección IP del próximo salto. |
cuerda |
StaticRoutesConfig
| Nombre |
Descripción |
Valor |
| vnetLocalRouteOverrideCriteria |
Parámetro que determina si se omite la NVA en la red virtual de radio para el tráfico con destino en radio. |
'Contiene' 'Igual' |
Subrecurso
| Nombre |
Descripción |
Valor |
| identificación |
Identificador de recurso. |
cuerda |
VirtualHubId
| Nombre |
Descripción |
Valor |
| identificación |
El URI de recurso del centro virtual donde se va a implementar o la puerta de enlace de ExpressRoute. El recurso del centro virtual y el recurso de puerta de enlace de ExpressRoute residen en la misma suscripción. |
cuerda |
VnetRoute
| Nombre |
Descripción |
Valor |
| staticRoutes |
Lista de todas las rutas estáticas. |
StaticRoute [] |
| staticRoutesConfig |
Configuración de rutas estáticas en este HubVnetConnection. |
StaticRoutesConfig |
Ejemplos de uso
Un ejemplo básico de implementación de la puerta de enlace de ExpressRoute.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "virtualWan" {
type = "Microsoft.Network/virtualWans@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
allowBranchToBranchTraffic = true
disableVpnEncryption = false
office365LocalBreakoutCategory = "None"
type = "Standard"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "virtualHub" {
type = "Microsoft.Network/virtualHubs@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
addressPrefix = "10.0.1.0/24"
hubRoutingPreference = "ExpressRoute"
virtualRouterAutoScaleConfiguration = {
minCapacity = 2
}
virtualWan = {
id = azapi_resource.virtualWan.id
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "expressRouteGateway" {
type = "Microsoft.Network/expressRouteGateways@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
allowNonVirtualWanTraffic = false
autoScaleConfiguration = {
bounds = {
min = 1
}
}
virtualHub = {
id = azapi_resource.virtualHub.id
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}