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

This article describes the properties that changed in each API version for Microsoft.Compute/virtualMachineScaleSets/virtualMachines. It only covers properties that are available during deployments.

2024-07-01

Removed:

• enableVMAgentPlatformUpdates

2024-03-01

Added:

• storageProfile.dataDisks.sourceResource
• storageProfile.dataDisks.sourceResource.id

Updated:

• properties.storageProfile.dataDisks.createOption - Added values: 'Copy' 'FromImage' 'Restore' (required) - Removed values: 'FromImage' (required)
• properties.storageProfile.osDisk.createOption - Added values: 'Copy' 'FromImage' 'Restore' (required) - Removed values: 'FromImage' (required)
• properties.storageProfile.osDisk.diffDiskSettings.placement - Added values: 'NvmeDisk'

2023-09-01

Added:

• securityProfile.encryptionIdentity
• securityProfile.encryptionIdentity.userAssignedIdentityResourceId
• securityProfile.proxyAgentSettings
• securityProfile.proxyAgentSettings.enabled
• securityProfile.proxyAgentSettings.keyIncarnationId
• securityProfile.proxyAgentSettings.mode

Updated:

• properties.storageProfile.dataDisks.managedDisk.securityProfile.securityEncryptionType - Added values: 'NonPersistedTPM'

2023-07-01

Added:

• properties.networkProfile.networkInterfaceConfigurations.properties.auxiliaryMode
• properties.networkProfile.networkInterfaceConfigurations.properties.auxiliarySku
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.dnsSettings.domainNameLabelScope
• networkProfileConfiguration.networkInterfaceConfigurations.properties.auxiliaryMode
• networkProfileConfiguration.networkInterfaceConfigurations.properties.auxiliarySku
• networkProfileConfiguration.publicIPAddressConfiguration.properties.dnsSettings.domainNameLabelScope

2023-03-01

Added:

• osProfile.linuxConfiguration.patchSettings.automaticByPlatformSettings.bypassPlatformSafetyChecksOnUserSchedule
• patchSettings.automaticByPlatformSettings.bypassPlatformSafetyChecksOnUserSchedule

2022-11-01

Removed:

• networkProfileConfiguration.networkInterfaceConfigurations.id
• networkProfileConfiguration.networkInterfaceConfigurations.properties.ipConfigurations.id

2022-08-01

Added:

• properties.networkProfile.networkInterfaceConfigurations.properties.disableTcpStateTracking
• networkProfileConfiguration.networkInterfaceConfigurations.properties.disableTcpStateTracking
• osProfile.linuxConfiguration.enableVMAgentPlatformUpdates
• enableVMAgentPlatformUpdates
• diskControllerType

2022-03-01

Added:

• identity
• identity.type
• identity.userAssignedIdentities
• identity.userAssignedIdentities.{customized property}
• osProfile.linuxConfiguration.patchSettings.automaticByPlatformSettings
• osProfile.linuxConfiguration.patchSettings.automaticByPlatformSettings.rebootSetting
• patchSettings.automaticByPlatformSettings
• patchSettings.automaticByPlatformSettings.rebootSetting

Updated:

• properties.storageProfile.dataDisks.managedDisk.storageAccountType - Added values: 'PremiumV2_LRS'

2021-11-01

Added:

• storageProfile.dataDisks.managedDisk.securityProfile
• storageProfile.dataDisks.managedDisk.securityProfile.diskEncryptionSet
• storageProfile.dataDisks.managedDisk.securityProfile.diskEncryptionSet.id
• storageProfile.dataDisks.managedDisk.securityProfile.securityEncryptionType
• imageReference.communityGalleryImageId
• osDisk.managedDisk.securityProfile
• osDisk.managedDisk.securityProfile.diskEncryptionSet
• osDisk.managedDisk.securityProfile.diskEncryptionSet.id
• osDisk.managedDisk.securityProfile.securityEncryptionType

Updated:

• properties.securityProfile.securityType - Added values: 'ConfidentialVM'

2021-07-01

Added:

• properties.additionalCapabilities.hibernationEnabled
• properties.hardwareProfile.vmSizeProperties
• properties.hardwareProfile.vmSizeProperties.vCPUsAvailable
• properties.hardwareProfile.vmSizeProperties.vCPUsPerCore
• imageReference.sharedGalleryImageId

2021-04-01

No new or updated properties

2021-03-01

Added:

• properties.networkProfile.networkApiVersion
• properties.networkProfile.networkInterfaceConfigurations
• properties.networkProfile.networkInterfaceConfigurations.name
• properties.networkProfile.networkInterfaceConfigurations.properties
• properties.networkProfile.networkInterfaceConfigurations.properties.deleteOption
• properties.networkProfile.networkInterfaceConfigurations.properties.dnsSettings
• properties.networkProfile.networkInterfaceConfigurations.properties.dnsSettings.dnsServers
• properties.networkProfile.networkInterfaceConfigurations.properties.dscpConfiguration
• properties.networkProfile.networkInterfaceConfigurations.properties.dscpConfiguration.id
• properties.networkProfile.networkInterfaceConfigurations.properties.enableAcceleratedNetworking
• properties.networkProfile.networkInterfaceConfigurations.properties.enableFpga
• properties.networkProfile.networkInterfaceConfigurations.properties.enableIPForwarding
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.name
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.properties
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.properties.applicationGatewayBackendAddressPools
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.properties.applicationGatewayBackendAddressPools.id
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.applicationSecurityGroups
• properties.networkProfile.networkInterfaceConfigurations.properties.ipConfigurations.applicationSecurityGroups.id
• properties.networkProfile.networkInterfaceConfigurations.properties.loadBalancerBackendAddressPools
• properties.networkProfile.networkInterfaceConfigurations.properties.loadBalancerBackendAddressPools.id
• properties.networkProfile.networkInterfaceConfigurations.primary
• properties.networkProfile.networkInterfaceConfigurations.privateIPAddressVersion
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.name
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.deleteOption
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.dnsSettings
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.dnsSettings.domainNameLabel
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.idleTimeoutInMinutes
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.ipTags
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.ipTags.ipTagType
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.properties.ipTags.tag
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.publicIPAddressVersion
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.publicIPAllocationMethod
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.publicIPPrefix
• properties.networkProfile.networkInterfaceConfigurations.publicIPAddressConfiguration.publicIPPrefix.id
• properties.networkProfile.networkInterfaceConfigurations.sku
• properties.networkProfile.networkInterfaceConfigurations.sku.name
• properties.networkProfile.networkInterfaceConfigurations.sku.tier
• properties.networkProfile.subnet
• properties.networkProfile.subnet.id
• networkInterfaces
• networkInterfaces.id
• networkInterfaces.properties
• networkInterfaces.properties.deleteOption
• networkInterfaces.properties.primary
• networkProfileConfiguration.networkInterfaceConfigurations.properties.deleteOption
• networkProfileConfiguration.publicIPAddressConfiguration.properties.deleteOption
• networkProfileConfiguration.sku
• networkProfileConfiguration.sku.name
• networkProfileConfiguration.sku.tier
• osProfile.linuxConfiguration.patchSettings.assessmentMode
• patchSettings.assessmentMode
• storageProfile.dataDisks.deleteOption
• osDisk.deleteOption
• userData

Removed:

• properties.networkProfile.networkInterfaces
• properties.networkProfile.networkInterfaces.id
• properties.networkProfile.networkInterfaces.properties
• properties.networkProfile.networkInterfaces.properties.primary

2020-12-01

Oldest version tracked in change log