Benutzeroberflächenelement „Microsoft.Network.VirtualNetworkCombo“

Eine Gruppe von Steuerelementen zum Auswählen eines neuen oder vorhandenen virtuellen Netzwerks.

Benutzeroberflächenbeispiel

Wenn der Benutzer ein neues virtuelles Netzwerk auswählt, kann er den Namen und das Adresspräfix der einzelnen Subnetze anpassen. Die Konfiguration von Subnetzen ist optional.

Wenn der Benutzer ein vorhandenes virtuelles Netzwerk auswählt, muss er jedes von der Bereitstellungsvorlage geforderte Subnetz einem vorhandenen Subnetz zuordnen. Die Konfiguration von Subnetzen ist in diesem Fall erforderlich.

Schema

{
  "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
}

Beispielausgabe

{
  "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"
    }
  }
}

Hinweise

• Wenn angegeben, wird das erste nicht überlappende Adresspräfix der Größe defaultValue.addressPrefixSize automatisch basierend auf den vorhandenen virtuellen Netzwerken im Abonnement des Benutzers bestimmt.
• Der Standardwert für defaultValue.name und defaultValue.addressPrefixSize ist null.
• constraints.minAddressPrefixSize muss angegeben werden. Vorhandene virtuelle Netzwerke, deren Adressbereich kleiner als der angegebene Wert ist, können nicht ausgewählt werden.
• subnets muss angegeben werden, und für jedes Subnetz muss constraints.minAddressPrefixSize angegeben werden.
• Wenn Sie ein neues virtuelles Netzwerk erstellen, wird das Adresspräfix jedes Subnetzes automatisch basierend auf dem Adresspräfix des virtuellen Netzwerks und dem entsprechenden addressPrefixSizeberechnet.
• Wenn Sie ein vorhandenes virtuelles Netzwerk verwenden, sind alle Subnetze, die kleiner als die jeweilige constraints.minAddressPrefixSize sind, für die Auswahl nicht verfügbar. Darüber hinaus können bei Angabe des Werts Subnetze, die nicht mindestens minAddressCount verfügbare Adressen enthalten, nicht ausgewählt werden. Der Standardwert ist 0. Um sicherzustellen, dass die verfügbaren Adressen zusammenhängend sind, geben Sie folgendes requireContiguousAddressesantrue: Der Standardwert ist true.
• Die Erstellung von Subnetzen in einem vorhandenen virtuellen Netzwerk wird nicht unterstützt.
• Wenn options.hideExisting ja true, kann der Benutzer kein vorhandenes virtuelles Netzwerk auswählen. Der Standardwert ist false.

Nächste Schritte

• Eine Einführung zum Erstellen von Benutzeroberflächendefinitionen finden Sie unter Erste Schritte mit „CreateUiDefinition“.
• Eine Beschreibung der allgemeinen Eigenschaften in Benutzeroberflächenelementen finden Sie unter CreateUiDefinition-Elemente.