Microsoft.Compute.SizeSelector UI element

A control for selecting a size for one or more virtual machine instances. You use this element when creating an Azure Managed Application.

UI sample



  "name": "element1",
  "type": "Microsoft.Compute.SizeSelector",
  "label": "Size",
  "toolTip": "",
  "recommendedSizes": [
  "constraints": {
    "allowedSizes": [],
    "excludedSizes": []
  "osPlatform": "Windows",
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2012-R2-Datacenter"
  "count": 2,
  "visible": true


  • recommendedSizes should contain at least one size. The first recommended size is used as the default.
  • If a recommended size is not available in the selected location, the size is automatically skipped. Instead, the next recommended size is used.
  • Any size not specified in the constraints.allowedSizes is hidden, and any size not specified in constraints.excludedSizes is shown. constraints.allowedSizes and constraints.excludedSizes are both optional, but cannot be used simultaneously. The list of available sizes can be determined by calling List available virtual machine sizes for a subscription.
  • osPlatform must be specified, and can be either Windows or Linux. It's used to determine the hardware costs of the virtual machines.
  • imageReference is omitted for first-party images, but provided for third-party images. It's used to determine the software costs of the virtual machines.
  • count is used to set the appropriate multiplier for the element. It supports a static value, like 2, or a dynamic value from another element, like [steps('step1').vmCount]. The default value is 1.

Sample output


Next steps