次の方法で共有


Microsoft.Network expressRouteGateways

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 Route ゲートウェイのプロパティ。 ExpressRouteGatewayProperties の
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

ExpressRouteCircuitPeeringId

名前 形容 価値
身分証明書 ExpressRoute 回線ピアリングの ID。 文字列

ExpressRouteConnection

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソースの名前。 string (必須)
プロパティ 高速ルート接続のプロパティ。 ExpressRouteConnectionProperties の

ExpressRouteConnectionプロパティ

名前 形容 価値
authorizationキー 接続を確立するための承認キー。 文字列
enableInternetSecurity (インターネットセキュリティを有効にする) インターネット セキュリティを有効にします。 ブール (bool)
enablePrivateLinkFastPath プライベート リンクにアクセスするときは、ExpressRoute ゲートウェイをバイパスします。 ExpressRoute FastPath (expressRouteGatewayBypass) を有効にする必要があります。 ブール (bool)
expressRouteCircuitPeering (英語) ExpressRoute 回線ピアリング。 ExpressRouteCircuitPeeringId (必須)
expressRouteGatewayバイパス vWan Firewall ハブへの FastPath を有効にします。 ブール (bool)
ルーティング設定 この接続に関連付けられた伝達されたルート テーブルを示すルーティング構成。 ルーティング構成
ルーティングウェイト 接続に関連付けられているルーティングの重み。 整数 (int)

ExpressRouteGatewayプロパティ

名前 形容 価値
allowNonVirtualWanTraffic (英語) 非 Virtual WAN ネットワークからのトラフィックを受け入れるように、このゲートウェイを構成します。 ブール (bool)
自動スケール構成 自動スケーリングの構成。 ExpressRouteGatewayPropertiesAutoScaleConfiguration
expressRouteConnections ExpressRoute ゲートウェイへの ExpressRoute 接続の一覧。 ExpressRouteConnection[]
バーチャルハブ ExpressRoute ゲートウェイがデプロイされる仮想ハブ。 VirtualHubId (必須)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

名前 形容 価値
切り デプロイするスケール ユニットの最小数と最大数。 ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

名前 形容 価値
マックス ExpressRoute ゲートウェイにデプロイされるスケール ユニットの最大数。 整数 (int)
ExpressRoute ゲートウェイ用にデプロイされたスケール ユニットの最小数。 整数 (int)

伝播ルート テーブル

名前 形容 価値
IDSの すべての RouteTable のリソース ID の一覧。 サブリソース[]
ラベル ラベルの一覧。 文字列[]

リソースタグ

名前 形容 価値

ルーティング構成

名前 形容 価値
associatedRouteTable (関連付けルートテーブル) この RoutingConfiguration に関連付けられているリソース ID RouteTable。 SubResource の
インバウンドルートマップ 受信学習ルートのこの RoutingConfiguration に関連付けられている RouteMap のリソース ID。 SubResource の
アウトバウンドルートマップ 送信アドバタイズされたルートのこの RoutingConfiguration に関連付けられているRouteMap のリソース ID。 SubResource の
伝播ルートテーブル ルートをアドバタイズする RouteTable の一覧。 伝達されたRouteTable
vnetルート VirtualHub から仮想ネットワーク接続へのルーティングを制御するルートの一覧。 VnetRoute を する

スタティックルート

名前 形容 価値
addressプレフィックス すべてのアドレス プレフィックスの一覧。 文字列[]
名前 VnetRoute 内で一意である StaticRoute の名前。 文字列
次のHopIpAddress 次ホップの IP アドレス。 文字列

スタティックルートコンフィグ

名前 形容 価値
vnetLocalRouteOverrideCriteria (英語) スポーク vnet 内の NVA が、スポーク内の宛先を持つトラフィックに対してバイパスされるかどうかを決定するパラメーター。 「含む」
「平等」

サブリソース

名前 形容 価値
身分証明書 リソース ID。 文字列

バーチャルハブID

名前 形容 価値
身分証明書 ExpressRoute ゲートウェイがデプロイされる仮想ハブのリソース URI。 仮想ハブ リソースと ExpressRoute ゲートウェイ リソースは、同じサブスクリプションに存在します。 文字列

VnetRoute (英語)

名前 形容 価値
スタティックルート すべての静的ルートの一覧。 スタティックルート[]
静的ルート設定 この HubVnetConnection 上の静的ルートの構成。 StaticRoutesConfig の

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール 形容
Express Route Gateway Express Route ゲートウェイ用の 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

名前 形容 価値
apiVersion (英語) API のバージョン '2025-03-01'
位置 リソースの場所。 文字列
名前 リソース名 string (必須)
プロパティ Express Route ゲートウェイのプロパティ。 ExpressRouteGatewayProperties の
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 'Microsoft.Network/expressRouteGateways'

ExpressRouteCircuitPeeringId

名前 形容 価値
身分証明書 ExpressRoute 回線ピアリングの ID。 文字列

ExpressRouteConnection

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソースの名前。 string (必須)
プロパティ 高速ルート接続のプロパティ。 ExpressRouteConnectionProperties の

ExpressRouteConnectionプロパティ

名前 形容 価値
authorizationキー 接続を確立するための承認キー。 文字列
enableInternetSecurity (インターネットセキュリティを有効にする) インターネット セキュリティを有効にします。 ブール (bool)
enablePrivateLinkFastPath プライベート リンクにアクセスするときは、ExpressRoute ゲートウェイをバイパスします。 ExpressRoute FastPath (expressRouteGatewayBypass) を有効にする必要があります。 ブール (bool)
expressRouteCircuitPeering (英語) ExpressRoute 回線ピアリング。 ExpressRouteCircuitPeeringId (必須)
expressRouteGatewayバイパス vWan Firewall ハブへの FastPath を有効にします。 ブール (bool)
ルーティング設定 この接続に関連付けられた伝達されたルート テーブルを示すルーティング構成。 ルーティング構成
ルーティングウェイト 接続に関連付けられているルーティングの重み。 整数 (int)

ExpressRouteGatewayプロパティ

名前 形容 価値
allowNonVirtualWanTraffic (英語) 非 Virtual WAN ネットワークからのトラフィックを受け入れるように、このゲートウェイを構成します。 ブール (bool)
自動スケール構成 自動スケーリングの構成。 ExpressRouteGatewayPropertiesAutoScaleConfiguration
expressRouteConnections ExpressRoute ゲートウェイへの ExpressRoute 接続の一覧。 ExpressRouteConnection[]
バーチャルハブ ExpressRoute ゲートウェイがデプロイされる仮想ハブ。 VirtualHubId (必須)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

名前 形容 価値
切り デプロイするスケール ユニットの最小数と最大数。 ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

名前 形容 価値
マックス ExpressRoute ゲートウェイにデプロイされるスケール ユニットの最大数。 整数 (int)
ExpressRoute ゲートウェイ用にデプロイされたスケール ユニットの最小数。 整数 (int)

伝播ルート テーブル

名前 形容 価値
IDSの すべての RouteTable のリソース ID の一覧。 サブリソース[]
ラベル ラベルの一覧。 文字列[]

リソースタグ

名前 形容 価値

ルーティング構成

名前 形容 価値
associatedRouteTable (関連付けルートテーブル) この RoutingConfiguration に関連付けられているリソース ID RouteTable。 SubResource の
インバウンドルートマップ 受信学習ルートのこの RoutingConfiguration に関連付けられている RouteMap のリソース ID。 SubResource の
アウトバウンドルートマップ 送信アドバタイズされたルートのこの RoutingConfiguration に関連付けられているRouteMap のリソース ID。 SubResource の
伝播ルートテーブル ルートをアドバタイズする RouteTable の一覧。 伝達されたRouteTable
vnetルート VirtualHub から仮想ネットワーク接続へのルーティングを制御するルートの一覧。 VnetRoute を する

スタティックルート

名前 形容 価値
addressプレフィックス すべてのアドレス プレフィックスの一覧。 文字列[]
名前 VnetRoute 内で一意である StaticRoute の名前。 文字列
次のHopIpAddress 次ホップの IP アドレス。 文字列

スタティックルートコンフィグ

名前 形容 価値
vnetLocalRouteOverrideCriteria (英語) スポーク vnet 内の NVA が、スポーク内の宛先を持つトラフィックに対してバイパスされるかどうかを決定するパラメーター。 「含む」
「平等」

サブリソース

名前 形容 価値
身分証明書 リソース ID。 文字列

バーチャルハブID

名前 形容 価値
身分証明書 ExpressRoute ゲートウェイがデプロイされる仮想ハブのリソース URI。 仮想ハブ リソースと ExpressRoute ゲートウェイ リソースは、同じサブスクリプションに存在します。 文字列

VnetRoute (英語)

名前 形容 価値
スタティックルート すべての静的ルートの一覧。 スタティックルート[]
静的ルート設定 この HubVnetConnection 上の静的ルートの構成。 StaticRoutesConfig の

使用例

Azure クイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート 形容
Azure Virtual WAN (vWAN) マルチハブ デプロイ

Azure にデプロイする
このテンプレートを使用すると、すべてのゲートウェイと VNET 接続を含む Azure Virtual WAN (vWAN) マルチハブ デプロイを作成できます。
カスタム ルーティング テーブル を使用した Azure vWAN マルチハブ デプロイの

Azure
にデプロイする
このテンプレートを使用すると、すべてのゲートウェイと VNET 接続を含む Azure Virtual WAN (vWAN) マルチハブ デプロイを作成し、カスタム ルーティングのルート テーブルの使用方法を示すことができます。

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 Route ゲートウェイのプロパティ。 ExpressRouteGatewayProperties の
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 「Microsoft.Network/expressRouteGateways@2025-03-01」

ExpressRouteCircuitPeeringId

名前 形容 価値
身分証明書 ExpressRoute 回線ピアリングの ID。 文字列

ExpressRouteConnection

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソースの名前。 string (必須)
プロパティ 高速ルート接続のプロパティ。 ExpressRouteConnectionProperties の

ExpressRouteConnectionプロパティ

名前 形容 価値
authorizationキー 接続を確立するための承認キー。 文字列
enableInternetSecurity (インターネットセキュリティを有効にする) インターネット セキュリティを有効にします。 ブール (bool)
enablePrivateLinkFastPath プライベート リンクにアクセスするときは、ExpressRoute ゲートウェイをバイパスします。 ExpressRoute FastPath (expressRouteGatewayBypass) を有効にする必要があります。 ブール (bool)
expressRouteCircuitPeering (英語) ExpressRoute 回線ピアリング。 ExpressRouteCircuitPeeringId (必須)
expressRouteGatewayバイパス vWan Firewall ハブへの FastPath を有効にします。 ブール (bool)
ルーティング設定 この接続に関連付けられた伝達されたルート テーブルを示すルーティング構成。 ルーティング構成
ルーティングウェイト 接続に関連付けられているルーティングの重み。 整数 (int)

ExpressRouteGatewayプロパティ

名前 形容 価値
allowNonVirtualWanTraffic (英語) 非 Virtual WAN ネットワークからのトラフィックを受け入れるように、このゲートウェイを構成します。 ブール (bool)
自動スケール構成 自動スケーリングの構成。 ExpressRouteGatewayPropertiesAutoScaleConfiguration
expressRouteConnections ExpressRoute ゲートウェイへの ExpressRoute 接続の一覧。 ExpressRouteConnection[]
バーチャルハブ ExpressRoute ゲートウェイがデプロイされる仮想ハブ。 VirtualHubId (必須)

ExpressRouteGatewayPropertiesAutoScaleConfiguration

名前 形容 価値
切り デプロイするスケール ユニットの最小数と最大数。 ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

ExpressRouteGatewayPropertiesAutoScaleConfigurationBounds

名前 形容 価値
マックス ExpressRoute ゲートウェイにデプロイされるスケール ユニットの最大数。 整数 (int)
ExpressRoute ゲートウェイ用にデプロイされたスケール ユニットの最小数。 整数 (int)

伝播ルート テーブル

名前 形容 価値
IDSの すべての RouteTable のリソース ID の一覧。 サブリソース[]
ラベル ラベルの一覧。 文字列[]

リソースタグ

名前 形容 価値

ルーティング構成

名前 形容 価値
associatedRouteTable (関連付けルートテーブル) この RoutingConfiguration に関連付けられているリソース ID RouteTable。 SubResource の
インバウンドルートマップ 受信学習ルートのこの RoutingConfiguration に関連付けられている RouteMap のリソース ID。 SubResource の
アウトバウンドルートマップ 送信アドバタイズされたルートのこの RoutingConfiguration に関連付けられているRouteMap のリソース ID。 SubResource の
伝播ルートテーブル ルートをアドバタイズする RouteTable の一覧。 伝達されたRouteTable
vnetルート VirtualHub から仮想ネットワーク接続へのルーティングを制御するルートの一覧。 VnetRoute を する

スタティックルート

名前 形容 価値
addressプレフィックス すべてのアドレス プレフィックスの一覧。 文字列[]
名前 VnetRoute 内で一意である StaticRoute の名前。 文字列
次のHopIpAddress 次ホップの IP アドレス。 文字列

スタティックルートコンフィグ

名前 形容 価値
vnetLocalRouteOverrideCriteria (英語) スポーク vnet 内の NVA が、スポーク内の宛先を持つトラフィックに対してバイパスされるかどうかを決定するパラメーター。 「含む」
「平等」

サブリソース

名前 形容 価値
身分証明書 リソース ID。 文字列

バーチャルハブID

名前 形容 価値
身分証明書 ExpressRoute ゲートウェイがデプロイされる仮想ハブのリソース URI。 仮想ハブ リソースと ExpressRoute ゲートウェイ リソースは、同じサブスクリプションに存在します。 文字列

VnetRoute (英語)

名前 形容 価値
スタティックルート すべての静的ルートの一覧。 スタティックルート[]
静的ルート設定 この 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    = ["*"]
}