Edit

Quickstart: Create VM with adaptive placement by using compute templates

Important

Compute templates are in Limited preview. Your subscription must be enabled for the preview. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability.

This quickstart shows you how to use Azure REST APIs to deploy a virtual machine (VM) with adaptive placement by using a compute template.

Prerequisites

Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx in the examples with your subscription ID. The examples use the resource names from the VM quickstart, including the gallery testIpGallery12.

The commands use az rest to call the preview REST APIs.

Create a network interface

Create a separate network interface for this VM. If you completed the VM quickstart, its network interface is already attached to another VM and can't be reused.

az network nic create \
    --resource-group "rg-ip-preview-test" \
    --location "eastus2euap" \
    --name "nic-ip-adaptive-01" \
    --vnet-name "vnet-ip-preview" \
    --subnet "subnet-ip-preview"

Create an instance profile definition

Save the following JSON as adaptive-placement-instance-profile.json in your current directory:

{
  "tags": {
    "purpose": "adaptive-placement-example"
  },
  "location": "eastus2euap",
  "properties": {
    "description": "Instance profile for a VM with adaptive placement"
  }
}

Run the following command:

az rest \
    --method PUT \
    --url "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip?api-version=2026-03-03" \
    --body "@adaptive-placement-instance-profile.json"

Example response:

{
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip",
  "location": "eastus2euap",
  "name": "adaptive-placement-ip",
  "properties": {
    "description": "Instance profile for a VM with adaptive placement",
    "provisioningState": "Succeeded"
  },
  "tags": {
    "purpose": "adaptive-placement-example"
  },
  "type": "Microsoft.Compute/galleries/instanceProfiles"
}

Create an instance profile version

Save the following JSON as adaptive-placement-instance-profile-version.json in your current directory:

{
  "name": "1.0.0",
  "location": "eastus2euap",
  "properties": {
    "targetLocations": [
      {
        "name": "eastus2euap"
      }
    ],
    "instanceProfileType": "VirtualMachine",
    "virtualMachineProfile": {
      "flexProfile": {
        "preferredVMSize": "Standard_D2s_v5"
      },
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "deleteOption": "Delete"
        }
      },
      "osProfile": {
        "adminUsername": "azureuser",
        "allowExtensionOperations": true,
        "linuxConfiguration": {
          "disablePasswordAuthentication": true,
          "provisionVMAgent": true
        }
      }
    }
  }
}

Run the following command:

az rest \
    --method PUT \
    --url "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip/versions/1.0.0?api-version=2026-03-03" \
    --body "@adaptive-placement-instance-profile-version.json"

Example response:

{
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip/versions/1.0.0",
  "location": "eastus2euap",
  "name": "1.0.0",
  "properties": {
    "instanceProfileType": "VirtualMachine",
    "provisioningState": "Succeeded",
    "targetLocations": [
      {
        "name": "eastus2euap"
      }
    ],
    "replicationStatus": {
      "aggregatedState": "Completed",
      "summary": [
        {
          "region": "eastus2euap",
          "state": "Completed",
          "progress": 100
        }
      ]
    },
    "virtualMachineProfile": {
      "flexProfile": {
        "preferredVMSize": "Standard_D2s_v5"
      },
      "storageProfile": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "0001-com-ubuntu-server-jammy",
          "sku": "22_04-lts-gen2",
          "version": "latest"
        },
        "osDisk": {
          "createOption": "FromImage",
          "deleteOption": "Delete"
        }
      },
      "osProfile": {
        "adminUsername": "azureuser",
        "allowExtensionOperations": true,
        "linuxConfiguration": {
          "disablePasswordAuthentication": true,
          "provisionVMAgent": true
        }
      }
    }
  },
  "type": "Microsoft.Compute/galleries/instanceProfiles/versions"
}

Create a VM with adaptive placement

Save the following JSON as adaptive-placement-virtual-machine.json in your current directory. Replace <ssh-public-key> with your SSH public key.

The request sets storageAccountType to StandardSSD_LRS inline because the preview doesn't support that value in an instance profile.

{
  "location": "eastus2euap",
  "properties": {
    "instanceProfile": {
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip/versions/1.0.0"
    },
    "storageProfile": {
      "osDisk": {
        "managedDisk": {
          "storageAccountType": "StandardSSD_LRS"
        }
      }
    },
    "osProfile": {
      "computerName": "adaptive-placement-01",
      "linuxConfiguration": {
        "ssh": {
          "publicKeys": [
            {
              "path": "/home/azureuser/.ssh/authorized_keys",
              "keyData": "<ssh-public-key>"
            }
          ]
        }
      }
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Network/networkInterfaces/nic-ip-adaptive-01",
          "properties": {
            "primary": true
          }
        }
      ]
    }
  }
}

Run the following command:

az rest \
    --method PUT \
    --url "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/virtualMachines/adaptive-placement-01?api-version=2026-04-01" \
    --body "@adaptive-placement-virtual-machine.json"

Example response:

{
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/virtualMachines/adaptive-placement-01",
  "location": "eastus2euap",
  "name": "adaptive-placement-01",
  "properties": {
    "provisioningState": "Succeeded",
    "instanceProfile": {
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/galleries/testIpGallery12/instanceProfiles/adaptive-placement-ip/versions/1.0.0"
    },
    "flexProfile": {
      "preferredVMSize": "Standard_D2s_v5"
    },
    "hardwareProfile": {
      "vmSize": "Standard_D2s_v5"
    },
    "storageProfile": {
      "imageReference": {
        "publisher": "Canonical",
        "offer": "0001-com-ubuntu-server-jammy",
        "sku": "22_04-lts-gen2",
        "version": "latest"
      },
      "osDisk": {
        "createOption": "FromImage",
        "deleteOption": "Delete",
        "osType": "Linux",
        "managedDisk": {
          "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Compute/disks/<generated-os-disk-name>",
          "storageAccountType": "StandardSSD_LRS"
        }
      }
    },
    "osProfile": {
      "computerName": "adaptive-placement-01",
      "adminUsername": "azureuser",
      "linuxConfiguration": {
        "disablePasswordAuthentication": true,
        "provisionVMAgent": true
      }
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg-ip-preview-test/providers/Microsoft.Network/networkInterfaces/nic-ip-adaptive-01"
        }
      ]
    }
  },
  "type": "Microsoft.Compute/virtualMachines"
}

Confirm that the response shows provisioningState as Succeeded.

To override values from the instance profile in your VM with adaptive placement request, see Requests with overrides.

Next steps