次の方法で共有


Microsoft.Network 仮想ハブ

Bicep リソース定義

virtualHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/virtualHubs リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Network/virtualHubs@2025-03-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    addressPrefix: 'string'
    allowBranchToBranchTraffic: bool
    azureFirewall: {
      id: 'string'
    }
    expressRouteGateway: {
      id: 'string'
    }
    hubRoutingPreference: 'string'
    p2SVpnGateway: {
      id: 'string'
    }
    preferredRoutingGateway: 'string'
    routeTable: {
      routes: [
        {
          addressPrefixes: [
            'string'
          ]
          nextHopIpAddress: 'string'
        }
      ]
    }
    securityPartnerProvider: {
      id: 'string'
    }
    securityProviderName: 'string'
    sku: 'string'
    virtualHubRouteTableV2s: [
      {
        id: 'string'
        name: 'string'
        properties: {
          attachedConnections: [
            'string'
          ]
          routes: [
            {
              destinations: [
                'string'
              ]
              destinationType: 'string'
              nextHops: [
                'string'
              ]
              nextHopType: 'string'
            }
          ]
        }
      }
    ]
    virtualRouterAsn: int
    virtualRouterAutoScaleConfiguration: {
      minCapacity: int
    }
    virtualRouterIps: [
      'string'
    ]
    virtualWan: {
      id: 'string'
    }
    vpnGateway: {
      id: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

マイクロソフトネットワーク/virtualHubs

名前 形容 価値
位置 リソースの場所。 文字列
名前 リソース名 string (必須)
プロパティ 仮想ハブのプロパティ。 VirtualHubプロパティ
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

リソースタグ

名前 形容 価値

サブリソース

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

VirtualHubプロパティ

名前 形容 価値
アドレスプレフィックス この VirtualHub のアドレス プレフィックス。 文字列
allowBranchToBranchTraffic (ブランチからブランチへのトラフィックを許可する) VirtualRouter ハブの転送を制御するためのフラグ。 ブール (bool)
azureファイアウォール この VirtualHub に関連付けられている azureFirewall。 SubResource の
expressRouteGateway この VirtualHub に関連付けられている expressRouteGateway。 SubResource の
hubRoutingPreference(英語) この VirtualHub の hubRoutingPreference。 「アス」
「エクスプレスルート」
「VpnGateway」
p2SVpnGateway(英語) この VirtualHub に関連付けられている P2SVpnGateway。 SubResource の
preferredルーティングゲートウェイ オンプレミス トラフィックをルーティングするための優先ゲートウェイ 「エクスプレスルート」
「なし」
「VpnGateway」
ルートテーブル この仮想ハブに関連付けられている routeTable。 VirtualHubRouteTable の
セキュリティパートナープロバイダ この VirtualHub に関連付けられている securityPartnerProvider。 SubResource の
セキュリティプロバイダ名 セキュリティ プロバイダー名。 文字列
エスケーユー この VirtualHub の SKU。 文字列
virtualHubRouteTableV2s この VirtualHub に関連付けられているすべての仮想ハブ ルート テーブル v2 の一覧。 VirtualHubルートテーブルV2[]
virtualRouterAsn VirtualRouter ASN。 int

制約:
最小値 = 0
最大値 = 4294967295
virtualRouterAutoScale設定 VirtualHub ルーターの自動スケール構成。 VirtualRouterAutoScaleConfiguration の
仮想ルーターIPS VirtualRouter IP。 文字列[]
バーチャルワン VirtualHub が属する VirtualWAN。 SubResource の
vpnゲートウェイ この VirtualHub に関連付けられている VpnGateway。 SubResource の

VirtualHubルート

名前 形容 価値
addressプレフィックス すべての addressPrefixes の一覧。 文字列[]
次のHopIpAddress NextHop IP アドレス。 文字列

VirtualHubルートテーブル

名前 形容 価値
ルート すべてのルートの一覧。 VirtualHubルート[]

VirtualHubRouteTableV2 (英語)

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソース グループ内で一意であるリソースの名前。 この名前は、リソースへのアクセスに使用できます。 文字列
プロパティ 仮想ハブ ルート テーブル v2 のプロパティ。 VirtualHubRouteTableV2Properties の

VirtualHubRouteTableV2プロパティ

名前 形容 価値
attached接続 このルート テーブル v2 に接続されているすべての接続の一覧。 文字列[]
ルート すべてのルートの一覧。 VirtualHubルートV2[]

バーチャルハブルートV2

名前 形容 価値
目的 地 すべての宛先の一覧。 文字列[]
destinationType(宛先タイプ) 変換先の種類。 文字列
ネクストホップ NextHops IP アドレス。 文字列[]
ネクストホップタイプ 次ホップの種類。 文字列

VirtualRouterAutoScale設定

名前 形容 価値
最小容量 VirtualHub ルーターのスケール ユニットの最小数。 int

制約:
最小値 = 0

使用例

Azure 検証済みモジュール

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

モジュール 形容
仮想ハブ 仮想ハブ用の AVM リソース モジュール

Azure クイック スタートのサンプル

Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル 形容
新しいサブネット にルート サーバーを作成する このテンプレートは、RouteServerSubnet という名前のサブネットにルート サーバーをデプロイします。
Virtual WAN リソースを作成 このテンプレートを使用すると、Virtual WAN、Virtual Hub、VPN Gateway、VPN サイト、VPN Connecton などの仮想 WAN リソースを作成できます。
セキュリティで保護された仮想ハブ を する このテンプレートでは、Azure Firewall を使用してセキュリティで保護された仮想ハブを作成し、インターネット宛てのクラウド ネットワーク トラフィックをセキュリティで保護します。

ARM テンプレート リソース定義

virtualHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/virtualHubs リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Network/virtualHubs",
  "apiVersion": "2025-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "addressPrefix": "string",
    "allowBranchToBranchTraffic": "bool",
    "azureFirewall": {
      "id": "string"
    },
    "expressRouteGateway": {
      "id": "string"
    },
    "hubRoutingPreference": "string",
    "p2SVpnGateway": {
      "id": "string"
    },
    "preferredRoutingGateway": "string",
    "routeTable": {
      "routes": [
        {
          "addressPrefixes": [ "string" ],
          "nextHopIpAddress": "string"
        }
      ]
    },
    "securityPartnerProvider": {
      "id": "string"
    },
    "securityProviderName": "string",
    "sku": "string",
    "virtualHubRouteTableV2s": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "attachedConnections": [ "string" ],
          "routes": [
            {
              "destinations": [ "string" ],
              "destinationType": "string",
              "nextHops": [ "string" ],
              "nextHopType": "string"
            }
          ]
        }
      }
    ],
    "virtualRouterAsn": "int",
    "virtualRouterAutoScaleConfiguration": {
      "minCapacity": "int"
    },
    "virtualRouterIps": [ "string" ],
    "virtualWan": {
      "id": "string"
    },
    "vpnGateway": {
      "id": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

マイクロソフトネットワーク/virtualHubs

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

リソースタグ

名前 形容 価値

サブリソース

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

VirtualHubプロパティ

名前 形容 価値
アドレスプレフィックス この VirtualHub のアドレス プレフィックス。 文字列
allowBranchToBranchTraffic (ブランチからブランチへのトラフィックを許可する) VirtualRouter ハブの転送を制御するためのフラグ。 ブール (bool)
azureファイアウォール この VirtualHub に関連付けられている azureFirewall。 SubResource の
expressRouteGateway この VirtualHub に関連付けられている expressRouteGateway。 SubResource の
hubRoutingPreference(英語) この VirtualHub の hubRoutingPreference。 「アス」
「エクスプレスルート」
「VpnGateway」
p2SVpnGateway(英語) この VirtualHub に関連付けられている P2SVpnGateway。 SubResource の
preferredルーティングゲートウェイ オンプレミス トラフィックをルーティングするための優先ゲートウェイ 「エクスプレスルート」
「なし」
「VpnGateway」
ルートテーブル この仮想ハブに関連付けられている routeTable。 VirtualHubRouteTable の
セキュリティパートナープロバイダ この VirtualHub に関連付けられている securityPartnerProvider。 SubResource の
セキュリティプロバイダ名 セキュリティ プロバイダー名。 文字列
エスケーユー この VirtualHub の SKU。 文字列
virtualHubRouteTableV2s この VirtualHub に関連付けられているすべての仮想ハブ ルート テーブル v2 の一覧。 VirtualHubルートテーブルV2[]
virtualRouterAsn VirtualRouter ASN。 int

制約:
最小値 = 0
最大値 = 4294967295
virtualRouterAutoScale設定 VirtualHub ルーターの自動スケール構成。 VirtualRouterAutoScaleConfiguration の
仮想ルーターIPS VirtualRouter IP。 文字列[]
バーチャルワン VirtualHub が属する VirtualWAN。 SubResource の
vpnゲートウェイ この VirtualHub に関連付けられている VpnGateway。 SubResource の

VirtualHubルート

名前 形容 価値
addressプレフィックス すべての addressPrefixes の一覧。 文字列[]
次のHopIpAddress NextHop IP アドレス。 文字列

VirtualHubルートテーブル

名前 形容 価値
ルート すべてのルートの一覧。 VirtualHubルート[]

VirtualHubRouteTableV2 (英語)

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソース グループ内で一意であるリソースの名前。 この名前は、リソースへのアクセスに使用できます。 文字列
プロパティ 仮想ハブ ルート テーブル v2 のプロパティ。 VirtualHubRouteTableV2Properties の

VirtualHubRouteTableV2プロパティ

名前 形容 価値
attached接続 このルート テーブル v2 に接続されているすべての接続の一覧。 文字列[]
ルート すべてのルートの一覧。 VirtualHubルートV2[]

バーチャルハブルートV2

名前 形容 価値
目的 地 すべての宛先の一覧。 文字列[]
destinationType(宛先タイプ) 変換先の種類。 文字列
ネクストホップ NextHops IP アドレス。 文字列[]
ネクストホップタイプ 次ホップの種類。 文字列

VirtualRouterAutoScale設定

名前 形容 価値
最小容量 VirtualHub ルーターのスケール ユニットの最小数。 int

制約:
最小値 = 0

使用例

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

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

テンプレート 形容
Quagga を使用した BGP ピアリングでの Azure Route Server の

Azure
にデプロイする
このテンプレートは、Quagga を使用してルーター サーバーと Ubuntu VM をデプロイします。 ルーター サーバーと Quagga の間に 2 つの外部 BGP セッションが確立されます。 Quagga のインストールと構成は、Linux 用の Azure カスタム スクリプト拡張機能によって実行されます
Azure Virtual WAN (vWAN) マルチハブ デプロイ

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

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

Azure にデプロイする
このテンプレートは、RouteServerSubnet という名前のサブネットにルート サーバーをデプロイします。
Virtual WAN リソースを作成

Azure にデプロイする
このテンプレートを使用すると、Virtual WAN、Virtual Hub、VPN Gateway、VPN サイト、VPN Connecton などの仮想 WAN リソースを作成できます。
セキュリティで保護された仮想ハブ を する

Azure
にデプロイする
このテンプレートでは、Azure Firewall を使用してセキュリティで保護された仮想ハブを作成し、インターネット宛てのクラウド ネットワーク トラフィックをセキュリティで保護します。
マルチ アドレス プールとユーザー グループを使用した vWAN P2S のデプロイを

Azure にデプロイする
このテンプレートは、複数のアドレス プールとユーザー グループで構成された P2S を使用して Azure Virtual WAN (vWAN) をデプロイします

Terraform (AzAPI プロバイダー) リソース定義

virtualHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Network/virtualHubs リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualHubs@2025-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      addressPrefix = "string"
      allowBranchToBranchTraffic = bool
      azureFirewall = {
        id = "string"
      }
      expressRouteGateway = {
        id = "string"
      }
      hubRoutingPreference = "string"
      p2SVpnGateway = {
        id = "string"
      }
      preferredRoutingGateway = "string"
      routeTable = {
        routes = [
          {
            addressPrefixes = [
              "string"
            ]
            nextHopIpAddress = "string"
          }
        ]
      }
      securityPartnerProvider = {
        id = "string"
      }
      securityProviderName = "string"
      sku = "string"
      virtualHubRouteTableV2s = [
        {
          id = "string"
          name = "string"
          properties = {
            attachedConnections = [
              "string"
            ]
            routes = [
              {
                destinations = [
                  "string"
                ]
                destinationType = "string"
                nextHops = [
                  "string"
                ]
                nextHopType = "string"
              }
            ]
          }
        }
      ]
      virtualRouterAsn = int
      virtualRouterAutoScaleConfiguration = {
        minCapacity = int
      }
      virtualRouterIps = [
        "string"
      ]
      virtualWan = {
        id = "string"
      }
      vpnGateway = {
        id = "string"
      }
    }
  }
}

プロパティ値

マイクロソフトネットワーク/virtualHubs

名前 形容 価値
位置 リソースの場所。 文字列
名前 リソース名 string (必須)
parent_id この拡張リソースを適用するリソースの ID。 string (必須)
プロパティ 仮想ハブのプロパティ。 VirtualHubプロパティ
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 「Microsoft.Network/virtualHubs@2025-03-01」

リソースタグ

名前 形容 価値

サブリソース

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

VirtualHubプロパティ

名前 形容 価値
アドレスプレフィックス この VirtualHub のアドレス プレフィックス。 文字列
allowBranchToBranchTraffic (ブランチからブランチへのトラフィックを許可する) VirtualRouter ハブの転送を制御するためのフラグ。 ブール (bool)
azureファイアウォール この VirtualHub に関連付けられている azureFirewall。 SubResource の
expressRouteGateway この VirtualHub に関連付けられている expressRouteGateway。 SubResource の
hubRoutingPreference(英語) この VirtualHub の hubRoutingPreference。 「アス」
「エクスプレスルート」
「VpnGateway」
p2SVpnGateway(英語) この VirtualHub に関連付けられている P2SVpnGateway。 SubResource の
preferredルーティングゲートウェイ オンプレミス トラフィックをルーティングするための優先ゲートウェイ 「エクスプレスルート」
「なし」
「VpnGateway」
ルートテーブル この仮想ハブに関連付けられている routeTable。 VirtualHubRouteTable の
セキュリティパートナープロバイダ この VirtualHub に関連付けられている securityPartnerProvider。 SubResource の
セキュリティプロバイダ名 セキュリティ プロバイダー名。 文字列
エスケーユー この VirtualHub の SKU。 文字列
virtualHubRouteTableV2s この VirtualHub に関連付けられているすべての仮想ハブ ルート テーブル v2 の一覧。 VirtualHubルートテーブルV2[]
virtualRouterAsn VirtualRouter ASN。 int

制約:
最小値 = 0
最大値 = 4294967295
virtualRouterAutoScale設定 VirtualHub ルーターの自動スケール構成。 VirtualRouterAutoScaleConfiguration の
仮想ルーターIPS VirtualRouter IP。 文字列[]
バーチャルワン VirtualHub が属する VirtualWAN。 SubResource の
vpnゲートウェイ この VirtualHub に関連付けられている VpnGateway。 SubResource の

VirtualHubルート

名前 形容 価値
addressプレフィックス すべての addressPrefixes の一覧。 文字列[]
次のHopIpAddress NextHop IP アドレス。 文字列

VirtualHubルートテーブル

名前 形容 価値
ルート すべてのルートの一覧。 VirtualHubルート[]

VirtualHubRouteTableV2 (英語)

名前 形容 価値
身分証明書 リソース ID。 文字列
名前 リソース グループ内で一意であるリソースの名前。 この名前は、リソースへのアクセスに使用できます。 文字列
プロパティ 仮想ハブ ルート テーブル v2 のプロパティ。 VirtualHubRouteTableV2Properties の

VirtualHubRouteTableV2プロパティ

名前 形容 価値
attached接続 このルート テーブル v2 に接続されているすべての接続の一覧。 文字列[]
ルート すべてのルートの一覧。 VirtualHubルートV2[]

バーチャルハブルートV2

名前 形容 価値
目的 地 すべての宛先の一覧。 文字列[]
destinationType(宛先タイプ) 変換先の種類。 文字列
ネクストホップ NextHops IP アドレス。 文字列[]
ネクストホップタイプ 次ホップの種類。 文字列

VirtualRouterAutoScale設定

名前 形容 価値
最小容量 VirtualHub ルーターのスケール ユニットの最小数。 int

制約:
最小値 = 0

使用例

Terraformサンプル

仮想 WAN 内に仮想 HUB を展開する基本的な例。

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.0.0/24"
      hubRoutingPreference = "ExpressRoute"
      virtualRouterAutoScaleConfiguration = {
        minCapacity = 2
      }
      virtualWan = {
        id = azapi_resource.virtualWan.id
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}