VirtualMachineScaleSetProperties interface
Describes the properties of a Virtual Machine Scale Set.
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. |
| constrained |
Optional property which must either be set to True or omitted. |
| 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. |
| external |
Specifies the external health policy for the virtual machine scale set. |
| high |
Specifies the high speed interconnect placement for the virtual machine scale set. |
| host |
Specifies information about the dedicated host group that the virtual machine scale set resides in. Minimum api-version: 2020-06-01. |
| lifecycle |
Specifies the lifecycle hooks profile for the virtual machine scale set. |
| orchestration |
Specifies the orchestration mode for the virtual machine scale set. |
| overprovision | Specifies whether the Virtual Machine Scale Set should be overprovisioned. |
| platform |
Fault Domain count for each placement group. |
| priority |
Specifies the desired targets for mixing Spot and Regular priority VMs within the same VMSS Flex instance. |
| provisioning |
The provisioning state, which only appears in the response. |
| proximity |
Specifies information about the proximity placement group that the virtual machine scale set should be assigned to. Minimum api-version: 2018-04-01. |
| resiliency |
Policy for Resiliency |
| scale |
Specifies the policies applied when scaling in Virtual Machines in the Virtual Machine Scale Set. |
| scheduled |
The ScheduledEventsPolicy. |
| 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 |
Specifies the sku profile for the virtual machine scale set. |
| spot |
Specifies the Spot Restore properties for the virtual machine scale set. |
| time |
Specifies the time at which the Virtual Machine Scale Set resource was created. Minimum api-version: 2021-11-01. |
| unique |
Specifies the ID which uniquely identifies a Virtual Machine Scale Set. |
| upgrade |
The upgrade policy. |
| virtual |
The virtual machine profile. |
| zonal |
Specifies the align mode between Virtual Machine Scale Set compute and storage Fault Domain count. |
| zone |
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. |
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
constrainedMaximumCapacity
Optional property which must either be set to True or omitted.
constrainedMaximumCapacity?: boolean
Property Value
boolean
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
externalHealthPolicy
Specifies the external health policy for the virtual machine scale set.
externalHealthPolicy?: ExternalHealthPolicy
Property Value
highSpeedInterconnectPlacement
Specifies the high speed interconnect placement for the virtual machine scale set.
highSpeedInterconnectPlacement?: string
Property Value
string
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
lifecycleHooksProfile
Specifies the lifecycle hooks profile for the virtual machine scale set.
lifecycleHooksProfile?: LifecycleHooksProfile
Property Value
orchestrationMode
Specifies the orchestration mode for the virtual machine scale set.
orchestrationMode?: string
Property Value
string
overprovision
Specifies whether the Virtual Machine Scale Set should be overprovisioned.
overprovision?: boolean
Property Value
boolean
platformFaultDomainCount
Fault Domain count for each placement group.
platformFaultDomainCount?: number
Property Value
number
priorityMixPolicy
Specifies the desired targets for mixing Spot and Regular priority VMs within the same VMSS Flex instance.
priorityMixPolicy?: PriorityMixPolicy
Property Value
provisioningState
The provisioning state, which only appears in the response.
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
resiliencyPolicy
scaleInPolicy
Specifies the policies applied when scaling in Virtual Machines in the Virtual Machine Scale Set.
scaleInPolicy?: ScaleInPolicy
Property Value
scheduledEventsPolicy
The ScheduledEventsPolicy.
scheduledEventsPolicy?: ScheduledEventsPolicy
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
skuProfile
Specifies the sku profile for the virtual machine scale set.
skuProfile?: SkuProfile
Property Value
spotRestorePolicy
Specifies the Spot Restore properties for the virtual machine scale set.
spotRestorePolicy?: SpotRestorePolicy
Property Value
timeCreated
Specifies the time at which the Virtual Machine Scale Set resource was created. Minimum api-version: 2021-11-01.
timeCreated?: Date
Property Value
Date
uniqueId
Specifies the ID which uniquely identifies a Virtual Machine Scale Set.
uniqueId?: string
Property Value
string
upgradePolicy
virtualMachineProfile
The virtual machine profile.
virtualMachineProfile?: VirtualMachineScaleSetVMProfile
Property Value
zonalPlatformFaultDomainAlignMode
Specifies the align mode between Virtual Machine Scale Set compute and storage Fault Domain count.
zonalPlatformFaultDomainAlignMode?: string
Property Value
string
zoneBalance
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.
zoneBalance?: boolean
Property Value
boolean