다음을 통해 공유


Microsoft.Network 익스프레스라우트게이트웨이

Bicep 리소스 정의

expressRouteGateways 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/expressRouteGateways 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Network/expressRouteGateways@2025-03-01' = {
  scope: resourceSymbolicName or scope
  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'
  }
}

속성 값

Microsoft.Network/expressRouteGateways

이름 묘사
위치 리소스 위치입니다. 문자열
이름 리소스 이름 string(필수)
속성 Express 경로 게이트웨이의 속성입니다. expressRouteGatewayProperties
scope 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 이 속성을 리소스의 기호 이름으로 설정하여 확장 리소스를 적용합니다.
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

ExpressRouteCircuitPeeringId

이름 묘사
아이디 ExpressRoute 회로 피어링의 ID입니다. 문자열

ExpressRouteConnection

이름 묘사
아이디 리소스 ID입니다. 문자열
이름 리소스의 이름입니다. string(필수)
속성 Express 경로 연결의 속성입니다. expressRouteConnectionProperties

ExpressRouteConnectionProperties

이름 묘사
권한 부여 키 연결을 설정하는 권한 부여 키입니다. 문자열
인터넷 보안 활성화 인터넷 보안을 사용하도록 설정합니다. 부울
enablePrivateLinkFastPath 프라이빗 링크에 액세스할 때 ExpressRoute 게이트웨이를 무시합니다. ExpressRoute FastPath(expressRouteGatewayBypass)를 사용하도록 설정해야 합니다. 부울
expressRouteCircuit피어링 ExpressRoute 회로 피어링입니다. ExpressRouteCircuitPeeringId(필수)
익스프레스라우트게이트웨이우회 vWan 방화벽 허브에 FastPath를 사용하도록 설정합니다. 부울
routingConfiguration 이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. 라우팅 구성
routingWeight 연결에 연결된 라우팅 가중치입니다. 정수 (int)

ExpressRouteGateway속성

이름 묘사
allowNonVirtualWanTraffic 가상 WAN이 아닌 네트워크의 트래픽을 허용하도록 이 게이트웨이를 구성합니다. 부울
자동 확장 구성 자동 크기 조정을 위한 구성입니다. ExpressRouteGatewayPropertiesAutoScaleConfiguration
익스프레스라우트커넥션(expressRouteConnections) ExpressRoute 게이트웨이에 대한 ExpressRoute 연결 목록입니다. expressRouteConnection[]
버추얼 허브 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브입니다. VirtualHubId(필수)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

이름 묘사
범위 배포할 최소 및 최대 배율 단위 수입니다. expressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

이름 묘사
최대 ExpressRoute 게이트웨이에 배포된 최대 배율 단위 수입니다. 정수 (int)
ExpressRoute 게이트웨이에 배포된 최소 배율 단위 수입니다. 정수 (int)

전파된 경로 테이블

이름 묘사
아이디 모든 RouteTable의 리소스 ID 목록입니다. 하위 리소스[]
레이블 레이블 목록입니다. 문자열[]

리소스태그

이름 묘사

라우팅 구성

이름 묘사
associatedRouteTable 이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다. 하위 리소스
인바운드 경로 지도 인바운드 학습 경로에 대한 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다. 하위 리소스
outboundRouteMap 아웃바운드 보급 경로에 대해 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다. 하위 리소스
propagatedRouteTables (전파된 경로 테이블) 경로를 보급할 RouteTable 목록입니다. 전파된 경로 테이블
vnet경로 VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다. VnetRoute

정적 경로

이름 묘사
address접두사 모든 주소 접두사 목록입니다. 문자열[]
이름 VnetRoute 내에서 고유한 StaticRoute의 이름입니다. 문자열
다음HopIpAddress 다음 홉의 IP 주소입니다. 문자열

정적 경로 구성

이름 묘사
vnetLocalRouteOverrideCriteria 스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다. '포함하다'
'평등'

하위 리소스

이름 묘사
아이디 리소스 ID입니다. 문자열

가상 허브 ID

이름 묘사
아이디 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브에 대한 리소스 URI입니다. 가상 허브 리소스와 ExpressRoute 게이트웨이 리소스는 동일한 구독에 상주합니다. 문자열

VnetRoute

이름 묘사
staticRoutes 모든 정적 경로 목록입니다. 스태틱 루트[]
staticRoutesConfig 이 HubVnetConnection의 정적 경로에 대한 구성입니다. staticRoutesConfig

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
express Route Gateway Express Route Gateway용 AVM 리소스 모듈

ARM 템플릿 리소스 정의

expressRouteGateways 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/expressRouteGateways 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Network/expressRouteGateways",
  "apiVersion": "2025-03-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"
  }
}

속성 값

Microsoft.Network/expressRouteGateways

이름 묘사
API버전 api 버전 '2025-03-01'
위치 리소스 위치입니다. 문자열
이름 리소스 이름 string(필수)
속성 Express 경로 게이트웨이의 속성입니다. expressRouteGatewayProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
리소스 종류 'Microsoft.Network/expressRouteGateways'

ExpressRouteCircuitPeeringId

이름 묘사
아이디 ExpressRoute 회로 피어링의 ID입니다. 문자열

ExpressRouteConnection

이름 묘사
아이디 리소스 ID입니다. 문자열
이름 리소스의 이름입니다. string(필수)
속성 Express 경로 연결의 속성입니다. expressRouteConnectionProperties

ExpressRouteConnectionProperties

이름 묘사
권한 부여 키 연결을 설정하는 권한 부여 키입니다. 문자열
인터넷 보안 활성화 인터넷 보안을 사용하도록 설정합니다. 부울
enablePrivateLinkFastPath 프라이빗 링크에 액세스할 때 ExpressRoute 게이트웨이를 무시합니다. ExpressRoute FastPath(expressRouteGatewayBypass)를 사용하도록 설정해야 합니다. 부울
expressRouteCircuit피어링 ExpressRoute 회로 피어링입니다. ExpressRouteCircuitPeeringId(필수)
익스프레스라우트게이트웨이우회 vWan 방화벽 허브에 FastPath를 사용하도록 설정합니다. 부울
routingConfiguration 이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. 라우팅 구성
routingWeight 연결에 연결된 라우팅 가중치입니다. 정수 (int)

ExpressRouteGateway속성

이름 묘사
allowNonVirtualWanTraffic 가상 WAN이 아닌 네트워크의 트래픽을 허용하도록 이 게이트웨이를 구성합니다. 부울
자동 확장 구성 자동 크기 조정을 위한 구성입니다. ExpressRouteGatewayPropertiesAutoScaleConfiguration
익스프레스라우트커넥션(expressRouteConnections) ExpressRoute 게이트웨이에 대한 ExpressRoute 연결 목록입니다. expressRouteConnection[]
버추얼 허브 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브입니다. VirtualHubId(필수)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

이름 묘사
범위 배포할 최소 및 최대 배율 단위 수입니다. expressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

이름 묘사
최대 ExpressRoute 게이트웨이에 배포된 최대 배율 단위 수입니다. 정수 (int)
ExpressRoute 게이트웨이에 배포된 최소 배율 단위 수입니다. 정수 (int)

전파된 경로 테이블

이름 묘사
아이디 모든 RouteTable의 리소스 ID 목록입니다. 하위 리소스[]
레이블 레이블 목록입니다. 문자열[]

리소스태그

이름 묘사

라우팅 구성

이름 묘사
associatedRouteTable 이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다. 하위 리소스
인바운드 경로 지도 인바운드 학습 경로에 대한 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다. 하위 리소스
outboundRouteMap 아웃바운드 보급 경로에 대해 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다. 하위 리소스
propagatedRouteTables (전파된 경로 테이블) 경로를 보급할 RouteTable 목록입니다. 전파된 경로 테이블
vnet경로 VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다. VnetRoute

정적 경로

이름 묘사
address접두사 모든 주소 접두사 목록입니다. 문자열[]
이름 VnetRoute 내에서 고유한 StaticRoute의 이름입니다. 문자열
다음HopIpAddress 다음 홉의 IP 주소입니다. 문자열

정적 경로 구성

이름 묘사
vnetLocalRouteOverrideCriteria 스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다. '포함하다'
'평등'

하위 리소스

이름 묘사
아이디 리소스 ID입니다. 문자열

가상 허브 ID

이름 묘사
아이디 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브에 대한 리소스 URI입니다. 가상 허브 리소스와 ExpressRoute 게이트웨이 리소스는 동일한 구독에 상주합니다. 문자열

VnetRoute

이름 묘사
staticRoutes 모든 정적 경로 목록입니다. 스태틱 루트[]
staticRoutesConfig 이 HubVnetConnection의 정적 경로에 대한 구성입니다. staticRoutesConfig

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛 묘사
azure Virtual WAN(vWAN) 다중 허브 배포

Azure
배포
이 템플릿을 사용하면 모든 게이트웨이 및 VNET 연결을 포함하여 Azure VWAN(Virtual WAN) 다중 허브 배포를 만들 수 있습니다.
사용자 지정 라우팅 테이블을 사용하여 Azure vWAN 다중 허브 배포

Azure
배포
이 템플릿을 사용하면 모든 게이트웨이 및 VNET 연결을 포함하여 Azure VWAN(Virtual WAN) 다중 허브 배포를 만들고 사용자 지정 라우팅을 위해 경로 테이블을 사용하는 방법을 보여 줄 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

expressRouteGateways 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Network/expressRouteGateways 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/expressRouteGateways@2025-03-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"
      }
    }
  }
}

속성 값

Microsoft.Network/expressRouteGateways

이름 묘사
위치 리소스 위치입니다. 문자열
이름 리소스 이름 string(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
속성 Express 경로 게이트웨이의 속성입니다. expressRouteGatewayProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다.
리소스 종류 "Microsoft.Network/expressRouteGateways@2025-03-01"

ExpressRouteCircuitPeeringId

이름 묘사
아이디 ExpressRoute 회로 피어링의 ID입니다. 문자열

ExpressRouteConnection

이름 묘사
아이디 리소스 ID입니다. 문자열
이름 리소스의 이름입니다. string(필수)
속성 Express 경로 연결의 속성입니다. expressRouteConnectionProperties

ExpressRouteConnectionProperties

이름 묘사
권한 부여 키 연결을 설정하는 권한 부여 키입니다. 문자열
인터넷 보안 활성화 인터넷 보안을 사용하도록 설정합니다. 부울
enablePrivateLinkFastPath 프라이빗 링크에 액세스할 때 ExpressRoute 게이트웨이를 무시합니다. ExpressRoute FastPath(expressRouteGatewayBypass)를 사용하도록 설정해야 합니다. 부울
expressRouteCircuit피어링 ExpressRoute 회로 피어링입니다. ExpressRouteCircuitPeeringId(필수)
익스프레스라우트게이트웨이우회 vWan 방화벽 허브에 FastPath를 사용하도록 설정합니다. 부울
routingConfiguration 이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. 라우팅 구성
routingWeight 연결에 연결된 라우팅 가중치입니다. 정수 (int)

ExpressRouteGateway속성

이름 묘사
allowNonVirtualWanTraffic 가상 WAN이 아닌 네트워크의 트래픽을 허용하도록 이 게이트웨이를 구성합니다. 부울
자동 확장 구성 자동 크기 조정을 위한 구성입니다. ExpressRouteGatewayPropertiesAutoScaleConfiguration
익스프레스라우트커넥션(expressRouteConnections) ExpressRoute 게이트웨이에 대한 ExpressRoute 연결 목록입니다. expressRouteConnection[]
버추얼 허브 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브입니다. VirtualHubId(필수)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

이름 묘사
범위 배포할 최소 및 최대 배율 단위 수입니다. expressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

이름 묘사
최대 ExpressRoute 게이트웨이에 배포된 최대 배율 단위 수입니다. 정수 (int)
ExpressRoute 게이트웨이에 배포된 최소 배율 단위 수입니다. 정수 (int)

전파된 경로 테이블

이름 묘사
아이디 모든 RouteTable의 리소스 ID 목록입니다. 하위 리소스[]
레이블 레이블 목록입니다. 문자열[]

리소스태그

이름 묘사

라우팅 구성

이름 묘사
associatedRouteTable 이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다. 하위 리소스
인바운드 경로 지도 인바운드 학습 경로에 대한 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다. 하위 리소스
outboundRouteMap 아웃바운드 보급 경로에 대해 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다. 하위 리소스
propagatedRouteTables (전파된 경로 테이블) 경로를 보급할 RouteTable 목록입니다. 전파된 경로 테이블
vnet경로 VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다. VnetRoute

정적 경로

이름 묘사
address접두사 모든 주소 접두사 목록입니다. 문자열[]
이름 VnetRoute 내에서 고유한 StaticRoute의 이름입니다. 문자열
다음HopIpAddress 다음 홉의 IP 주소입니다. 문자열

정적 경로 구성

이름 묘사
vnetLocalRouteOverrideCriteria 스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다. '포함하다'
'평등'

하위 리소스

이름 묘사
아이디 리소스 ID입니다. 문자열

가상 허브 ID

이름 묘사
아이디 ExpressRoute 게이트웨이가 배포되거나 배포될 가상 허브에 대한 리소스 URI입니다. 가상 허브 리소스와 ExpressRoute 게이트웨이 리소스는 동일한 구독에 상주합니다. 문자열

VnetRoute

이름 묘사
staticRoutes 모든 정적 경로 목록입니다. 스태틱 루트[]
staticRoutesConfig 이 HubVnetConnection의 정적 경로에 대한 구성입니다. staticRoutesConfig

사용 예제

Terraform 샘플

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    = ["*"]
}