Elemento da interface do usuário Microsoft.Network.VirtualNetworkCombo

Um grupo de controles para selecionar uma rede virtual nova ou existente.

Exemplo de interface do usuário

Quando o usuário escolhe uma nova rede virtual, ele pode personalizar o nome e o prefixo de endereço de cada sub-rede. A configuração de sub-redes é opcional.

Quando o usuário seleciona uma rede virtual existente, ele deve mapear cada sub-rede que o modelo de implantação requer para uma sub-rede existente. Neste caso, é necessário configurar sub-redes.

Esquema

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

Saída de exemplo

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

Observações

• Se especificado, o primeiro prefixo de endereço não sobreposto de tamanho defaultValue.addressPrefixSize é determinado automaticamente com base nas redes virtuais existentes na assinatura do usuário.
• O valor padrão para defaultValue.name e defaultValue.addressPrefixSize é null.
• constraints.minAddressPrefixSize deve ser especificado. Todas as redes virtuais existentes com um espaço de endereço menor do que o valor especificado não estão disponíveis para seleção.
• subnets deve ser especificado e constraints.minAddressPrefixSize deve ser especificado para cada sub-rede.
• Quando você cria uma nova rede virtual, o prefixo de endereço de cada sub-rede é calculado automaticamente com base no prefixo de endereço da rede virtual e no respetivo addressPrefixSize.
• Quando você usa uma rede virtual existente, todas as sub-redes menores que as respetivas constraints.minAddressPrefixSize não estão disponíveis para seleção. Além disso, se especificado, as sub-redes que não têm pelo menos minAddressCount endereços disponíveis não estão disponíveis para seleção. O valor predefinido é 0. Para garantir que os endereços disponíveis sejam contíguos, especifique true para requireContiguousAddresses. O valor predefinido é true.
• Não há suporte para a criação de sub-redes em uma rede virtual existente.
• Se options.hideExisting for true, o usuário não poderá escolher uma rede virtual existente. O valor predefinido é false.

Próximos passos

• Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução a CreateUiDefinition.
• Para obter uma descrição das propriedades comuns em elementos da interface do usuário, consulte Elementos CreateUiDefinition.