API version change log for deployment of Microsoft.Compute/virtualMachines

This article describes the properties that changed in each API version for microsoft.compute/virtualmachines. It only covers properties that are available during deployments.

2024-07-01

No properties added, updated or removed.

2024-03-01

Added:

• EventGridAndResourceGraph
• ScheduledEventsAdditionalPublishingTargets
• ScheduledEventsPolicy
• UserInitiatedReboot
• UserInitiatedRedeploy

Updated:

• DataDisk: Added property 'sourceResource'
• VirtualMachineProperties: Added property 'scheduledEventsPolicy'

2023-09-01

Added:

• EncryptionIdentity
• ProxyAgentSettings

Updated:

• Microsoft.Compute/virtualMachines: Added property 'etag'
• Microsoft.Compute/virtualMachines: Added property 'managedBy'
• SecurityProfile: Added property 'encryptionIdentity'
• SecurityProfile: Added property 'proxyAgentSettings'

2023-07-01

No properties added, updated or removed.

2023-03-01

Updated:

• LinuxVMGuestPatchAutomaticByPlatformSettings: Added property 'bypassPlatformSafetyChecksOnUserSchedule'
• WindowsVMGuestPatchAutomaticByPlatformSettings: Added property 'bypassPlatformSafetyChecksOnUserSchedule'

2022-11-01

Added:

• OSImageNotificationProfile

Updated:

• ScheduledEventsProfile: Added property 'osImageNotificationProfile'

2022-08-01

Updated:

• LinuxConfiguration: Added property 'enableVMAgentPlatformUpdates'
• StorageProfile: Added property 'diskControllerType'
• WindowsConfiguration: Added property 'enableVMAgentPlatformUpdates'

2022-03-01

Added:

• LinuxVMGuestPatchAutomaticByPlatformSettings
• UserAssignedIdentities
• WindowsVMGuestPatchAutomaticByPlatformSettings

Removed:

• VirtualMachineIdentityUserAssignedIdentities

Updated:

• LinuxPatchSettings: Added property 'automaticByPlatformSettings'
• PatchSettings: Added property 'automaticByPlatformSettings'
• VMGalleryApplication: Added property 'enableAutomaticUpgrade'
• VMGalleryApplication: Added property 'treatFailureAsDeploymentFailure'

2021-11-01

Added:

• VMDiskSecurityProfile

Updated:

• ImageReference: Added property 'communityGalleryImageId'
• ManagedDiskParameters: Added property 'securityProfile'
• VirtualMachineProperties: Added property 'timeCreated'

2021-07-01

Added:

• ApplicationProfile
• VMGalleryApplication
• VMSizeProperties

Updated:

• AdditionalCapabilities: Added property 'hibernationEnabled'
• HardwareProfile: Added property 'vmSizeProperties'
• ImageReference: Added property 'sharedGalleryImageId'
• VirtualMachineProperties: Added property 'applicationProfile'

2021-04-01

Added:

• CapacityReservationProfile

Updated:

• VirtualMachineProperties: Added property 'capacityReservation'

2021-03-01

Added:

• ScheduledEventsProfile
• TerminateNotificationProfile
• VirtualMachineNetworkInterfaceConfiguration

Updated:

• DataDisk: Added property 'deleteOption'
• LinuxPatchSettings: Added property 'assessmentMode'
• NetworkProfile: Added property 'networkApiVersion'
• NetworkProfile: Added property 'networkInterfaceConfigurations'
• OSDisk: Added property 'deleteOption'
• PatchSettings: Added property 'assessmentMode'
• VirtualMachineProperties: Added property 'scheduledEventsProfile'
• VirtualMachineProperties: Added property 'userData'

2020-12-01

Added:

• ExtendedLocation
• LinuxPatchSettings
• UefiSettings

Updated:

• DataDisk: Added property 'detachOption'
• LinuxConfiguration: Added property 'patchSettings'
• Microsoft.Compute/virtualMachines: Added property 'extendedLocation'
• PatchSettings: Added property 'enableHotpatching'
• SecurityProfile: Added property 'securityType'
• SecurityProfile: Added property 'uefiSettings'
• VirtualMachineProperties: Added property 'platformFaultDomain'

2020-06-01

Added:

• PatchSettings
• SecurityProfile

Updated:

• VirtualMachineProperties: Added property 'extensionsTimeBudget'
• VirtualMachineProperties: Added property 'hostGroup'
• VirtualMachineProperties: Added property 'securityProfile'
• WindowsConfiguration: Added property 'patchSettings'

2019-12-01

Updated:

• DiffDiskSettings: Added property 'placement'

2019-07-01

Added:

• DiskEncryptionSetParameters

Updated:

• DataDisk: Added property 'diskIOPSReadWrite'
• DataDisk: Added property 'diskMBpsReadWrite'
• ImageReference: Added property 'exactVersion'
• ManagedDiskParameters: Added property 'diskEncryptionSet'

2019-03-01

Added:

• BillingProfile

Updated:

• DataDisk: Added property 'toBeDetached'
• OSProfile: Added property 'requireGuestProvisionSignal'
• VirtualMachineProperties: Added property 'billingProfile'
• VirtualMachineProperties: Added property 'evictionPolicy'
• VirtualMachineProperties: Added property 'host'
• VirtualMachineProperties: Added property 'priority'
• VirtualMachineProperties: Added property 'virtualMachineScaleSet'

2018-10-01

No properties added, updated or removed.

2018-06-01

Added:

• AdditionalCapabilities
• DiffDiskSettings
• UserAssignedIdentitiesValue
• VirtualMachineIdentityUserAssignedIdentities

Updated:

• LinuxConfiguration: Added property 'provisionVMAgent'
• OSDisk: Added property 'diffDiskSettings'
• OSProfile: Added property 'allowExtensionOperations'
• VirtualMachineIdentity: Added property 'userAssignedIdentities'
• VirtualMachineIdentity: Removed property 'identityIds'
• VirtualMachineProperties: Added property 'additionalCapabilities'

2018-04-01

Updated:

• VirtualMachineProperties: Added property 'proximityPlacementGroup'

2017-12-01

Updated:

• DataDisk: Added property 'writeAcceleratorEnabled'
• OSDisk: Added property 'writeAcceleratorEnabled'
• VirtualMachineIdentity: Added property 'identityIds'

2017-03-30

Updated:

• Microsoft.Compute/virtualMachines: Added property 'zones'

2016-04-30-preview

Added:

• ManagedDiskParameters

Updated:

• DataDisk: Added property 'managedDisk'
• ImageReference: Added property 'id'
• OSDisk: Added property 'managedDisk'

2016-03-30

Added:

• VirtualMachineIdentity

Updated:

• Microsoft.Compute/virtualMachines: Added property 'identity'
• VirtualMachineProperties: Added property 'vmId'

2015-06-15

Oldest version tracked in change log