ScaleSet
Manages a virtual machine scale set.
## Disclaimers
Note: The
azure.compute.ScaleSetresource has been superseded by theazure.compute.LinuxVirtualMachineScaleSetandazure.compute.WindowsVirtualMachineScaleSetresources. The existingazure.compute.ScaleSetresource will continue to be available throughout the 2.x releases however is in a feature-frozen state to maintain compatibility - new functionality will instead be added to theazure.compute.LinuxVirtualMachineScaleSetandazure.compute.WindowsVirtualMachineScaleSetresources.
Create a ScaleSet Resource
new ScaleSet(name: string, args: ScaleSetArgs, opts?: CustomResourceOptions);def ScaleSet(resource_name, opts=None, automatic_os_upgrade=None, boot_diagnostics=None, eviction_policy=None, extensions=None, health_probe_id=None, identity=None, license_type=None, location=None, name=None, network_profiles=None, os_profile=None, os_profile_linux_config=None, os_profile_secrets=None, os_profile_windows_config=None, overprovision=None, plan=None, priority=None, proximity_placement_group_id=None, resource_group_name=None, rolling_upgrade_policy=None, single_placement_group=None, sku=None, storage_profile_data_disks=None, storage_profile_image_reference=None, storage_profile_os_disk=None, tags=None, upgrade_policy_mode=None, zones=None, __props__=None);func NewScaleSet(ctx *Context, name string, args ScaleSetArgs, opts ...ResourceOption) (*ScaleSet, error)public ScaleSet(string name, ScaleSetArgs args, CustomResourceOptions? opts = null)- name string
- The unique name of the resource.
- args ScaleSetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- opts ResourceOptions
- A bag of options that control this resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ScaleSetArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ScaleSetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
ScaleSet Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The ScaleSet resource accepts the following input properties:
- Network
Profiles List<ScaleSet Network Profile Args> A collection of network profile block as documented below.
- Os
Profile ScaleSet Os Profile Args A Virtual Machine OS Profile block as documented below.
- Resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- Sku
Scale
Set Sku Args A sku block as documented below.
- Storage
Profile ScaleOs Disk Set Storage Profile Os Disk Args A storage profile os disk block as documented below
- Upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- Automatic
Os boolUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- Boot
Diagnostics ScaleSet Boot Diagnostics Args A boot diagnostics profile block as referenced below.
- Eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- Extensions
List<Scale
Set Extension Args> Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- Health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- Identity
Scale
Set Identity Args - License
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- Location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- Os
Profile ScaleLinux Config Set Os Profile Linux Config Args A Linux config block as documented below.
- Os
Profile List<ScaleSecrets Set Os Profile Secret Args> A collection of Secret blocks as documented below.
- Os
Profile ScaleWindows Config Set Os Profile Windows Config Args A Windows config block as documented below.
- Overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- Plan
Scale
Set Plan Args A plan block as documented below.
- Priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- Proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- Rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy Args A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- Single
Placement boolGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- Storage
Profile List<ScaleData Disks Set Storage Profile Data Disk Args> A storage profile data disk block as documented below
- Storage
Profile ScaleImage Reference Set Storage Profile Image Reference Args A storage profile image reference block as documented below.
- Dictionary<string, string>
A mapping of tags to assign to the resource.
- Zones List<string>
A collection of availability zones to spread the Virtual Machines over.
- Network
Profiles []ScaleSet Network Profile A collection of network profile block as documented below.
- Os
Profile ScaleSet Os Profile A Virtual Machine OS Profile block as documented below.
- Resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- Sku
Scale
Set Sku A sku block as documented below.
- Storage
Profile ScaleOs Disk Set Storage Profile Os Disk A storage profile os disk block as documented below
- Upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- Automatic
Os boolUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- Boot
Diagnostics ScaleSet Boot Diagnostics A boot diagnostics profile block as referenced below.
- Eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- Extensions
[]Scale
Set Extension Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- Health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- Identity
Scale
Set Identity - License
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- Location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- Os
Profile ScaleLinux Config Set Os Profile Linux Config A Linux config block as documented below.
- Os
Profile []ScaleSecrets Set Os Profile Secret A collection of Secret blocks as documented below.
- Os
Profile ScaleWindows Config Set Os Profile Windows Config A Windows config block as documented below.
- Overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- Plan
Scale
Set Plan A plan block as documented below.
- Priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- Proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- Rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- Single
Placement boolGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- Storage
Profile []ScaleData Disks Set Storage Profile Data Disk A storage profile data disk block as documented below
- Storage
Profile ScaleImage Reference Set Storage Profile Image Reference A storage profile image reference block as documented below.
- map[string]string
A mapping of tags to assign to the resource.
- Zones []string
A collection of availability zones to spread the Virtual Machines over.
- network
Profiles ScaleSet Network Profile[] A collection of network profile block as documented below.
- os
Profile ScaleSet Os Profile A Virtual Machine OS Profile block as documented below.
- resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- sku
Scale
Set Sku A sku block as documented below.
- storage
Profile ScaleOs Disk Set Storage Profile Os Disk A storage profile os disk block as documented below
- upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- automatic
Os booleanUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- boot
Diagnostics ScaleSet Boot Diagnostics A boot diagnostics profile block as referenced below.
- eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- extensions
Scale
Set Extension[] Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- identity
Scale
Set Identity - license
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- os
Profile ScaleLinux Config Set Os Profile Linux Config A Linux config block as documented below.
- os
Profile ScaleSecrets Set Os Profile Secret[] A collection of Secret blocks as documented below.
- os
Profile ScaleWindows Config Set Os Profile Windows Config A Windows config block as documented below.
- overprovision boolean
Specifies whether the virtual machine scale set should be overprovisioned.
- plan
Scale
Set Plan A plan block as documented below.
- priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- single
Placement booleanGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- storage
Profile ScaleData Disks Set Storage Profile Data Disk[] A storage profile data disk block as documented below
- storage
Profile ScaleImage Reference Set Storage Profile Image Reference A storage profile image reference block as documented below.
- {[key: string]: string}
A mapping of tags to assign to the resource.
- zones string[]
A collection of availability zones to spread the Virtual Machines over.
- network_
profiles List[ScaleSet Network Profile] A collection of network profile block as documented below.
- os_
profile Dict[ScaleSet Os Profile] A Virtual Machine OS Profile block as documented below.
- resource_
group_ strname The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- sku
Dict[Scale
Set Sku] A sku block as documented below.
- storage_
profile_ Dict[Scaleos_ disk Set Storage Profile Os Disk] A storage profile os disk block as documented below
- upgrade_
policy_ strmode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- automatic_
os_ boolupgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- boot_
diagnostics Dict[ScaleSet Boot Diagnostics] A boot diagnostics profile block as referenced below.
- eviction_
policy str Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- extensions
List[Scale
Set Extension] Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- health_
probe_ strid Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- identity
Dict[Scale
Set Identity] - license_
type str Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- location str
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- name str
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- os_
profile_ Dict[Scalelinux_ config Set Os Profile Linux Config] A Linux config block as documented below.
- os_
profile_ List[Scalesecrets Set Os Profile Secret] A collection of Secret blocks as documented below.
- os_
profile_ Dict[Scalewindows_ config Set Os Profile Windows Config] A Windows config block as documented below.
- overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- plan
Dict[Scale
Set Plan] A plan block as documented below.
- priority str
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- proximity_
placement_ strgroup_ id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- rolling_
upgrade_ Dict[Scalepolicy Set Rolling Upgrade Policy] A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- single_
placement_ boolgroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- storage_
profile_ List[Scaledata_ disks Set Storage Profile Data Disk] A storage profile data disk block as documented below
- storage_
profile_ Dict[Scaleimage_ reference Set Storage Profile Image Reference] A storage profile image reference block as documented below.
- Dict[str, str]
A mapping of tags to assign to the resource.
- zones List[str]
A collection of availability zones to spread the Virtual Machines over.
Outputs
All input properties are implicitly available as output properties. Additionally, the ScaleSet resource produces the following output properties:
Look up an Existing ScaleSet Resource
Get an existing ScaleSet resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ScaleSetState, opts?: CustomResourceOptions): ScaleSetstatic get(resource_name, id, opts=None, automatic_os_upgrade=None, boot_diagnostics=None, eviction_policy=None, extensions=None, health_probe_id=None, identity=None, license_type=None, location=None, name=None, network_profiles=None, os_profile=None, os_profile_linux_config=None, os_profile_secrets=None, os_profile_windows_config=None, overprovision=None, plan=None, priority=None, proximity_placement_group_id=None, resource_group_name=None, rolling_upgrade_policy=None, single_placement_group=None, sku=None, storage_profile_data_disks=None, storage_profile_image_reference=None, storage_profile_os_disk=None, tags=None, upgrade_policy_mode=None, zones=None, __props__=None);func GetScaleSet(ctx *Context, name string, id IDInput, state *ScaleSetState, opts ...ResourceOption) (*ScaleSet, error)public static ScaleSet Get(string name, Input<string> id, ScaleSetState? state, CustomResourceOptions? opts = null)- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
The following state arguments are supported:
- Automatic
Os boolUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- Boot
Diagnostics ScaleSet Boot Diagnostics Args A boot diagnostics profile block as referenced below.
- Eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- Extensions
List<Scale
Set Extension Args> Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- Health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- Identity
Scale
Set Identity Args - License
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- Location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- Network
Profiles List<ScaleSet Network Profile Args> A collection of network profile block as documented below.
- Os
Profile ScaleSet Os Profile Args A Virtual Machine OS Profile block as documented below.
- Os
Profile ScaleLinux Config Set Os Profile Linux Config Args A Linux config block as documented below.
- Os
Profile List<ScaleSecrets Set Os Profile Secret Args> A collection of Secret blocks as documented below.
- Os
Profile ScaleWindows Config Set Os Profile Windows Config Args A Windows config block as documented below.
- Overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- Plan
Scale
Set Plan Args A plan block as documented below.
- Priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- Proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- Resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- Rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy Args A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- Single
Placement boolGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- Sku
Scale
Set Sku Args A sku block as documented below.
- Storage
Profile List<ScaleData Disks Set Storage Profile Data Disk Args> A storage profile data disk block as documented below
- Storage
Profile ScaleImage Reference Set Storage Profile Image Reference Args A storage profile image reference block as documented below.
- Storage
Profile ScaleOs Disk Set Storage Profile Os Disk Args A storage profile os disk block as documented below
- Dictionary<string, string>
A mapping of tags to assign to the resource.
- Upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- Zones List<string>
A collection of availability zones to spread the Virtual Machines over.
- Automatic
Os boolUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- Boot
Diagnostics ScaleSet Boot Diagnostics A boot diagnostics profile block as referenced below.
- Eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- Extensions
[]Scale
Set Extension Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- Health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- Identity
Scale
Set Identity - License
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- Location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- Name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- Network
Profiles []ScaleSet Network Profile A collection of network profile block as documented below.
- Os
Profile ScaleSet Os Profile A Virtual Machine OS Profile block as documented below.
- Os
Profile ScaleLinux Config Set Os Profile Linux Config A Linux config block as documented below.
- Os
Profile []ScaleSecrets Set Os Profile Secret A collection of Secret blocks as documented below.
- Os
Profile ScaleWindows Config Set Os Profile Windows Config A Windows config block as documented below.
- Overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- Plan
Scale
Set Plan A plan block as documented below.
- Priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- Proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- Resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- Rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- Single
Placement boolGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- Sku
Scale
Set Sku A sku block as documented below.
- Storage
Profile []ScaleData Disks Set Storage Profile Data Disk A storage profile data disk block as documented below
- Storage
Profile ScaleImage Reference Set Storage Profile Image Reference A storage profile image reference block as documented below.
- Storage
Profile ScaleOs Disk Set Storage Profile Os Disk A storage profile os disk block as documented below
- map[string]string
A mapping of tags to assign to the resource.
- Upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- Zones []string
A collection of availability zones to spread the Virtual Machines over.
- automatic
Os booleanUpgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- boot
Diagnostics ScaleSet Boot Diagnostics A boot diagnostics profile block as referenced below.
- eviction
Policy string Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- extensions
Scale
Set Extension[] Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- health
Probe stringId Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- identity
Scale
Set Identity - license
Type string Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- location string
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- name string
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- network
Profiles ScaleSet Network Profile[] A collection of network profile block as documented below.
- os
Profile ScaleSet Os Profile A Virtual Machine OS Profile block as documented below.
- os
Profile ScaleLinux Config Set Os Profile Linux Config A Linux config block as documented below.
- os
Profile ScaleSecrets Set Os Profile Secret[] A collection of Secret blocks as documented below.
- os
Profile ScaleWindows Config Set Os Profile Windows Config A Windows config block as documented below.
- overprovision boolean
Specifies whether the virtual machine scale set should be overprovisioned.
- plan
Scale
Set Plan A plan block as documented below.
- priority string
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- proximity
Placement stringGroup Id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- resource
Group stringName The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- rolling
Upgrade ScalePolicy Set Rolling Upgrade Policy A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- single
Placement booleanGroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- sku
Scale
Set Sku A sku block as documented below.
- storage
Profile ScaleData Disks Set Storage Profile Data Disk[] A storage profile data disk block as documented below
- storage
Profile ScaleImage Reference Set Storage Profile Image Reference A storage profile image reference block as documented below.
- storage
Profile ScaleOs Disk Set Storage Profile Os Disk A storage profile os disk block as documented below
- {[key: string]: string}
A mapping of tags to assign to the resource.
- upgrade
Policy stringMode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- zones string[]
A collection of availability zones to spread the Virtual Machines over.
- automatic_
os_ boolupgrade Automatic OS patches can be applied by Azure to your scaleset. This is particularly useful when
upgrade_policy_modeis set toRolling. Defaults tofalse.- boot_
diagnostics Dict[ScaleSet Boot Diagnostics] A boot diagnostics profile block as referenced below.
- eviction_
policy str Specifies the eviction policy for Virtual Machines in this Scale Set. Possible values are
DeallocateandDelete.- extensions
List[Scale
Set Extension] Can be specified multiple times to add extension profiles to the scale set. Each
extensionblock supports the fields documented below.- health_
probe_ strid Specifies the identifier for the load balancer health probe. Required when using
Rollingas yourupgrade_policy_mode.- identity
Dict[Scale
Set Identity] - license_
type str Specifies the Windows OS license type. If supplied, the only allowed values are
Windows_ClientandWindows_Server.- location str
Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
- name str
Specifies the name of the virtual machine scale set resource. Changing this forces a new resource to be created.
- network_
profiles List[ScaleSet Network Profile] A collection of network profile block as documented below.
- os_
profile Dict[ScaleSet Os Profile] A Virtual Machine OS Profile block as documented below.
- os_
profile_ Dict[Scalelinux_ config Set Os Profile Linux Config] A Linux config block as documented below.
- os_
profile_ List[Scalesecrets Set Os Profile Secret] A collection of Secret blocks as documented below.
- os_
profile_ Dict[Scalewindows_ config Set Os Profile Windows Config] A Windows config block as documented below.
- overprovision bool
Specifies whether the virtual machine scale set should be overprovisioned.
- plan
Dict[Scale
Set Plan] A plan block as documented below.
- priority str
Specifies the priority for the Virtual Machines in the Scale Set. Defaults to
Regular. Possible values areLowandRegular.- proximity_
placement_ strgroup_ id The ID of the Proximity Placement Group to which this Virtual Machine should be assigned. Changing this forces a new resource to be created
- resource_
group_ strname The name of the resource group in which to create the virtual machine scale set. Changing this forces a new resource to be created.
- rolling_
upgrade_ Dict[Scalepolicy Set Rolling Upgrade Policy] A
rolling_upgrade_policyblock as defined below. This is only applicable when theupgrade_policy_modeisRolling.- single_
placement_ boolgroup Specifies whether the scale set is limited to a single placement group with a maximum size of 100 virtual machines. If set to false, managed disks must be used. Default is true. Changing this forces a new resource to be created. See documentation for more information.
- sku
Dict[Scale
Set Sku] A sku block as documented below.
- storage_
profile_ List[Scaledata_ disks Set Storage Profile Data Disk] A storage profile data disk block as documented below
- storage_
profile_ Dict[Scaleimage_ reference Set Storage Profile Image Reference] A storage profile image reference block as documented below.
- storage_
profile_ Dict[Scaleos_ disk Set Storage Profile Os Disk] A storage profile os disk block as documented below
- Dict[str, str]
A mapping of tags to assign to the resource.
- upgrade_
policy_ strmode Specifies the mode of an upgrade to virtual machines in the scale set. Possible values,
Rolling,Manual, orAutomatic. When choosingRolling, you will need to set a health probe.- zones List[str]
A collection of availability zones to spread the Virtual Machines over.
Supporting Types
ScaleSetBootDiagnostics
ScaleSetExtension
- Name string
Specifies the name of the extension.
- Publisher string
The publisher of the extension, available publishers can be found by using the Azure CLI.
- Type string
The type of extension, available types for a publisher can be found using the Azure CLI.
- Type
Handler stringVersion Specifies the version of the extension to use, available versions can be found using the Azure CLI.
- Auto
Upgrade boolMinor Version Specifies whether or not to use the latest minor version available.
- Protected
Settings string The protected_settings passed to the extension, like settings, these are specified as a JSON object in a string.
- Provision
After List<string>Extensions Specifies a dependency array of extensions required to be executed before, the array stores the name of each extension.
- Settings string
The settings passed to the extension, these are specified as a JSON object in a string.
- Name string
Specifies the name of the extension.
- Publisher string
The publisher of the extension, available publishers can be found by using the Azure CLI.
- Type string
The type of extension, available types for a publisher can be found using the Azure CLI.
- Type
Handler stringVersion Specifies the version of the extension to use, available versions can be found using the Azure CLI.
- Auto
Upgrade boolMinor Version Specifies whether or not to use the latest minor version available.
- Protected
Settings string The protected_settings passed to the extension, like settings, these are specified as a JSON object in a string.
- Provision
After []stringExtensions Specifies a dependency array of extensions required to be executed before, the array stores the name of each extension.
- Settings string
The settings passed to the extension, these are specified as a JSON object in a string.
- name string
Specifies the name of the extension.
- publisher string
The publisher of the extension, available publishers can be found by using the Azure CLI.
- type string
The type of extension, available types for a publisher can be found using the Azure CLI.
- type
Handler stringVersion Specifies the version of the extension to use, available versions can be found using the Azure CLI.
- auto
Upgrade booleanMinor Version Specifies whether or not to use the latest minor version available.
- protected
Settings string The protected_settings passed to the extension, like settings, these are specified as a JSON object in a string.
- provision
After string[]Extensions Specifies a dependency array of extensions required to be executed before, the array stores the name of each extension.
- settings string
The settings passed to the extension, these are specified as a JSON object in a string.
- name str
Specifies the name of the extension.
- publisher str
The publisher of the extension, available publishers can be found by using the Azure CLI.
- type str
The type of extension, available types for a publisher can be found using the Azure CLI.
- type_
handler_ strversion Specifies the version of the extension to use, available versions can be found using the Azure CLI.
- auto_
upgrade_ boolminor_ version Specifies whether or not to use the latest minor version available.
- protected_
settings str The protected_settings passed to the extension, like settings, these are specified as a JSON object in a string.
- provision_
after_ List[str]extensions Specifies a dependency array of extensions required to be executed before, the array stores the name of each extension.
- settings str
The settings passed to the extension, these are specified as a JSON object in a string.
ScaleSetIdentity
- Type string
Specifies the identity type to be assigned to the scale set. Allowable values are
SystemAssignedandUserAssigned. For theSystemAssignedidentity the scale set’s Service Principal ID (SPN) can be retrieved after the scale set has been created. See documentation for more information.- Identity
Ids List<string> Specifies a list of user managed identity ids to be assigned to the VMSS. Required if
typeisUserAssigned.- Principal
Id string
- Type string
Specifies the identity type to be assigned to the scale set. Allowable values are
SystemAssignedandUserAssigned. For theSystemAssignedidentity the scale set’s Service Principal ID (SPN) can be retrieved after the scale set has been created. See documentation for more information.- Identity
Ids []string Specifies a list of user managed identity ids to be assigned to the VMSS. Required if
typeisUserAssigned.- Principal
Id string
- type string
Specifies the identity type to be assigned to the scale set. Allowable values are
SystemAssignedandUserAssigned. For theSystemAssignedidentity the scale set’s Service Principal ID (SPN) can be retrieved after the scale set has been created. See documentation for more information.- identity
Ids string[] Specifies a list of user managed identity ids to be assigned to the VMSS. Required if
typeisUserAssigned.- principal
Id string
- type str
Specifies the identity type to be assigned to the scale set. Allowable values are
SystemAssignedandUserAssigned. For theSystemAssignedidentity the scale set’s Service Principal ID (SPN) can be retrieved after the scale set has been created. See documentation for more information.- identity
Ids List[str] Specifies a list of user managed identity ids to be assigned to the VMSS. Required if
typeisUserAssigned.- principal_
id str
ScaleSetNetworkProfile
- Ip
Configurations List<ScaleSet Network Profile Ip Configuration Args> An ip_configuration block as documented below.
- Name string
Specifies the name of the network interface configuration.
- Primary bool
Indicates whether network interfaces created from the network interface configuration will be the primary NIC of the VM.
- Accelerated
Networking bool Specifies whether to enable accelerated networking or not. Defaults to
false.- Dns
Settings ScaleSet Network Profile Dns Settings Args A dns_settings block as documented below.
- Ip
Forwarding bool Whether IP forwarding is enabled on this NIC. Defaults to
false.- Network
Security stringGroup Id Specifies the identifier for the network security group.
- Ip
Configurations []ScaleSet Network Profile Ip Configuration An ip_configuration block as documented below.
- Name string
Specifies the name of the network interface configuration.
- Primary bool
Indicates whether network interfaces created from the network interface configuration will be the primary NIC of the VM.
- Accelerated
Networking bool Specifies whether to enable accelerated networking or not. Defaults to
false.- Dns
Settings ScaleSet Network Profile Dns Settings A dns_settings block as documented below.
- Ip
Forwarding bool Whether IP forwarding is enabled on this NIC. Defaults to
false.- Network
Security stringGroup Id Specifies the identifier for the network security group.
- ip
Configurations ScaleSet Network Profile Ip Configuration[] An ip_configuration block as documented below.
- name string
Specifies the name of the network interface configuration.
- primary boolean
Indicates whether network interfaces created from the network interface configuration will be the primary NIC of the VM.
- accelerated
Networking boolean Specifies whether to enable accelerated networking or not. Defaults to
false.- dns
Settings ScaleSet Network Profile Dns Settings A dns_settings block as documented below.
- ip
Forwarding boolean Whether IP forwarding is enabled on this NIC. Defaults to
false.- network
Security stringGroup Id Specifies the identifier for the network security group.
- ip_
configurations List[ScaleSet Network Profile Ip Configuration] An ip_configuration block as documented below.
- name str
Specifies the name of the network interface configuration.
- primary bool
Indicates whether network interfaces created from the network interface configuration will be the primary NIC of the VM.
- accelerated
Networking bool Specifies whether to enable accelerated networking or not. Defaults to
false.- dns
Settings Dict[ScaleSet Network Profile Dns Settings] A dns_settings block as documented below.
- ip
Forwarding bool Whether IP forwarding is enabled on this NIC. Defaults to
false.- network_
security_ strgroup_ id Specifies the identifier for the network security group.
ScaleSetNetworkProfileDnsSettings
- Dns
Servers List<string> Specifies an array of dns servers.
- Dns
Servers []string Specifies an array of dns servers.
- dns
Servers string[] Specifies an array of dns servers.
- dns_
servers List[str] Specifies an array of dns servers.
ScaleSetNetworkProfileIpConfiguration
- Name string
Specifies name of the IP configuration.
- Primary bool
Specifies if this ip_configuration is the primary one.
- Subnet
Id string Specifies the identifier of the subnet.
- Application
Gateway List<string>Backend Address Pool Ids 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 can use the same application gateway.
- Application
Security List<string>Group Ids Specifies up to
20application security group IDs.- Load
Balancer List<string>Backend Address Pool Ids 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 load balancer.
- Load
Balancer List<string>Inbound Nat Rules Ids Specifies an array of references to inbound NAT pools for 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 load balancer.
- Public
Ip ScaleAddress Configuration Set Network Profile Ip Configuration Public Ip Address Configuration Args Describes a virtual machines scale set IP Configuration’s PublicIPAddress configuration. The public_ip_address_configuration is documented below.
- Name string
Specifies name of the IP configuration.
- Primary bool
Specifies if this ip_configuration is the primary one.
- Subnet
Id string Specifies the identifier of the subnet.
- Application
Gateway []stringBackend Address Pool Ids 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 can use the same application gateway.
- Application
Security []stringGroup Ids Specifies up to
20application security group IDs.- Load
Balancer []stringBackend Address Pool Ids 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 load balancer.
- Load
Balancer []stringInbound Nat Rules Ids Specifies an array of references to inbound NAT pools for 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 load balancer.
- Public
Ip ScaleAddress Configuration Set Network Profile Ip Configuration Public Ip Address Configuration Describes a virtual machines scale set IP Configuration’s PublicIPAddress configuration. The public_ip_address_configuration is documented below.
- name string
Specifies name of the IP configuration.
- primary boolean
Specifies if this ip_configuration is the primary one.
- subnet
Id string Specifies the identifier of the subnet.
- application
Gateway string[]Backend Address Pool Ids 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 can use the same application gateway.
- application
Security string[]Group Ids Specifies up to
20application security group IDs.- load
Balancer string[]Backend Address Pool Ids 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 load balancer.
- load
Balancer string[]Inbound Nat Rules Ids Specifies an array of references to inbound NAT pools for 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 load balancer.
- public
Ip ScaleAddress Configuration Set Network Profile Ip Configuration Public Ip Address Configuration Describes a virtual machines scale set IP Configuration’s PublicIPAddress configuration. The public_ip_address_configuration is documented below.
- name str
Specifies name of the IP configuration.
- primary bool
Specifies if this ip_configuration is the primary one.
- subnet_
id str Specifies the identifier of the subnet.
- application
Gateway List[str]Backend Address Pool Ids 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 can use the same application gateway.
- application
Security List[str]Group Ids Specifies up to
20application security group IDs.- load
Balancer List[str]Backend Address Pool Ids 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 load balancer.
- load
Balancer List[str]Inbound Nat Rules Ids Specifies an array of references to inbound NAT pools for 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 load balancer.
- public
Ip Dict[ScaleAddress Configuration Set Network Profile Ip Configuration Public Ip Address Configuration] Describes a virtual machines scale set IP Configuration’s PublicIPAddress configuration. The public_ip_address_configuration is documented below.
ScaleSetNetworkProfileIpConfigurationPublicIpAddressConfiguration
- Domain
Name stringLabel The domain name label for the dns settings.
- Idle
Timeout int The idle timeout in minutes. This value must be between 4 and 30.
- Name string
The name of the public ip address configuration
- Domain
Name stringLabel The domain name label for the dns settings.
- Idle
Timeout int The idle timeout in minutes. This value must be between 4 and 30.
- Name string
The name of the public ip address configuration
- domain
Name stringLabel The domain name label for the dns settings.
- idle
Timeout number The idle timeout in minutes. This value must be between 4 and 30.
- name string
The name of the public ip address configuration
- domain_
name_ strlabel The domain name label for the dns settings.
- idle
Timeout float The idle timeout in minutes. This value must be between 4 and 30.
- name str
The name of the public ip address configuration
ScaleSetOsProfile
- Admin
Username string Specifies the administrator account name to use for all the instances of virtual machines in the scale set.
- Computer
Name stringPrefix Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 9 characters long for windows images and 1 - 58 for linux. Changing this forces a new resource to be created.
- Admin
Password string Specifies the administrator password to use for all the instances of virtual machines in a scale set.
- Custom
Data string Specifies custom data to supply to the machine. On linux-based systems, this can be used as a cloud-init script. On other systems, this will be copied as a file on disk. Internally, this provider will base64 encode this value before sending it to the API. The maximum length of the binary array is 65535 bytes.
- Admin
Username string Specifies the administrator account name to use for all the instances of virtual machines in the scale set.
- Computer
Name stringPrefix Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 9 characters long for windows images and 1 - 58 for linux. Changing this forces a new resource to be created.
- Admin
Password string Specifies the administrator password to use for all the instances of virtual machines in a scale set.
- Custom
Data string Specifies custom data to supply to the machine. On linux-based systems, this can be used as a cloud-init script. On other systems, this will be copied as a file on disk. Internally, this provider will base64 encode this value before sending it to the API. The maximum length of the binary array is 65535 bytes.
- admin
Username string Specifies the administrator account name to use for all the instances of virtual machines in the scale set.
- computer
Name stringPrefix Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 9 characters long for windows images and 1 - 58 for linux. Changing this forces a new resource to be created.
- admin
Password string Specifies the administrator password to use for all the instances of virtual machines in a scale set.
- custom
Data string Specifies custom data to supply to the machine. On linux-based systems, this can be used as a cloud-init script. On other systems, this will be copied as a file on disk. Internally, this provider will base64 encode this value before sending it to the API. The maximum length of the binary array is 65535 bytes.
- admin_
username str Specifies the administrator account name to use for all the instances of virtual machines in the scale set.
- computer_
name_ strprefix Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 9 characters long for windows images and 1 - 58 for linux. Changing this forces a new resource to be created.
- admin_
password str Specifies the administrator password to use for all the instances of virtual machines in a scale set.
- custom_
data str Specifies custom data to supply to the machine. On linux-based systems, this can be used as a cloud-init script. On other systems, this will be copied as a file on disk. Internally, this provider will base64 encode this value before sending it to the API. The maximum length of the binary array is 65535 bytes.
ScaleSetOsProfileLinuxConfig
- Disable
Password boolAuthentication Specifies whether password authentication should be disabled. Defaults to
false. Changing this forces a new resource to be created.- Ssh
Keys List<ScaleSet Os Profile Linux Config Ssh Key Args> Specifies a collection of
pathandkey_datato be placed on the virtual machine.
- Disable
Password boolAuthentication Specifies whether password authentication should be disabled. Defaults to
false. Changing this forces a new resource to be created.- Ssh
Keys []ScaleSet Os Profile Linux Config Ssh Key Specifies a collection of
pathandkey_datato be placed on the virtual machine.
- disable
Password booleanAuthentication Specifies whether password authentication should be disabled. Defaults to
false. Changing this forces a new resource to be created.- ssh
Keys ScaleSet Os Profile Linux Config Ssh Key[] Specifies a collection of
pathandkey_datato be placed on the virtual machine.
- disable_
password_ boolauthentication Specifies whether password authentication should be disabled. Defaults to
false. Changing this forces a new resource to be created.- ssh
Keys List[ScaleSet Os Profile Linux Config Ssh Key] Specifies a collection of
pathandkey_datato be placed on the virtual machine.
ScaleSetOsProfileLinuxConfigSshKey
ScaleSetOsProfileSecret
- Source
Vault stringId Specifies the key vault to use.
- Vault
Certificates List<ScaleSet Os Profile Secret Vault Certificate Args> A collection of Vault Certificates as documented below
- Source
Vault stringId Specifies the key vault to use.
- Vault
Certificates []ScaleSet Os Profile Secret Vault Certificate A collection of Vault Certificates as documented below
- source
Vault stringId Specifies the key vault to use.
- vault
Certificates ScaleSet Os Profile Secret Vault Certificate[] A collection of Vault Certificates as documented below
- source
Vault strId Specifies the key vault to use.
- vault
Certificates List[ScaleSet Os Profile Secret Vault Certificate] A collection of Vault Certificates as documented below
ScaleSetOsProfileSecretVaultCertificate
- Certificate
Url string It is the Base64 encoding of a JSON Object that which is encoded in UTF-8 of which the contents need to be
data,dataTypeandpassword.- Certificate
Store string Specifies the certificate store on the Virtual Machine where the certificate should be added to.
- Certificate
Url string It is the Base64 encoding of a JSON Object that which is encoded in UTF-8 of which the contents need to be
data,dataTypeandpassword.- Certificate
Store string Specifies the certificate store on the Virtual Machine where the certificate should be added to.
- certificate
Url string It is the Base64 encoding of a JSON Object that which is encoded in UTF-8 of which the contents need to be
data,dataTypeandpassword.- certificate
Store string Specifies the certificate store on the Virtual Machine where the certificate should be added to.
- certificate
Url str It is the Base64 encoding of a JSON Object that which is encoded in UTF-8 of which the contents need to be
data,dataTypeandpassword.- certificate
Store str Specifies the certificate store on the Virtual Machine where the certificate should be added to.
ScaleSetOsProfileWindowsConfig
- Additional
Unattend List<ScaleConfigs Set Os Profile Windows Config Additional Unattend Config Args> An Additional Unattended Config block as documented below.
- Enable
Automatic boolUpgrades Indicates whether virtual machines in the scale set are enabled for automatic updates.
- Provision
Vm boolAgent Indicates whether virtual machine agent should be provisioned on the virtual machines in the scale set.
- Winrms
List<Scale
Set Os Profile Windows Config Winrm Args> A collection of WinRM configuration blocks as documented below.
- Additional
Unattend []ScaleConfigs Set Os Profile Windows Config Additional Unattend Config An Additional Unattended Config block as documented below.
- Enable
Automatic boolUpgrades Indicates whether virtual machines in the scale set are enabled for automatic updates.
- Provision
Vm boolAgent Indicates whether virtual machine agent should be provisioned on the virtual machines in the scale set.
- Winrms
[]Scale
Set Os Profile Windows Config Winrm A collection of WinRM configuration blocks as documented below.
- additional
Unattend ScaleConfigs Set Os Profile Windows Config Additional Unattend Config[] An Additional Unattended Config block as documented below.
- enable
Automatic booleanUpgrades Indicates whether virtual machines in the scale set are enabled for automatic updates.
- provision
Vm booleanAgent Indicates whether virtual machine agent should be provisioned on the virtual machines in the scale set.
- winrms
Scale
Set Os Profile Windows Config Winrm[] A collection of WinRM configuration blocks as documented below.
- additional
Unattend List[ScaleConfigs Set Os Profile Windows Config Additional Unattend Config] An Additional Unattended Config block as documented below.
- enable
Automatic boolUpgrades Indicates whether virtual machines in the scale set are enabled for automatic updates.
- provision_
vm_ boolagent Indicates whether virtual machine agent should be provisioned on the virtual machines in the scale set.
- winrms
List[Scale
Set Os Profile Windows Config Winrm] A collection of WinRM configuration blocks as documented below.
ScaleSetOsProfileWindowsConfigAdditionalUnattendConfig
- Component string
Specifies the name of the component to configure with the added content. The only allowable value is
Microsoft-Windows-Shell-Setup.- Content string
Specifies the base-64 encoded XML formatted content that is added to the unattend.xml file for the specified path and component.
- Pass string
Specifies the name of the pass that the content applies to. The only allowable value is
oobeSystem.- Setting
Name string Specifies the name of the setting to which the content applies. Possible values are:
FirstLogonCommandsandAutoLogon.
- Component string
Specifies the name of the component to configure with the added content. The only allowable value is
Microsoft-Windows-Shell-Setup.- Content string
Specifies the base-64 encoded XML formatted content that is added to the unattend.xml file for the specified path and component.
- Pass string
Specifies the name of the pass that the content applies to. The only allowable value is
oobeSystem.- Setting
Name string Specifies the name of the setting to which the content applies. Possible values are:
FirstLogonCommandsandAutoLogon.
- component string
Specifies the name of the component to configure with the added content. The only allowable value is
Microsoft-Windows-Shell-Setup.- content string
Specifies the base-64 encoded XML formatted content that is added to the unattend.xml file for the specified path and component.
- pass string
Specifies the name of the pass that the content applies to. The only allowable value is
oobeSystem.- setting
Name string Specifies the name of the setting to which the content applies. Possible values are:
FirstLogonCommandsandAutoLogon.
- component str
Specifies the name of the component to configure with the added content. The only allowable value is
Microsoft-Windows-Shell-Setup.- content str
Specifies the base-64 encoded XML formatted content that is added to the unattend.xml file for the specified path and component.
- pass str
Specifies the name of the pass that the content applies to. The only allowable value is
oobeSystem.- setting
Name str Specifies the name of the setting to which the content applies. Possible values are:
FirstLogonCommandsandAutoLogon.
ScaleSetOsProfileWindowsConfigWinrm
- Protocol string
Specifies the protocol of listener
- Certificate
Url string Specifies URL of the certificate with which new Virtual Machines is provisioned.
- Protocol string
Specifies the protocol of listener
- Certificate
Url string Specifies URL of the certificate with which new Virtual Machines is provisioned.
- protocol string
Specifies the protocol of listener
- certificate
Url string Specifies URL of the certificate with which new Virtual Machines is provisioned.
- protocol str
Specifies the protocol of listener
- certificate
Url str Specifies URL of the certificate with which new Virtual Machines is provisioned.
ScaleSetPlan
ScaleSetRollingUpgradePolicy
- Max
Batch intInstance Percent 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. Defaults to
20.- Max
Unhealthy intInstance Percent 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. Defaults to
20.- Max
Unhealthy intUpgraded Instance Percent 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. Defaults to
20.- Pause
Time stringBetween Batches 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 for duration (https://en.wikipedia.org/wiki/ISO_8601#Durations). Defaults to
0seconds represented asPT0S.
- Max
Batch intInstance Percent 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. Defaults to
20.- Max
Unhealthy intInstance Percent 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. Defaults to
20.- Max
Unhealthy intUpgraded Instance Percent 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. Defaults to
20.- Pause
Time stringBetween Batches 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 for duration (https://en.wikipedia.org/wiki/ISO_8601#Durations). Defaults to
0seconds represented asPT0S.
- max
Batch numberInstance Percent 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. Defaults to
20.- max
Unhealthy numberInstance Percent 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. Defaults to
20.- max
Unhealthy numberUpgraded Instance Percent 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. Defaults to
20.- pause
Time stringBetween Batches 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 for duration (https://en.wikipedia.org/wiki/ISO_8601#Durations). Defaults to
0seconds represented asPT0S.
- max
Batch floatInstance Percent 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. Defaults to
20.- max
Unhealthy floatInstance Percent 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. Defaults to
20.- max
Unhealthy floatUpgraded Instance Percent 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. Defaults to
20.- pause
Time strBetween Batches 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 for duration (https://en.wikipedia.org/wiki/ISO_8601#Durations). Defaults to
0seconds represented asPT0S.
ScaleSetSku
ScaleSetStorageProfileDataDisk
- Create
Option string Specifies how the data disk should be created. The only possible options are
FromImageandEmpty.- Lun int
Specifies the Logical Unit Number of the disk in each virtual machine in the scale set.
- Caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- Disk
Size intGb Specifies the size of the disk in GB. This element is required when creating an empty disk.
- Managed
Disk stringType Specifies the type of managed disk to create. Value must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS.
- Create
Option string Specifies how the data disk should be created. The only possible options are
FromImageandEmpty.- Lun int
Specifies the Logical Unit Number of the disk in each virtual machine in the scale set.
- Caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- Disk
Size intGb Specifies the size of the disk in GB. This element is required when creating an empty disk.
- Managed
Disk stringType Specifies the type of managed disk to create. Value must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS.
- create
Option string Specifies how the data disk should be created. The only possible options are
FromImageandEmpty.- lun number
Specifies the Logical Unit Number of the disk in each virtual machine in the scale set.
- caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- disk
Size numberGb Specifies the size of the disk in GB. This element is required when creating an empty disk.
- managed
Disk stringType Specifies the type of managed disk to create. Value must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS.
- create_
option str Specifies how the data disk should be created. The only possible options are
FromImageandEmpty.- lun float
Specifies the Logical Unit Number of the disk in each virtual machine in the scale set.
- caching str
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- disk_
size_ floatgb Specifies the size of the disk in GB. This element is required when creating an empty disk.
- managed
Disk strType Specifies the type of managed disk to create. Value must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS.
ScaleSetStorageProfileImageReference
- Id string
Specifies the ID of the (custom) image to use to create the virtual machine scale set, as in the example below.
- Offer string
Specifies the offer of the image used to create the virtual machines.
- Publisher string
Specifies the publisher of the image used to create the virtual machines.
- Sku string
Specifies the SKU of the image used to create the virtual machines.
- Version string
Specifies the version of the image used to create the virtual machines.
- Id string
Specifies the ID of the (custom) image to use to create the virtual machine scale set, as in the example below.
- Offer string
Specifies the offer of the image used to create the virtual machines.
- Publisher string
Specifies the publisher of the image used to create the virtual machines.
- Sku string
Specifies the SKU of the image used to create the virtual machines.
- Version string
Specifies the version of the image used to create the virtual machines.
- id string
Specifies the ID of the (custom) image to use to create the virtual machine scale set, as in the example below.
- offer string
Specifies the offer of the image used to create the virtual machines.
- publisher string
Specifies the publisher of the image used to create the virtual machines.
- sku string
Specifies the SKU of the image used to create the virtual machines.
- version string
Specifies the version of the image used to create the virtual machines.
- id str
Specifies the ID of the (custom) image to use to create the virtual machine scale set, as in the example below.
- offer str
Specifies the offer of the image used to create the virtual machines.
- publisher str
Specifies the publisher of the image used to create the virtual machines.
- sku str
Specifies the SKU of the image used to create the virtual machines.
- version str
Specifies the version of the image used to create the virtual machines.
ScaleSetStorageProfileOsDisk
- Create
Option string Specifies how the virtual machine should be created. The only possible option is
FromImage.- Caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- Image string
Specifies the blob uri for user image. A virtual machine scale set creates an os disk in the same container as the user image. Updating the osDisk image causes the existing disk to be deleted and a new one created with the new image. If the VM scale set is in Manual upgrade mode then the virtual machines are not updated until they have manualUpgrade applied to them. When setting this field
os_typeneeds to be specified. Cannot be used whenvhd_containers,managed_disk_typeorstorage_profile_image_referenceare specified.- Managed
Disk stringType Specifies the type of managed disk to create. Value you must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS. Cannot be used whenvhd_containersorimageis specified.- Name string
Specifies the disk name. Must be specified when using unmanaged disk (‘managed_disk_type’ property not set).
- Os
Type string Specifies the operating system Type, valid values are windows, linux.
- Vhd
Containers List<string> Specifies the vhd uri. Cannot be used when
imageormanaged_disk_typeis specified.
- Create
Option string Specifies how the virtual machine should be created. The only possible option is
FromImage.- Caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- Image string
Specifies the blob uri for user image. A virtual machine scale set creates an os disk in the same container as the user image. Updating the osDisk image causes the existing disk to be deleted and a new one created with the new image. If the VM scale set is in Manual upgrade mode then the virtual machines are not updated until they have manualUpgrade applied to them. When setting this field
os_typeneeds to be specified. Cannot be used whenvhd_containers,managed_disk_typeorstorage_profile_image_referenceare specified.- Managed
Disk stringType Specifies the type of managed disk to create. Value you must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS. Cannot be used whenvhd_containersorimageis specified.- Name string
Specifies the disk name. Must be specified when using unmanaged disk (‘managed_disk_type’ property not set).
- Os
Type string Specifies the operating system Type, valid values are windows, linux.
- Vhd
Containers []string Specifies the vhd uri. Cannot be used when
imageormanaged_disk_typeis specified.
- create
Option string Specifies how the virtual machine should be created. The only possible option is
FromImage.- caching string
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- image string
Specifies the blob uri for user image. A virtual machine scale set creates an os disk in the same container as the user image. Updating the osDisk image causes the existing disk to be deleted and a new one created with the new image. If the VM scale set is in Manual upgrade mode then the virtual machines are not updated until they have manualUpgrade applied to them. When setting this field
os_typeneeds to be specified. Cannot be used whenvhd_containers,managed_disk_typeorstorage_profile_image_referenceare specified.- managed
Disk stringType Specifies the type of managed disk to create. Value you must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS. Cannot be used whenvhd_containersorimageis specified.- name string
Specifies the disk name. Must be specified when using unmanaged disk (‘managed_disk_type’ property not set).
- os
Type string Specifies the operating system Type, valid values are windows, linux.
- vhd
Containers string[] Specifies the vhd uri. Cannot be used when
imageormanaged_disk_typeis specified.
- create_
option str Specifies how the virtual machine should be created. The only possible option is
FromImage.- caching str
Specifies the caching requirements. Possible values include:
None(default),ReadOnly,ReadWrite.- image str
Specifies the blob uri for user image. A virtual machine scale set creates an os disk in the same container as the user image. Updating the osDisk image causes the existing disk to be deleted and a new one created with the new image. If the VM scale set is in Manual upgrade mode then the virtual machines are not updated until they have manualUpgrade applied to them. When setting this field
os_typeneeds to be specified. Cannot be used whenvhd_containers,managed_disk_typeorstorage_profile_image_referenceare specified.- managed
Disk strType Specifies the type of managed disk to create. Value you must be either
Standard_LRS,StandardSSD_LRSorPremium_LRS. Cannot be used whenvhd_containersorimageis specified.- name str
Specifies the disk name. Must be specified when using unmanaged disk (‘managed_disk_type’ property not set).
- os_
type str Specifies the operating system Type, valid values are windows, linux.
- vhd
Containers List[str] Specifies the vhd uri. Cannot be used when
imageormanaged_disk_typeis specified.
Package Details
- Repository
- https://github.com/pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azurermTerraform Provider.