Virtual Machine Scale Sets - Update

Service:

Compute

API Version:

2021-04-01

Update a VM scale set.

HTTP

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}?api-version=2021-04-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	The name of the resource group.
subscriptionId	path	True	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
vmScaleSetName	path	True	string	The name of the VM scale set to create or update.
api-version	query	True	string	Client Api Version.

Request Body

Name	Type	Description
identity	VirtualMachineScaleSetIdentity	The identity of the virtual machine scale set, if configured.
plan	Plan	The purchase plan when deploying a virtual machine scale set from VM Marketplace images.
properties.additionalCapabilities	AdditionalCapabilities	Specifies additional capabilities enabled or disabled on the Virtual Machines in the Virtual Machine Scale Set. For instance: whether the Virtual Machines have the capability to support attaching managed data disks with UltraSSD_LRS storage account type.
properties.automaticRepairsPolicy	AutomaticRepairsPolicy	Policy for automatic repairs.
properties.doNotRunExtensionsOnOverprovisionedVMs	boolean	When Overprovision is enabled, extensions are launched only on the requested number of VMs which are finally kept. This property will hence ensure that the extensions do not run on the extra overprovisioned VMs.
properties.overprovision	boolean	Specifies whether the Virtual Machine Scale Set should be overprovisioned.
properties.proximityPlacementGroup	SubResource	Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. Minimum api-version: 2018-04-01.
properties.scaleInPolicy	ScaleInPolicy	Specifies the scale-in policy that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in.
properties.singlePlacementGroup	boolean	When true this limits the scale set to a single placement group, of max size 100 virtual machines. NOTE: If singlePlacementGroup is true, it may be modified to false. However, if singlePlacementGroup is false, it may not be modified to true.
properties.upgradePolicy	UpgradePolicy	The upgrade policy.
properties.virtualMachineProfile	VirtualMachineScaleSetUpdateVMProfile	The virtual machine profile.
sku	Sku	The virtual machine scale set sku.
tags	object	Resource tags

Responses

Name	Type	Description
200 OK	VirtualMachineScaleSet	OK

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Definitions

Name	Description
AdditionalCapabilities	Enables or disables a capability on the virtual machine or virtual machine scale set.
AdditionalUnattendContent	Specifies additional XML formatted information that can be included in the Unattend.xml file, which is used by Windows Setup. Contents are defined by setting name, component name, and the pass in which the content is applied.
ApiEntityReference	The API entity reference.
AutomaticOSUpgradePolicy	The configuration parameters used for performing automatic OS upgrade.
AutomaticRepairsPolicy	Specifies the configuration parameters for automatic repairs on the virtual machine scale set.
BillingProfile	Specifies the billing related details of a Azure Spot VM or VMSS. Minimum api-version: 2019-03-01.
BootDiagnostics	Boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status. You can easily view the output of your console log. Azure also enables you to see a screenshot of the VM from the hypervisor.
CachingTypes	Gets the caching type.
CapacityReservationProfile	The parameters of a capacity reservation Profile.
ComponentNames	The component name. Currently, the only allowable value is Microsoft-Windows-Shell-Setup.
DeleteOptions	Specify what happens to the network interface when the VM is deleted
DiagnosticsProfile	Specifies the boot diagnostic settings state. Minimum api-version: 2015-06-15.
DiffDiskOptions	Specifies the ephemeral disk settings for operating system disk.
DiffDiskPlacement	Specifies the ephemeral disk placement for operating system disk. This property can be used by user in the request to choose the location i.e, cache disk or resource disk space for Ephemeral OS disk provisioning. For more information on Ephemeral OS disk size requirements, please refer Ephemeral OS disk size requirements for Windows VM at https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements and Linux VM at https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
DiffDiskSettings	Describes the parameters of ephemeral disk settings that can be specified for operating system disk. NOTE: The ephemeral disk settings can only be specified for managed disk.
DiskCreateOptionTypes	Specifies how the virtual machine should be created. Possible values are: Attach \u2013 This value is used when you are using a specialized disk to create the virtual machine. FromImage \u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described.
DiskEncryptionSetParameters	Describes the parameter of customer managed disk encryption set resource id that can be specified for disk. NOTE: The disk encryption set resource id can only be specified for managed disk. Please refer https://aka.ms/mdssewithcmkoverview for more details.
ExtendedLocation	The complex type of the extended location.
ExtendedLocationTypes	The type of the extended location.
ImageReference	Specifies information about the image to use. You can specify information about platform images, marketplace images, or virtual machine images. This element is required when you want to use a platform image, marketplace image, or virtual machine image, but is not used in other creation operations. NOTE: Image reference publisher and offer can only be set when you create the scale set.
IPVersion	Available from Api-Version 2019-07-01 onwards, it represents whether the specific ipconfiguration is IPv4 or IPv6. Default is taken as IPv4. Possible values are: 'IPv4' and 'IPv6'.
LinuxConfiguration	Specifies the Linux operating system settings on the virtual machine. For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions.
LinuxPatchAssessmentMode	Specifies the mode of VM Guest Patch Assessment for the IaaS virtual machine. Possible values are: ImageDefault - You control the timing of patch assessments on a virtual machine. AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.
LinuxPatchSettings	Specifies settings related to VM Guest Patching on Linux.
LinuxVMGuestPatchMode	Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible. Possible values are: ImageDefault - The virtual machine's default patching configuration is used. AutomaticByPlatform - The virtual machine will be automatically updated by the platform. The property provisionVMAgent must be true
NetworkApiVersion	specifies the Microsoft.Network API version used when creating networking resources in the Network Interface Configurations
OperatingSystemTypes	The operating system of the osDiskImage.
OrchestrationMode	Specifies the orchestration mode for the virtual machine scale set.
PassNames	The pass name. Currently, the only allowable value is OobeSystem.
PatchSettings	Specifies settings related to VM Guest Patching on Windows.
Plan	Specifies information about the marketplace image used to create the virtual machine. This element is only used for marketplace images. Before you can use a marketplace image from an API, you must enable the image for programmatic use. In the Azure portal, find the marketplace image that you want to use and then click Want to deploy programmatically, Get Started ->. Enter any required information and then click Save.
ProtocolTypes	Specifies the protocol of WinRM listener. Possible values are: http https
PublicIPAddressSku	Describes the public IP Sku
PublicIPAddressSkuName	Specify public IP sku name
PublicIPAddressSkuTier	Specify public IP sku tier
ResourceIdentityType	The type of identity used for the virtual machine. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine.
RollingUpgradePolicy	The configuration parameters used while performing a rolling upgrade.
ScaleInPolicy	Describes a scale-in policy for a virtual machine scale set.
ScheduledEventsProfile
SecurityProfile	Specifies the Security profile settings for the virtual machine or virtual machine scale set.
SecurityTypes	Specifies the SecurityType of the virtual machine. It is set as TrustedLaunch to enable UefiSettings. Default: UefiSettings will not be enabled unless this property is set as TrustedLaunch.
SettingNames	Specifies the name of the setting to which the content applies. Possible values are: FirstLogonCommands and AutoLogon.
Sku	Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name.
SpotRestorePolicy	Specifies the Spot-Try-Restore properties for the virtual machine scale set. With this property customer can enable or disable automatic restore of the evicted Spot VMSS VM instances opportunistically based on capacity availability and pricing constraint.
SshConfiguration	SSH configuration for Linux based VMs running on Azure
SshPublicKey	Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed.
StorageAccountTypes	Specifies the storage account type for the managed disk. NOTE: UltraSSD_LRS can only be used with data disks, it cannot be used with OS Disk.
SubResource
TerminateNotificationProfile
UefiSettings	Specifies the security settings like secure boot and vTPM used while creating the virtual machine. Minimum api-version: 2020-12-01
UpgradeMode	Specifies the mode of an upgrade to virtual machines in the scale set. Possible values are: Manual - You control the application of updates to virtual machines in the scale set. You do this by using the manualUpgrade action. Automatic - All virtual machines in the scale set are automatically updated at the same time.
UpgradePolicy	Describes an upgrade policy - automatic, manual, or rolling.
UserAssignedIdentities	The list of user identities associated with the Virtual Machine. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
VaultCertificate	Describes a single certificate reference in a Key Vault, and where the certificate should reside on the VM.
VaultSecretGroup	Describes a set of certificates which are all in the same Key Vault.
VirtualHardDisk	Describes the uri of a disk.
VirtualMachineEvictionPolicyTypes	Specifies the eviction policy for the Azure Spot virtual machine and Azure Spot scale set. For Azure Spot virtual machines, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2019-03-01. For Azure Spot scale sets, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2017-10-30-preview.
VirtualMachinePriorityTypes	Specifies the priority for the virtual machine. Minimum api-version: 2019-03-01
VirtualMachineScaleSet	Describes a Virtual Machine Scale Set.
VirtualMachineScaleSetDataDisk	Describes a virtual machine scale set data disk.
VirtualMachineScaleSetExtension	Describes a Virtual Machine Scale Set Extension.
VirtualMachineScaleSetExtensionProfile	Describes a virtual machine scale set extension profile.
VirtualMachineScaleSetIdentity	Identity for the virtual machine scale set.
VirtualMachineScaleSetIPConfiguration	Describes a virtual machine scale set network profile's IP configuration.
VirtualMachineScaleSetIpTag	Contains the IP tag associated with the public IP address.
VirtualMachineScaleSetManagedDiskParameters	Describes the parameters of a ScaleSet managed disk.
VirtualMachineScaleSetNetworkConfiguration	Describes a virtual machine scale set network profile's network configurations.
VirtualMachineScaleSetNetworkConfigurationDnsSettings	Describes a virtual machines scale sets network configuration's DNS settings.
VirtualMachineScaleSetNetworkProfile	Describes a virtual machine scale set network profile.
VirtualMachineScaleSetOSDisk	Describes a virtual machine scale set operating system disk.
VirtualMachineScaleSetOSProfile	Describes a virtual machine scale set OS profile.
VirtualMachineScaleSetPublicIPAddressConfiguration	Describes a virtual machines scale set IP Configuration's PublicIPAddress configuration
VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	Describes a virtual machines scale sets network configuration's DNS settings.
VirtualMachineScaleSetScaleInRules	The rules to be followed when scaling-in a virtual machine scale set. Possible values are: Default When a virtual machine scale set is scaled in, the scale set will first be balanced across zones if it is a zonal scale set. Then, it will be balanced across Fault Domains as far as possible. Within each Fault Domain, the virtual machines chosen for removal will be the newest ones that are not protected from scale-in. OldestVM When a virtual machine scale set is being scaled-in, the oldest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the oldest virtual machines that are not protected will be chosen for removal. NewestVM When a virtual machine scale set is being scaled-in, the newest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the newest virtual machines that are not protected will be chosen for removal.
VirtualMachineScaleSetStorageProfile	Describes a virtual machine scale set storage profile.
VirtualMachineScaleSetUpdate	Describes a Virtual Machine Scale Set.
VirtualMachineScaleSetUpdateIPConfiguration	Describes a virtual machine scale set network profile's IP configuration. NOTE: The subnet of a scale set may be modified as long as the original subnet and the new subnet are in the same virtual network
VirtualMachineScaleSetUpdateNetworkConfiguration	Describes a virtual machine scale set network profile's network configurations.
VirtualMachineScaleSetUpdateNetworkProfile	Describes a virtual machine scale set network profile.
VirtualMachineScaleSetUpdateOSDisk	Describes virtual machine scale set operating system disk Update Object. This should be used for Updating VMSS OS Disk.
VirtualMachineScaleSetUpdateOSProfile	Describes a virtual machine scale set OS profile.
VirtualMachineScaleSetUpdatePublicIPAddressConfiguration	Describes a virtual machines scale set IP Configuration's PublicIPAddress configuration
VirtualMachineScaleSetUpdateStorageProfile	Describes a virtual machine scale set storage profile.
VirtualMachineScaleSetUpdateVMProfile	Describes a virtual machine scale set virtual machine profile.
VirtualMachineScaleSetVMProfile	Describes a virtual machine scale set virtual machine profile.
WindowsConfiguration	Specifies Windows operating system settings on the virtual machine.
WindowsPatchAssessmentMode	Specifies the mode of VM Guest patch assessment for the IaaS virtual machine. Possible values are: ImageDefault - You control the timing of patch assessments on a virtual machine. AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.
WindowsVMGuestPatchMode	Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible. Possible values are: Manual - You control the application of patches to a virtual machine. You do this by applying patches manually inside the VM. In this mode, automatic updates are disabled; the property WindowsConfiguration.enableAutomaticUpdates must be false AutomaticByOS - The virtual machine will automatically be updated by the OS. The property WindowsConfiguration.enableAutomaticUpdates must be true. AutomaticByPlatform - the virtual machine will automatically updated by the platform. The properties provisionVMAgent and WindowsConfiguration.enableAutomaticUpdates must be true
WinRMConfiguration	Describes Windows Remote Management configuration of the VM
WinRMListener	Describes Protocol and thumbprint of Windows Remote Management listener

AdditionalCapabilities

Object

Enables or disables a capability on the virtual machine or virtual machine scale set.

Name	Type	Description
ultraSSDEnabled	boolean	The flag that enables or disables a capability to have one or more managed data disks with UltraSSD_LRS storage account type on the VM or VMSS. Managed disks with storage account type UltraSSD_LRS can be added to a virtual machine or virtual machine scale set only if this property is enabled.

AdditionalUnattendContent

Object

Specifies additional XML formatted information that can be included in the Unattend.xml file, which is used by Windows Setup. Contents are defined by setting name, component name, and the pass in which the content is applied.

Name	Type	Description
componentName	ComponentNames	The component name. Currently, the only allowable value is Microsoft-Windows-Shell-Setup.
content	string	Specifies the XML formatted content that is added to the unattend.xml file for the specified path and component. The XML must be less than 4KB and must include the root element for the setting or feature that is being inserted.
passName	PassNames	The pass name. Currently, the only allowable value is OobeSystem.
settingName	SettingNames	Specifies the name of the setting to which the content applies. Possible values are: FirstLogonCommands and AutoLogon.

ApiEntityReference

Object

The API entity reference.

Name	Type	Description
id	string	The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

AutomaticOSUpgradePolicy

Object

The configuration parameters used for performing automatic OS upgrade.

Name	Type	Description
disableAutomaticRollback	boolean	Whether OS image rollback feature should be disabled. Default value is false.
enableAutomaticOSUpgrade	boolean	Indicates whether OS upgrades should automatically be applied to scale set instances in a rolling fashion when a newer version of the OS image becomes available. Default value is false. If this is set to true for Windows based scale sets, enableAutomaticUpdates is automatically set to false and cannot be set to true.

AutomaticRepairsPolicy

Object

Specifies the configuration parameters for automatic repairs on the virtual machine scale set.

Name	Type	Description
enabled	boolean	Specifies whether automatic repairs should be enabled on the virtual machine scale set. The default value is false.
gracePeriod	string	The amount of time for which automatic repairs are suspended due to a state change on VM. The grace time starts after the state change has completed. This helps avoid premature or accidental repairs. The time duration should be specified in ISO 8601 format. The minimum allowed grace period is 30 minutes (PT30M), which is also the default value. The maximum allowed grace period is 90 minutes (PT90M).

BillingProfile

Object

Specifies the billing related details of a Azure Spot VM or VMSS.

Minimum api-version: 2019-03-01.

Name	Type	Description
maxPrice	number	Specifies the maximum price you are willing to pay for a Azure Spot VM/VMSS. This price is in US Dollars. This price will be compared with the current Azure Spot price for the VM size. Also, the prices are compared at the time of create/update of Azure Spot VM/VMSS and the operation will only succeed if the maxPrice is greater than the current Azure Spot price. The maxPrice will also be used for evicting a Azure Spot VM/VMSS if the current Azure Spot price goes beyond the maxPrice after creation of VM/VMSS. Possible values are: - Any decimal value greater than zero. Example: 0.01538 -1 – indicates default price to be up-to on-demand. You can set the maxPrice to -1 to indicate that the Azure Spot VM/VMSS should not be evicted for price reasons. Also, the default max price is -1 if it is not provided by you. Minimum api-version: 2019-03-01.

BootDiagnostics

Object

Boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status.

You can easily view the output of your console log.

Azure also enables you to see a screenshot of the VM from the hypervisor.

Name	Type	Description
enabled	boolean	Whether boot diagnostics should be enabled on the Virtual Machine.
storageUri	string	Uri of the storage account to use for placing the console output and screenshot. If storageUri is not specified while enabling boot diagnostics, managed storage will be used.

CachingTypes

Enumeration

Gets the caching type.

Value	Description
None
ReadOnly
ReadWrite

CapacityReservationProfile

Object

The parameters of a capacity reservation Profile.

Name	Type	Description
capacityReservationGroup	SubResource	Specifies the capacity reservation group resource id that should be used for allocating the virtual machine or scaleset vm instances provided enough capacity has been reserved. Please refer to https://aka.ms/CapacityReservation for more details.

ComponentNames

Enumeration

The component name. Currently, the only allowable value is Microsoft-Windows-Shell-Setup.

Value	Description
Microsoft-Windows-Shell-Setup

DeleteOptions

Enumeration

Specify what happens to the network interface when the VM is deleted

Value	Description
Delete
Detach

DiagnosticsProfile

Object

Specifies the boot diagnostic settings state.

Minimum api-version: 2015-06-15.

Name	Type	Description
bootDiagnostics	BootDiagnostics	Boot Diagnostics is a debugging feature which allows you to view Console Output and Screenshot to diagnose VM status. You can easily view the output of your console log. Azure also enables you to see a screenshot of the VM from the hypervisor.

DiffDiskOptions

Enumeration

Specifies the ephemeral disk settings for operating system disk.

Value	Description
Local

DiffDiskPlacement

Enumeration

Specifies the ephemeral disk placement for operating system disk. This property can be used by user in the request to choose the location i.e, cache disk or resource disk space for Ephemeral OS disk provisioning. For more information on Ephemeral OS disk size requirements, please refer Ephemeral OS disk size requirements for Windows VM at https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements and Linux VM at https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

Value	Description
CacheDisk
ResourceDisk

DiffDiskSettings

Object

Describes the parameters of ephemeral disk settings that can be specified for operating system disk.

NOTE: The ephemeral disk settings can only be specified for managed disk.

Name	Type	Description
option	DiffDiskOptions	Specifies the ephemeral disk settings for operating system disk.
placement	DiffDiskPlacement	Specifies the ephemeral disk placement for operating system disk. Possible values are: CacheDisk ResourceDisk Default: CacheDisk if one is configured for the VM size otherwise ResourceDisk is used. Refer to VM size documentation for Windows VM at https://docs.microsoft.com/azure/virtual-machines/windows/sizes and Linux VM at https://docs.microsoft.com/azure/virtual-machines/linux/sizes to check which VM sizes exposes a cache disk.

DiskCreateOptionTypes

Enumeration

Specifies how the virtual machine should be created.

Possible values are:

Attach \u2013 This value is used when you are using a specialized disk to create the virtual machine.

FromImage \u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described.

Value	Description
Attach
Empty
FromImage

DiskEncryptionSetParameters

Object

Describes the parameter of customer managed disk encryption set resource id that can be specified for disk.

NOTE: The disk encryption set resource id can only be specified for managed disk. Please refer https://aka.ms/mdssewithcmkoverview for more details.

Name	Type	Description
id	string	Resource Id

ExtendedLocation

Object

The complex type of the extended location.

Name	Type	Description
name	string	The name of the extended location.
type	ExtendedLocationTypes	The type of the extended location.

ExtendedLocationTypes

Enumeration

The type of the extended location.

Value	Description
EdgeZone

ImageReference

Object

Specifies information about the image to use. You can specify information about platform images, marketplace images, or virtual machine images. This element is required when you want to use a platform image, marketplace image, or virtual machine image, but is not used in other creation operations. NOTE: Image reference publisher and offer can only be set when you create the scale set.

Name	Type	Description
exactVersion	string	Specifies in decimal numbers, the version of platform image or marketplace image used to create the virtual machine. This readonly field differs from 'version', only if the value specified in 'version' field is 'latest'.
id	string	Resource Id
offer	string	Specifies the offer of the platform image or marketplace image used to create the virtual machine.
publisher	string	The image publisher.
sku	string	The image SKU.
version	string	Specifies the version of the platform image or marketplace image used to create the virtual machine. The allowed formats are Major.Minor.Build or 'latest'. Major, Minor, and Build are decimal numbers. Specify 'latest' to use the latest version of an image available at deploy time. Even if you use 'latest', the VM image will not automatically update after deploy time even if a new version becomes available.

IPVersion

Enumeration

Available from Api-Version 2019-07-01 onwards, it represents whether the specific ipconfiguration is IPv4 or IPv6. Default is taken as IPv4. Possible values are: 'IPv4' and 'IPv6'.

Value	Description
IPv4
IPv6

LinuxConfiguration

Object

Specifies the Linux operating system settings on the virtual machine.

For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions.

Name	Type	Description
disablePasswordAuthentication	boolean	Specifies whether password authentication should be disabled.
patchSettings	LinuxPatchSettings	[Preview Feature] Specifies settings related to VM Guest Patching on Linux.
provisionVMAgent	boolean	Indicates whether virtual machine agent should be provisioned on the virtual machine. When this property is not specified in the request body, default behavior is to set it to true. This will ensure that VM Agent is installed on the VM so that extensions can be added to the VM later.
ssh	SshConfiguration	Specifies the ssh key configuration for a Linux OS.

LinuxPatchAssessmentMode

Enumeration

Specifies the mode of VM Guest Patch Assessment for the IaaS virtual machine.

Possible values are:

ImageDefault - You control the timing of patch assessments on a virtual machine.

AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.

Value	Description
AutomaticByPlatform
ImageDefault

LinuxPatchSettings

Object

Specifies settings related to VM Guest Patching on Linux.

Name	Type	Description
assessmentMode	LinuxPatchAssessmentMode	Specifies the mode of VM Guest Patch Assessment for the IaaS virtual machine. Possible values are: ImageDefault - You control the timing of patch assessments on a virtual machine. AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.
patchMode	LinuxVMGuestPatchMode	Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible. Possible values are: ImageDefault - The virtual machine's default patching configuration is used. AutomaticByPlatform - The virtual machine will be automatically updated by the platform. The property provisionVMAgent must be true

LinuxVMGuestPatchMode

Enumeration

Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible.

Possible values are:

ImageDefault - The virtual machine's default patching configuration is used.

AutomaticByPlatform - The virtual machine will be automatically updated by the platform. The property provisionVMAgent must be true

Value	Description
AutomaticByPlatform
ImageDefault

NetworkApiVersion

Enumeration

specifies the Microsoft.Network API version used when creating networking resources in the Network Interface Configurations

Value	Description
2020-11-01

OperatingSystemTypes

Enumeration

The operating system of the osDiskImage.

Value	Description
Linux
Windows

OrchestrationMode

Enumeration

Specifies the orchestration mode for the virtual machine scale set.

Value	Description
Flexible
Uniform

PassNames

Enumeration

The pass name. Currently, the only allowable value is OobeSystem.

Value	Description
OobeSystem

PatchSettings

Object

Specifies settings related to VM Guest Patching on Windows.

Name	Type	Description
assessmentMode	WindowsPatchAssessmentMode	Specifies the mode of VM Guest patch assessment for the IaaS virtual machine. Possible values are: ImageDefault - You control the timing of patch assessments on a virtual machine. AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.
enableHotpatching	boolean	Enables customers to patch their Azure VMs without requiring a reboot. For enableHotpatching, the 'provisionVMAgent' must be set to true and 'patchMode' must be set to 'AutomaticByPlatform'.
patchMode	WindowsVMGuestPatchMode	Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible. Possible values are: Manual - You control the application of patches to a virtual machine. You do this by applying patches manually inside the VM. In this mode, automatic updates are disabled; the property WindowsConfiguration.enableAutomaticUpdates must be false AutomaticByOS - The virtual machine will automatically be updated by the OS. The property WindowsConfiguration.enableAutomaticUpdates must be true. AutomaticByPlatform - the virtual machine will automatically updated by the platform. The properties provisionVMAgent and WindowsConfiguration.enableAutomaticUpdates must be true

Plan

Object

Specifies information about the marketplace image used to create the virtual machine. This element is only used for marketplace images. Before you can use a marketplace image from an API, you must enable the image for programmatic use. In the Azure portal, find the marketplace image that you want to use and then click Want to deploy programmatically, Get Started ->. Enter any required information and then click Save.

Name	Type	Description
name	string	The plan ID.
product	string	Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element.
promotionCode	string	The promotion code.
publisher	string	The publisher ID.

ProtocolTypes

Enumeration

Specifies the protocol of WinRM listener.

Possible values are:
http

https

Value	Description
Http
Https

PublicIPAddressSku

Object

Describes the public IP Sku

Name	Type	Description
name	PublicIPAddressSkuName	Specify public IP sku name
tier	PublicIPAddressSkuTier	Specify public IP sku tier

PublicIPAddressSkuName

Enumeration

Specify public IP sku name

Value	Description
Basic
Standard

PublicIPAddressSkuTier

Enumeration

Specify public IP sku tier

Value	Description
Global
Regional

ResourceIdentityType

Enumeration

The type of identity used for the virtual machine. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine.

Value	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

RollingUpgradePolicy

Object

The configuration parameters used while performing a rolling upgrade.

Name	Type	Description
enableCrossZoneUpgrade	boolean	Allow VMSS to ignore AZ boundaries when constructing upgrade batches. Take into consideration the Update Domain and maxBatchInstancePercent to determine the batch size.
maxBatchInstancePercent	integer	The maximum percent of total virtual machine instances that will be upgraded simultaneously by the rolling upgrade in one batch. As this is a maximum, unhealthy instances in previous or future batches can cause the percentage of instances in a batch to decrease to ensure higher reliability. The default value for this parameter is 20%.
maxUnhealthyInstancePercent	integer	The maximum percentage of the total virtual machine instances in the scale set that can be simultaneously unhealthy, either as a result of being upgraded, or by being found in an unhealthy state by the virtual machine health checks before the rolling upgrade aborts. This constraint will be checked prior to starting any batch. The default value for this parameter is 20%.
maxUnhealthyUpgradedInstancePercent	integer	The maximum percentage of upgraded virtual machine instances that can be found to be in an unhealthy state. This check will happen after each batch is upgraded. If this percentage is ever exceeded, the rolling update aborts. The default value for this parameter is 20%.
pauseTimeBetweenBatches	string	The wait time between completing the update for all virtual machines in one batch and starting the next batch. The time duration should be specified in ISO 8601 format. The default value is 0 seconds (PT0S).
prioritizeUnhealthyInstances	boolean	Upgrade all unhealthy instances in a scale set before any healthy instances.

ScaleInPolicy

Object

Describes a scale-in policy for a virtual machine scale set.

Name	Type	Description
rules	VirtualMachineScaleSetScaleInRules[]	The rules to be followed when scaling-in a virtual machine scale set. Possible values are: Default When a virtual machine scale set is scaled in, the scale set will first be balanced across zones if it is a zonal scale set. Then, it will be balanced across Fault Domains as far as possible. Within each Fault Domain, the virtual machines chosen for removal will be the newest ones that are not protected from scale-in. OldestVM When a virtual machine scale set is being scaled-in, the oldest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the oldest virtual machines that are not protected will be chosen for removal. NewestVM When a virtual machine scale set is being scaled-in, the newest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the newest virtual machines that are not protected will be chosen for removal.

ScheduledEventsProfile

Object

Name	Type	Description
terminateNotificationProfile	TerminateNotificationProfile	Specifies Terminate Scheduled Event related configurations.

SecurityProfile

Object

Specifies the Security profile settings for the virtual machine or virtual machine scale set.

Name	Type	Description
encryptionAtHost	boolean	This property can be used by user in the request to enable or disable the Host Encryption for the virtual machine or virtual machine scale set. This will enable the encryption for all the disks including Resource/Temp disk at host itself. Default: The Encryption at host will be disabled unless this property is set to true for the resource.
securityType	SecurityTypes	Specifies the SecurityType of the virtual machine. It is set as TrustedLaunch to enable UefiSettings. Default: UefiSettings will not be enabled unless this property is set as TrustedLaunch.
uefiSettings	UefiSettings	Specifies the security settings like secure boot and vTPM used while creating the virtual machine. Minimum api-version: 2020-12-01

SecurityTypes

Enumeration

Specifies the SecurityType of the virtual machine. It is set as TrustedLaunch to enable UefiSettings.

Default: UefiSettings will not be enabled unless this property is set as TrustedLaunch.

Value	Description
TrustedLaunch

SettingNames

Enumeration

Specifies the name of the setting to which the content applies. Possible values are: FirstLogonCommands and AutoLogon.

Value	Description
AutoLogon
FirstLogonCommands

Sku

Object

Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name.

Name	Type	Description
capacity	integer	Specifies the number of virtual machines in the scale set.
name	string	The sku name.
tier	string	Specifies the tier of virtual machines in a scale set. Possible Values: Standard Basic

SpotRestorePolicy

Object

Specifies the Spot-Try-Restore properties for the virtual machine scale set.

With this property customer can enable or disable automatic restore of the evicted Spot VMSS VM instances opportunistically based on capacity availability and pricing constraint.

Name	Type	Description
enabled	boolean	Enables the Spot-Try-Restore feature where evicted VMSS SPOT instances will be tried to be restored opportunistically based on capacity availability and pricing constraints
restoreTimeout	string	Timeout value expressed as an ISO 8601 time duration after which the platform will not try to restore the VMSS SPOT instances

SshConfiguration

Object

SSH configuration for Linux based VMs running on Azure

Name	Type	Description
publicKeys	SshPublicKey[]	The list of SSH public keys used to authenticate with linux based VMs.

SshPublicKey

Object

Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed.

Name	Type	Description
keyData	string	SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys

StorageAccountTypes

Enumeration

Specifies the storage account type for the managed disk. NOTE: UltraSSD_LRS can only be used with data disks, it cannot be used with OS Disk.

Value	Description
Premium_LRS
Premium_ZRS
StandardSSD_LRS
StandardSSD_ZRS
Standard_LRS
UltraSSD_LRS

SubResource

Object

Name	Type	Description
id	string	Resource Id

TerminateNotificationProfile

Object

Name	Type	Description
enable	boolean	Specifies whether the Terminate Scheduled event is enabled or disabled.
notBeforeTimeout	string	Configurable length of time a Virtual Machine being deleted will have to potentially approve the Terminate Scheduled Event before the event is auto approved (timed out). The configuration must be specified in ISO 8601 format, the default value is 5 minutes (PT5M)

UefiSettings

Object

Specifies the security settings like secure boot and vTPM used while creating the virtual machine.

Minimum api-version: 2020-12-01

Name	Type	Description
secureBootEnabled	boolean	Specifies whether secure boot should be enabled on the virtual machine. Minimum api-version: 2020-12-01
vTpmEnabled	boolean	Specifies whether vTPM should be enabled on the virtual machine. Minimum api-version: 2020-12-01

UpgradeMode

Enumeration

Specifies the mode of an upgrade to virtual machines in the scale set.

Possible values are:

Manual - You control the application of updates to virtual machines in the scale set. You do this by using the manualUpgrade action.

Automatic - All virtual machines in the scale set are automatically updated at the same time.

Value	Description
Automatic
Manual
Rolling

UpgradePolicy

Object

Describes an upgrade policy - automatic, manual, or rolling.

Name	Type	Description
automaticOSUpgradePolicy	AutomaticOSUpgradePolicy	Configuration parameters used for performing automatic OS Upgrade.
mode	UpgradeMode	Specifies the mode of an upgrade to virtual machines in the scale set. Possible values are: Manual - You control the application of updates to virtual machines in the scale set. You do this by using the manualUpgrade action. Automatic - All virtual machines in the scale set are automatically updated at the same time.
rollingUpgradePolicy	RollingUpgradePolicy	The configuration parameters used while performing a rolling upgrade.

UserAssignedIdentities

Object

The list of user identities associated with the Virtual Machine. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Name	Type	Description

VaultCertificate

Object

Describes a single certificate reference in a Key Vault, and where the certificate should reside on the VM.

Name	Type	Description
certificateStore	string	For Windows VMs, specifies the certificate store on the Virtual Machine to which the certificate should be added. The specified certificate store is implicitly in the LocalMachine account. For Linux VMs, the certificate file is placed under the /var/lib/waagent directory, with the file name <UppercaseThumbprint>.crt for the X509 certificate file and <UppercaseThumbprint>.prv for private key. Both of these files are .pem formatted.
certificateUrl	string	This is the URL of a certificate that has been uploaded to Key Vault as a secret. For adding a secret to the Key Vault, see Add a key or secret to the key vault. In this case, your certificate needs to be It is the Base64 encoding of the following JSON Object which is encoded in UTF-8: { "data":"", "dataType":"pfx", "password":"" } To install certificates on a virtual machine it is recommended to use the Azure Key Vault virtual machine extension for Linux or the Azure Key Vault virtual machine extension for Windows.

VaultSecretGroup

Object

Describes a set of certificates which are all in the same Key Vault.

Name	Type	Description
sourceVault	SubResource	The relative URL of the Key Vault containing all of the certificates in VaultCertificates.
vaultCertificates	VaultCertificate[]	The list of key vault references in SourceVault which contain certificates.

VirtualHardDisk

Object

Describes the uri of a disk.

Name	Type	Description
uri	string	Specifies the virtual hard disk's uri.

VirtualMachineEvictionPolicyTypes

Enumeration

Specifies the eviction policy for the Azure Spot virtual machine and Azure Spot scale set.

For Azure Spot virtual machines, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2019-03-01.

For Azure Spot scale sets, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2017-10-30-preview.

Value	Description
Deallocate
Delete

VirtualMachinePriorityTypes

Enumeration

Specifies the priority for the virtual machine.

Minimum api-version: 2019-03-01

Value	Description
Low
Regular
Spot

VirtualMachineScaleSet

Object

Describes a Virtual Machine Scale Set.

Name	Type	Description
extendedLocation	ExtendedLocation	The extended location of the Virtual Machine Scale Set.
id	string	Resource Id
identity	VirtualMachineScaleSetIdentity	The identity of the virtual machine scale set, if configured.
location	string	Resource location
name	string	Resource name
plan	Plan	Specifies information about the marketplace image used to create the virtual machine. This element is only used for marketplace images. Before you can use a marketplace image from an API, you must enable the image for programmatic use. In the Azure portal, find the marketplace image that you want to use and then click Want to deploy programmatically, Get Started ->. Enter any required information and then click Save.
properties.additionalCapabilities	AdditionalCapabilities	Specifies additional capabilities enabled or disabled on the Virtual Machines in the Virtual Machine Scale Set. For instance: whether the Virtual Machines have the capability to support attaching managed data disks with UltraSSD_LRS storage account type.
properties.automaticRepairsPolicy	AutomaticRepairsPolicy	Policy for automatic repairs.
properties.doNotRunExtensionsOnOverprovisionedVMs	boolean	When Overprovision is enabled, extensions are launched only on the requested number of VMs which are finally kept. This property will hence ensure that the extensions do not run on the extra overprovisioned VMs.
properties.hostGroup	SubResource	Specifies information about the dedicated host group that the virtual machine scale set resides in. Minimum api-version: 2020-06-01.
properties.orchestrationMode	OrchestrationMode	Specifies the orchestration mode for the virtual machine scale set.
properties.overprovision	boolean	Specifies whether the Virtual Machine Scale Set should be overprovisioned.
properties.platformFaultDomainCount	integer	Fault Domain count for each placement group.
properties.provisioningState	string	The provisioning state, which only appears in the response.
properties.proximityPlacementGroup	SubResource	Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. Minimum api-version: 2018-04-01.
properties.scaleInPolicy	ScaleInPolicy	Specifies the scale-in policy that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in.
properties.singlePlacementGroup	boolean	When true this limits the scale set to a single placement group, of max size 100 virtual machines. NOTE: If singlePlacementGroup is true, it may be modified to false. However, if singlePlacementGroup is false, it may not be modified to true.
properties.spotRestorePolicy	SpotRestorePolicy	Specifies the Spot Restore properties for the virtual machine scale set.
properties.uniqueId	string	Specifies the ID which uniquely identifies a Virtual Machine Scale Set.
properties.upgradePolicy	UpgradePolicy	The upgrade policy.
properties.virtualMachineProfile	VirtualMachineScaleSetVMProfile	The virtual machine profile.
properties.zoneBalance	boolean	Whether to force strictly even Virtual Machine distribution cross x-zones in case there is zone outage. zoneBalance property can only be set if the zones property of the scale set contains more than one zone. If there are no zones or only one zone specified, then zoneBalance property should not be set.
sku	Sku	The virtual machine scale set sku.
tags	object	Resource tags
type	string	Resource type
zones	string[]	The virtual machine scale set zones. NOTE: Availability zones can only be set when you create the scale set

VirtualMachineScaleSetDataDisk

Object

Describes a virtual machine scale set data disk.

Name	Type	Description
caching	CachingTypes	Specifies the caching requirements. Possible values are: None ReadOnly ReadWrite Default: None for Standard storage. ReadOnly for Premium storage
createOption	DiskCreateOptionTypes	The create option.
diskIOPSReadWrite	integer	Specifies the Read-Write IOPS for the managed disk. Should be used only when StorageAccountType is UltraSSD_LRS. If not specified, a default value would be assigned based on diskSizeGB.
diskMBpsReadWrite	integer	Specifies the bandwidth in MB per second for the managed disk. Should be used only when StorageAccountType is UltraSSD_LRS. If not specified, a default value would be assigned based on diskSizeGB.
diskSizeGB	integer	Specifies the size of an empty data disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. This value cannot be larger than 1023 GB
lun	integer	Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	The managed disk parameters.
name	string	The disk name.
writeAcceleratorEnabled	boolean	Specifies whether writeAccelerator should be enabled or disabled on the disk.

VirtualMachineScaleSetExtension

Object

Describes a Virtual Machine Scale Set Extension.

Name	Type	Description
id	string	Resource Id
name	string	The name of the extension.
properties.autoUpgradeMinorVersion	boolean	Indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true.
properties.enableAutomaticUpgrade	boolean	Indicates whether the extension should be automatically upgraded by the platform if there is a newer version of the extension available.
properties.forceUpdateTag	string	If a value is provided and is different from the previous value, the extension handler will be forced to update even if the extension configuration has not changed.
properties.protectedSettings	object	The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all.
properties.provisionAfterExtensions	string[]	Collection of extension names after which this extension needs to be provisioned.
properties.provisioningState	string	The provisioning state, which only appears in the response.
properties.publisher	string	The name of the extension handler publisher.
properties.settings	object	Json formatted public settings for the extension.
properties.type	string	Specifies the type of the extension; an example is "CustomScriptExtension".
properties.typeHandlerVersion	string	Specifies the version of the script handler.
type	string	Resource type

VirtualMachineScaleSetExtensionProfile

Object

Describes a virtual machine scale set extension profile.

Name	Type	Description
extensions	VirtualMachineScaleSetExtension[]	The virtual machine scale set child extension resources.
extensionsTimeBudget	string	Specifies the time alloted for all extensions to start. The time duration should be between 15 minutes and 120 minutes (inclusive) and should be specified in ISO 8601 format. The default value is 90 minutes (PT1H30M). Minimum api-version: 2020-06-01

VirtualMachineScaleSetIdentity

Object

Identity for the virtual machine scale set.

Name	Type	Description
principalId	string	The principal id of virtual machine scale set identity. This property will only be provided for a system assigned identity.
tenantId	string	The tenant id associated with the virtual machine scale set. This property will only be provided for a system assigned identity.
type	ResourceIdentityType	The type of identity used for the virtual machine scale set. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine scale set.
userAssignedIdentities	UserAssignedIdentities	The list of user identities associated with the virtual machine scale set. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

VirtualMachineScaleSetIPConfiguration

Object

Describes a virtual machine scale set network profile's IP configuration.

Name	Type	Description
id	string	Resource Id
name	string	The IP configuration name.
properties.applicationGatewayBackendAddressPools	SubResource[]	Specifies an array of references to backend address pools of application gateways. A scale set can reference backend address pools of multiple application gateways. Multiple scale sets cannot use the same application gateway.
properties.applicationSecurityGroups	SubResource[]	Specifies an array of references to application security group.
properties.loadBalancerBackendAddressPools	SubResource[]	Specifies an array of references to backend address pools of load balancers. A scale set can reference backend address pools of one public and one internal load balancer. Multiple scale sets cannot use the same basic sku load balancer.
properties.loadBalancerInboundNatPools	SubResource[]	Specifies an array of references to inbound Nat pools of the load balancers. A scale set can reference inbound nat pools of one public and one internal load balancer. Multiple scale sets cannot use the same basic sku load balancer.
properties.primary	boolean	Specifies the primary network interface in case the virtual machine has more than 1 network interface.
properties.privateIPAddressVersion	IPVersion	Available from Api-Version 2017-03-30 onwards, it represents whether the specific ipconfiguration is IPv4 or IPv6. Default is taken as IPv4. Possible values are: 'IPv4' and 'IPv6'.
properties.publicIPAddressConfiguration	VirtualMachineScaleSetPublicIPAddressConfiguration	The publicIPAddressConfiguration.
properties.subnet	ApiEntityReference	Specifies the identifier of the subnet.

VirtualMachineScaleSetIpTag

Object

Contains the IP tag associated with the public IP address.

Name	Type	Description
ipTagType	string	IP tag type. Example: FirstPartyUsage.
tag	string	IP tag associated with the public IP. Example: SQL, Storage etc.

VirtualMachineScaleSetManagedDiskParameters

Object

Describes the parameters of a ScaleSet managed disk.

Name	Type	Description
diskEncryptionSet	DiskEncryptionSetParameters	Specifies the customer managed disk encryption set resource id for the managed disk.
storageAccountType	StorageAccountTypes	Specifies the storage account type for the managed disk. NOTE: UltraSSD_LRS can only be used with data disks, it cannot be used with OS Disk.

VirtualMachineScaleSetNetworkConfiguration

Object

Describes a virtual machine scale set network profile's network configurations.

Name	Type	Description
id	string	Resource Id
name	string	The network configuration name.
properties.deleteOption	DeleteOptions	Specify what happens to the network interface when the VM is deleted
properties.dnsSettings	VirtualMachineScaleSetNetworkConfigurationDnsSettings	The dns settings to be applied on the network interfaces.
properties.enableAcceleratedNetworking	boolean	Specifies whether the network interface is accelerated networking-enabled.
properties.enableFpga	boolean	Specifies whether the network interface is FPGA networking-enabled.
properties.enableIPForwarding	boolean	Whether IP forwarding enabled on this NIC.
properties.ipConfigurations	VirtualMachineScaleSetIPConfiguration[]	Specifies the IP configurations of the network interface.
properties.networkSecurityGroup	SubResource	The network security group.
properties.primary	boolean	Specifies the primary network interface in case the virtual machine has more than 1 network interface.

VirtualMachineScaleSetNetworkConfigurationDnsSettings

Object

Describes a virtual machines scale sets network configuration's DNS settings.

Name	Type	Description
dnsServers	string[]	List of DNS servers IP addresses

VirtualMachineScaleSetNetworkProfile

Object

Describes a virtual machine scale set network profile.

Name	Type	Description
healthProbe	ApiEntityReference	A reference to a load balancer probe used to determine the health of an instance in the virtual machine scale set. The reference will be in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.
networkApiVersion	NetworkApiVersion	specifies the Microsoft.Network API version used when creating networking resources in the Network Interface Configurations for Virtual Machine Scale Set with orchestration mode 'Flexible'
networkInterfaceConfigurations	VirtualMachineScaleSetNetworkConfiguration[]	The list of network configurations.

VirtualMachineScaleSetOSDisk

Object

Describes a virtual machine scale set operating system disk.

Name	Type	Description
caching	CachingTypes	Specifies the caching requirements. Possible values are: None ReadOnly ReadWrite Default: None for Standard storage. ReadOnly for Premium storage
createOption	DiskCreateOptionTypes	Specifies how the virtual machines in the scale set should be created. The only allowed value is: FromImage \u2013 This value is used when you are using an image to create the virtual machine. If you are using a platform image, you also use the imageReference element described above. If you are using a marketplace image, you also use the plan element previously described.
diffDiskSettings	DiffDiskSettings	Specifies the ephemeral disk Settings for the operating system disk used by the virtual machine scale set.
diskSizeGB	integer	Specifies the size of the operating system disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. This value cannot be larger than 1023 GB
image	VirtualHardDisk	Specifies information about the unmanaged user image to base the scale set on.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	The managed disk parameters.
name	string	The disk name.
osType	OperatingSystemTypes	This property allows you to specify the type of the OS that is included in the disk if creating a VM from user-image or a specialized VHD. Possible values are: Windows Linux
vhdContainers	string[]	Specifies the container urls that are used to store operating system disks for the scale set.
writeAcceleratorEnabled	boolean	Specifies whether writeAccelerator should be enabled or disabled on the disk.

VirtualMachineScaleSetOSProfile

Object

Describes a virtual machine scale set OS profile.

Name	Type	Description
adminPassword	string	Specifies the password of the administrator account. Minimum-length (Windows): 8 characters Minimum-length (Linux): 6 characters Max-length (Windows): 123 characters Max-length (Linux): 72 characters Complexity requirements: 3 out of 4 conditions below need to be fulfilled Has lower characters Has upper characters Has a digit Has a special character (Regex match [\W_]) Disallowed values: "abc@123", "P@$$w0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" For resetting the password, see How to reset the Remote Desktop service or its login password in a Windows VM For resetting root password, see Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension
adminUsername	string	Specifies the name of the administrator account. Windows-only restriction: Cannot end in "." Disallowed values: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Minimum-length (Linux): 1 character Max-length (Linux): 64 characters Max-length (Windows): 20 characters
computerNamePrefix	string	Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 15 characters long.
customData	string	Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on the Virtual Machine. The maximum length of the binary array is 65535 bytes. For using cloud-init for your VM, see Using cloud-init to customize a Linux VM during creation
linuxConfiguration	LinuxConfiguration	Specifies the Linux operating system settings on the virtual machine. For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions.
secrets	VaultSecretGroup[]	Specifies set of certificates that should be installed onto the virtual machines in the scale set. To install certificates on a virtual machine it is recommended to use the Azure Key Vault virtual machine extension for Linux or the Azure Key Vault virtual machine extension for Windows.
windowsConfiguration	WindowsConfiguration	Specifies Windows operating system settings on the virtual machine.

VirtualMachineScaleSetPublicIPAddressConfiguration

Object

Describes a virtual machines scale set IP Configuration's PublicIPAddress configuration

Name	Type	Description
name	string	The publicIP address configuration name.
properties.deleteOption	DeleteOptions	Specify what happens to the public IP when the VM is deleted
properties.dnsSettings	VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	The dns settings to be applied on the publicIP addresses .
properties.idleTimeoutInMinutes	integer	The idle timeout of the public IP address.
properties.ipTags	VirtualMachineScaleSetIpTag[]	The list of IP tags associated with the public IP address.
properties.publicIPAddressVersion	IPVersion	Available from Api-Version 2019-07-01 onwards, it represents whether the specific ipconfiguration is IPv4 or IPv6. Default is taken as IPv4. Possible values are: 'IPv4' and 'IPv6'.
properties.publicIPPrefix	SubResource	The PublicIPPrefix from which to allocate publicIP addresses.
sku	PublicIPAddressSku	Describes the public IP Sku

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

Object

Describes a virtual machines scale sets network configuration's DNS settings.

Name	Type	Description
domainNameLabel	string	The Domain name label.The concatenation of the domain name label and vm index will be the domain name labels of the PublicIPAddress resources that will be created

VirtualMachineScaleSetScaleInRules

Enumeration

The rules to be followed when scaling-in a virtual machine scale set.

Possible values are:

Default When a virtual machine scale set is scaled in, the scale set will first be balanced across zones if it is a zonal scale set. Then, it will be balanced across Fault Domains as far as possible. Within each Fault Domain, the virtual machines chosen for removal will be the newest ones that are not protected from scale-in.

OldestVM When a virtual machine scale set is being scaled-in, the oldest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the oldest virtual machines that are not protected will be chosen for removal.

NewestVM When a virtual machine scale set is being scaled-in, the newest virtual machines that are not protected from scale-in will be chosen for removal. For zonal virtual machine scale sets, the scale set will first be balanced across zones. Within each zone, the newest virtual machines that are not protected will be chosen for removal.

Value	Description
Default
NewestVM
OldestVM

VirtualMachineScaleSetStorageProfile

Object

Describes a virtual machine scale set storage profile.

Name	Type	Description
dataDisks	VirtualMachineScaleSetDataDisk[]	Specifies the parameters that are used to add data disks to the virtual machines in the scale set. For more information about disks, see About disks and VHDs for Azure virtual machines.
imageReference	ImageReference	Specifies information about the image to use. You can specify information about platform images, marketplace images, or virtual machine images. This element is required when you want to use a platform image, marketplace image, or virtual machine image, but is not used in other creation operations.
osDisk	VirtualMachineScaleSetOSDisk	Specifies information about the operating system disk used by the virtual machines in the scale set. For more information about disks, see About disks and VHDs for Azure virtual machines.

VirtualMachineScaleSetUpdate

Object

Describes a Virtual Machine Scale Set.

Name	Type	Description
identity	VirtualMachineScaleSetIdentity	The identity of the virtual machine scale set, if configured.
plan	Plan	The purchase plan when deploying a virtual machine scale set from VM Marketplace images.
properties.additionalCapabilities	AdditionalCapabilities	Specifies additional capabilities enabled or disabled on the Virtual Machines in the Virtual Machine Scale Set. For instance: whether the Virtual Machines have the capability to support attaching managed data disks with UltraSSD_LRS storage account type.
properties.automaticRepairsPolicy	AutomaticRepairsPolicy	Policy for automatic repairs.
properties.doNotRunExtensionsOnOverprovisionedVMs	boolean	When Overprovision is enabled, extensions are launched only on the requested number of VMs which are finally kept. This property will hence ensure that the extensions do not run on the extra overprovisioned VMs.
properties.overprovision	boolean	Specifies whether the Virtual Machine Scale Set should be overprovisioned.
properties.proximityPlacementGroup	SubResource	Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. Minimum api-version: 2018-04-01.
properties.scaleInPolicy	ScaleInPolicy	Specifies the scale-in policy that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in.
properties.singlePlacementGroup	boolean	When true this limits the scale set to a single placement group, of max size 100 virtual machines. NOTE: If singlePlacementGroup is true, it may be modified to false. However, if singlePlacementGroup is false, it may not be modified to true.
properties.upgradePolicy	UpgradePolicy	The upgrade policy.
properties.virtualMachineProfile	VirtualMachineScaleSetUpdateVMProfile	The virtual machine profile.
sku	Sku	The virtual machine scale set sku.
tags	object	Resource tags

VirtualMachineScaleSetUpdateIPConfiguration

Object

Describes a virtual machine scale set network profile's IP configuration. NOTE: The subnet of a scale set may be modified as long as the original subnet and the new subnet are in the same virtual network

Name	Type	Description
id	string	Resource Id
name	string	The IP configuration name.
properties.applicationGatewayBackendAddressPools	SubResource[]	The application gateway backend address pools.
properties.applicationSecurityGroups	SubResource[]	Specifies an array of references to application security group.
properties.loadBalancerBackendAddressPools	SubResource[]	The load balancer backend address pools.
properties.loadBalancerInboundNatPools	SubResource[]	The load balancer inbound nat pools.
properties.primary	boolean	Specifies the primary IP Configuration in case the network interface has more than one IP Configuration.
properties.privateIPAddressVersion	IPVersion	Available from Api-Version 2017-03-30 onwards, it represents whether the specific ipconfiguration is IPv4 or IPv6. Default is taken as IPv4. Possible values are: 'IPv4' and 'IPv6'.
properties.publicIPAddressConfiguration	VirtualMachineScaleSetUpdatePublicIPAddressConfiguration	The publicIPAddressConfiguration.
properties.subnet	ApiEntityReference	The subnet.

VirtualMachineScaleSetUpdateNetworkConfiguration

Object

Describes a virtual machine scale set network profile's network configurations.

Name	Type	Description
id	string	Resource Id
name	string	The network configuration name.
properties.deleteOption	DeleteOptions	Specify what happens to the network interface when the VM is deleted
properties.dnsSettings	VirtualMachineScaleSetNetworkConfigurationDnsSettings	The dns settings to be applied on the network interfaces.
properties.enableAcceleratedNetworking	boolean	Specifies whether the network interface is accelerated networking-enabled.
properties.enableFpga	boolean	Specifies whether the network interface is FPGA networking-enabled.
properties.enableIPForwarding	boolean	Whether IP forwarding enabled on this NIC.
properties.ipConfigurations	VirtualMachineScaleSetUpdateIPConfiguration[]	The virtual machine scale set IP Configuration.
properties.networkSecurityGroup	SubResource	The network security group.
properties.primary	boolean	Whether this is a primary NIC on a virtual machine.

VirtualMachineScaleSetUpdateNetworkProfile

Object

Describes a virtual machine scale set network profile.

Name	Type	Description
healthProbe	ApiEntityReference	A reference to a load balancer probe used to determine the health of an instance in the virtual machine scale set. The reference will be in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.
networkApiVersion	NetworkApiVersion	specifies the Microsoft.Network API version used when creating networking resources in the Network Interface Configurations for Virtual Machine Scale Set with orchestration mode 'Flexible'
networkInterfaceConfigurations	VirtualMachineScaleSetUpdateNetworkConfiguration[]	The list of network configurations.

VirtualMachineScaleSetUpdateOSDisk

Object

Describes virtual machine scale set operating system disk Update Object. This should be used for Updating VMSS OS Disk.

Name	Type	Description
caching	CachingTypes	The caching type.
diskSizeGB	integer	Specifies the size of the operating system disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image. This value cannot be larger than 1023 GB
image	VirtualHardDisk	The Source User Image VirtualHardDisk. This VirtualHardDisk will be copied before using it to attach to the Virtual Machine. If SourceImage is provided, the destination VirtualHardDisk should not exist.
managedDisk	VirtualMachineScaleSetManagedDiskParameters	The managed disk parameters.
vhdContainers	string[]	The list of virtual hard disk container uris.
writeAcceleratorEnabled	boolean	Specifies whether writeAccelerator should be enabled or disabled on the disk.

VirtualMachineScaleSetUpdateOSProfile

Object

Describes a virtual machine scale set OS profile.

Name	Type	Description
customData	string	A base-64 encoded string of custom data.
linuxConfiguration	LinuxConfiguration	The Linux Configuration of the OS profile.
secrets	VaultSecretGroup[]	The List of certificates for addition to the VM.
windowsConfiguration	WindowsConfiguration	The Windows Configuration of the OS profile.

VirtualMachineScaleSetUpdatePublicIPAddressConfiguration

Object

Describes a virtual machines scale set IP Configuration's PublicIPAddress configuration

Name	Type	Description
name	string	The publicIP address configuration name.
properties.deleteOption	DeleteOptions	Specify what happens to the public IP when the VM is deleted
properties.dnsSettings	VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings	The dns settings to be applied on the publicIP addresses .
properties.idleTimeoutInMinutes	integer	The idle timeout of the public IP address.

VirtualMachineScaleSetUpdateStorageProfile

Object

Describes a virtual machine scale set storage profile.

Name	Type	Description
dataDisks	VirtualMachineScaleSetDataDisk[]	The data disks.
imageReference	ImageReference	The image reference.
osDisk	VirtualMachineScaleSetUpdateOSDisk	The OS disk.

VirtualMachineScaleSetUpdateVMProfile

Object

Describes a virtual machine scale set virtual machine profile.

Name	Type	Description
billingProfile	BillingProfile	Specifies the billing related details of a Azure Spot VMSS. Minimum api-version: 2019-03-01.
diagnosticsProfile	DiagnosticsProfile	The virtual machine scale set diagnostics profile.
extensionProfile	VirtualMachineScaleSetExtensionProfile	The virtual machine scale set extension profile.
licenseType	string	The license type, which is for bring your own license scenario.
networkProfile	VirtualMachineScaleSetUpdateNetworkProfile	The virtual machine scale set network profile.
osProfile	VirtualMachineScaleSetUpdateOSProfile	The virtual machine scale set OS profile.
scheduledEventsProfile	ScheduledEventsProfile	Specifies Scheduled Event related configurations.
securityProfile	SecurityProfile	The virtual machine scale set Security profile
storageProfile	VirtualMachineScaleSetUpdateStorageProfile	The virtual machine scale set storage profile.
userData	string	UserData for the VM, which must be base-64 encoded. Customer should not pass any secrets in here. Minimum api-version: 2021-03-01

VirtualMachineScaleSetVMProfile

Object

Describes a virtual machine scale set virtual machine profile.

Name	Type	Description
billingProfile	BillingProfile	Specifies the billing related details of a Azure Spot VMSS. Minimum api-version: 2019-03-01.
capacityReservation	CapacityReservationProfile	Specifies the capacity reservation related details of a scale set. Minimum api-version: 2021-04-01.
diagnosticsProfile	DiagnosticsProfile	Specifies the boot diagnostic settings state. Minimum api-version: 2015-06-15.
evictionPolicy	VirtualMachineEvictionPolicyTypes	Specifies the eviction policy for the Azure Spot virtual machine and Azure Spot scale set. For Azure Spot virtual machines, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2019-03-01. For Azure Spot scale sets, both 'Deallocate' and 'Delete' are supported and the minimum api-version is 2017-10-30-preview.
extensionProfile	VirtualMachineScaleSetExtensionProfile	Specifies a collection of settings for extensions installed on virtual machines in the scale set.
licenseType	string	Specifies that the image or disk that is being used was licensed on-premises. Possible values for Windows Server operating system are: Windows_Client Windows_Server Possible values for Linux Server operating system are: RHEL_BYOS (for RHEL) SLES_BYOS (for SUSE) For more information, see Azure Hybrid Use Benefit for Windows Server Azure Hybrid Use Benefit for Linux Server Minimum api-version: 2015-06-15
networkProfile	VirtualMachineScaleSetNetworkProfile	Specifies properties of the network interfaces of the virtual machines in the scale set.
osProfile	VirtualMachineScaleSetOSProfile	Specifies the operating system settings for the virtual machines in the scale set.
priority	VirtualMachinePriorityTypes	Specifies the priority for the virtual machines in the scale set. Minimum api-version: 2017-10-30-preview
scheduledEventsProfile	ScheduledEventsProfile	Specifies Scheduled Event related configurations.
securityProfile	SecurityProfile	Specifies the Security related profile settings for the virtual machines in the scale set.
storageProfile	VirtualMachineScaleSetStorageProfile	Specifies the storage settings for the virtual machine disks.
userData	string	UserData for the virtual machines in the scale set, which must be base-64 encoded. Customer should not pass any secrets in here. Minimum api-version: 2021-03-01

WindowsConfiguration

Object

Specifies Windows operating system settings on the virtual machine.

Name	Type	Description
additionalUnattendContent	AdditionalUnattendContent[]	Specifies additional base-64 encoded XML formatted information that can be included in the Unattend.xml file, which is used by Windows Setup.
enableAutomaticUpdates	boolean	Indicates whether Automatic Updates is enabled for the Windows virtual machine. Default value is true. For virtual machine scale sets, this property can be updated and updates will take effect on OS reprovisioning.
patchSettings	PatchSettings	[Preview Feature] Specifies settings related to VM Guest Patching on Windows.
provisionVMAgent	boolean	Indicates whether virtual machine agent should be provisioned on the virtual machine. When this property is not specified in the request body, default behavior is to set it to true. This will ensure that VM Agent is installed on the VM so that extensions can be added to the VM later.
timeZone	string	Specifies the time zone of the virtual machine. e.g. "Pacific Standard Time". Possible values can be TimeZoneInfo.Id value from time zones returned by TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Specifies the Windows Remote Management listeners. This enables remote Windows PowerShell.

WindowsPatchAssessmentMode

Enumeration

Specifies the mode of VM Guest patch assessment for the IaaS virtual machine.

Possible values are:

ImageDefault - You control the timing of patch assessments on a virtual machine.

AutomaticByPlatform - The platform will trigger periodic patch assessments. The property provisionVMAgent must be true.

Value	Description
AutomaticByPlatform
ImageDefault

WindowsVMGuestPatchMode

Enumeration

Specifies the mode of VM Guest Patching to IaaS virtual machine or virtual machines associated to virtual machine scale set with OrchestrationMode as Flexible.

Possible values are:

Manual - You control the application of patches to a virtual machine. You do this by applying patches manually inside the VM. In this mode, automatic updates are disabled; the property WindowsConfiguration.enableAutomaticUpdates must be false

AutomaticByOS - The virtual machine will automatically be updated by the OS. The property WindowsConfiguration.enableAutomaticUpdates must be true.

AutomaticByPlatform - the virtual machine will automatically updated by the platform. The properties provisionVMAgent and WindowsConfiguration.enableAutomaticUpdates must be true

Value	Description
AutomaticByOS
AutomaticByPlatform
Manual

WinRMConfiguration

Object

Describes Windows Remote Management configuration of the VM

Name	Type	Description
listeners	WinRMListener[]	The list of Windows Remote Management listeners

WinRMListener

Object

Describes Protocol and thumbprint of Windows Remote Management listener

Name	Type	Description
certificateUrl	string	This is the URL of a certificate that has been uploaded to Key Vault as a secret. For adding a secret to the Key Vault, see Add a key or secret to the key vault. In this case, your certificate needs to be It is the Base64 encoding of the following JSON Object which is encoded in UTF-8: { "data":"", "dataType":"pfx", "password":"" } To install certificates on a virtual machine it is recommended to use the Azure Key Vault virtual machine extension for Linux or the Azure Key Vault virtual machine extension for Windows.
protocol	ProtocolTypes	Specifies the protocol of WinRM listener. Possible values are: http https