VirtualMachineScaleSet interface
Describes a Virtual Machine Scale Set.
- Extends
Properties
additional |
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. |
automatic |
Policy for automatic repairs. |
do |
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. |
host |
Specifies information about the dedicated host group that the virtual machine scale set resides in. |
identity | The identity of the virtual machine scale set, if configured. |
overprovision | Specifies whether the Virtual Machine Scale Set should be overprovisioned. |
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. |
platform |
Fault Domain count for each placement group. |
provisioning |
The provisioning state, which only appears in the response. NOTE: This property will not be serialized. It can only be populated by the server. |
proximity |
Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. |
scale |
Specifies the scale-in policy that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in. |
single |
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. |
sku | The virtual machine scale set sku. |
unique |
Specifies the ID which uniquely identifies a Virtual Machine Scale Set. NOTE: This property will not be serialized. It can only be populated by the server. |
upgrade |
The upgrade policy. |
virtual |
The virtual machine profile. |
zone |
Whether to force strictly even Virtual Machine distribution cross x-zones in case there is zone outage. |
zones | The virtual machine scale set zones. NOTE: Availability zones can only be set when you create the scale set |
Inherited Properties
id | Resource Id NOTE: This property will not be serialized. It can only be populated by the server. |
location | Resource location |
name | Resource name NOTE: This property will not be serialized. It can only be populated by the server. |
tags | Resource tags |
type | Resource type NOTE: This property will not be serialized. It can only be populated by the server. |
Property Details
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.
additionalCapabilities?: AdditionalCapabilities
Property Value
automaticRepairsPolicy
Policy for automatic repairs.
automaticRepairsPolicy?: AutomaticRepairsPolicy
Property Value
doNotRunExtensionsOnOverprovisionedVMs
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.
doNotRunExtensionsOnOverprovisionedVMs?: boolean
Property Value
boolean
hostGroup
Specifies information about the dedicated host group that the virtual machine scale set resides in.
Minimum api-version: 2020-06-01.
hostGroup?: SubResource
Property Value
identity
The identity of the virtual machine scale set, if configured.
identity?: VirtualMachineScaleSetIdentity
Property Value
overprovision
Specifies whether the Virtual Machine Scale Set should be overprovisioned.
overprovision?: boolean
Property Value
boolean
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.
plan?: Plan
Property Value
platformFaultDomainCount
Fault Domain count for each placement group.
platformFaultDomainCount?: number
Property Value
number
provisioningState
The provisioning state, which only appears in the response. NOTE: This property will not be serialized. It can only be populated by the server.
provisioningState?: string
Property Value
string
proximityPlacementGroup
Specifies information about the proximity placement group that the virtual machine scale set should be assigned to.
Minimum api-version: 2018-04-01.
proximityPlacementGroup?: SubResource
Property Value
scaleInPolicy
Specifies the scale-in policy that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in.
scaleInPolicy?: ScaleInPolicy
Property Value
singlePlacementGroup
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.
singlePlacementGroup?: boolean
Property Value
boolean
sku
uniqueId
Specifies the ID which uniquely identifies a Virtual Machine Scale Set. NOTE: This property will not be serialized. It can only be populated by the server.
uniqueId?: string
Property Value
string
upgradePolicy
virtualMachineProfile
The virtual machine profile.
virtualMachineProfile?: VirtualMachineScaleSetVMProfile
Property Value
zoneBalance
Whether to force strictly even Virtual Machine distribution cross x-zones in case there is zone outage.
zoneBalance?: boolean
Property Value
boolean
zones
The virtual machine scale set zones. NOTE: Availability zones can only be set when you create the scale set
zones?: string[]
Property Value
string[]
Inherited Property Details
id
Resource Id NOTE: This property will not be serialized. It can only be populated by the server.
id?: string
Property Value
string
Inherited From Resource.id
location
name
Resource name NOTE: This property will not be serialized. It can only be populated by the server.
name?: string
Property Value
string
Inherited From Resource.name
tags
Resource tags
tags?: {[propertyName: string]: string}
Property Value
{[propertyName: string]: string}
Inherited From Resource.tags
type
Resource type NOTE: This property will not be serialized. It can only be populated by the server.
type?: string
Property Value
string
Inherited From Resource.type