Microsoft.Network.VirtualNetworkCombo UI 要素

新規または既存の仮想ネットワークを選択するコントロールのグループです。

UI サンプル

新しい仮想ネットワークを選択すると、各サブネットの名前とアドレスのプレフィックスをカスタマイズすることができます。 サブネットの構成は省略可能です。

既存の仮想ネットワークを選択する場合、デプロイ テンプレートに必要な各サブネットを既存のサブネットにマップする必要があります。 この場合、サブネットを構成する必要があります。

スキーマ

{
  "name": "element1",
  "type": "Microsoft.Network.VirtualNetworkCombo",
  "label": {
    "virtualNetwork": "Virtual network",
    "subnets": "Subnets"
  },
  "toolTip": {
    "virtualNetwork": "",
    "subnets": ""
  },
  "defaultValue": {
    "name": "vnet01",
    "addressPrefixSize": "/16"
  },
  "constraints": {
    "minAddressPrefixSize": "/16"
  },
  "options": {
    "hideExisting": false
  },
  "subnets": {
    "subnet1": {
      "label": "First subnet",
      "defaultValue": {
        "name": "subnet-1",
        "addressPrefixSize": "/24"
      },
      "constraints": {
        "minAddressPrefixSize": "/24",
        "minAddressCount": 12,
        "requireContiguousAddresses": true
      }
    },
    "subnet2": {
      "label": "Second subnet",
      "defaultValue": {
        "name": "subnet-2",
        "addressPrefixSize": "/26"
      },
      "constraints": {
        "minAddressPrefixSize": "/26",
        "minAddressCount": 8,
        "requireContiguousAddresses": true
      }
    }
  },
  "visible": true
}

サンプル出力

{
  "name": "vnet01",
  "resourceGroup": "demoRG",
  "addressPrefixes": [
    "10.0.0.0/16"
  ],
  "addressPrefix": "10.0.0.0/16",
  "newOrExisting": "new",
  "subnets": {
    "subnet1": {
      "name": "subnet-1",
      "addressPrefix": "10.0.0.0/24",
      "startAddress": "10.0.0.4"
    },
    "subnet2": {
      "name": "subnet-2",
      "addressPrefix": "10.0.1.0/26",
      "startAddress": "10.0.1.4"
    }
  }
}

解説

• defaultValue.addressPrefixSize を指定した場合、このサイズの最初の重複しないアドレスのプレフィックスが、ユーザーのサブスクリプションにある既存の仮想ネットワークに基づいて自動的に決定されます。
• defaultValue.name と defaultValue.addressPrefixSize の既定値は null です。
• constraints.minAddressPrefixSize を指定する必要があります。 アドレス空間が指定した値よりも小さい既存の仮想ネットワークは選択できません。
• subnets を指定する必要があるほか、サブネットごとに constraints.minAddressPrefixSize を指定する必要があります。
• 新しい仮想ネットワークを作成するときは、その仮想ネットワークのアドレス プレフィックスと各 addressPrefixSize に基づいて、各サブネットのアドレス プレフィックスが自動的に計算されます。
• 既存の仮想ネットワークを使用するときは、各 constraints.minAddressPrefixSize よりも小さいサブネットは選択できません。 さらに、minAddressCount を指定した場合、少なくともその個数の使用可能なアドレスが含まれないサブネットは選択できません。 既定値は 0 です。 使用可能なアドレスを連続させるには、requireContiguousAddresses に true を設定します。 既定値は true です。
• 既存の仮想ネットワークでのサブネットの作成はサポートされていません。
• options.hideExisting が true である場合、ユーザーは既存の仮想ネットワークを選択できません。 既定値は false です。

次のステップ

• UI 定義の作成の概要については、「CreateUiDefinition の基本概念」を参照してください。
• UI 要素の共通プロパティの説明については、「CreateUiDefinition の要素」を参照してください。