Class InstancesDistribution
InstancesDistribution is a subproperty of MixedInstancesPolicy that describes an instances distribution for an Auto Scaling group.
Inheritance
Implements
Namespace: Amazon.CDK.AWS.AutoScaling
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class InstancesDistribution : Object, IInstancesDistribution
Syntax (vb)
Public Class InstancesDistribution
Inherits Object
Implements IInstancesDistribution
Remarks
The instances distribution specifies the distribution of On-Demand Instances and Spot Instances, the maximum price to pay for Spot Instances, and how the Auto Scaling group allocates instance types to fulfill On-Demand and Spot capacities.
For more information and example configurations, see Auto Scaling groups with multiple instance types and purchase options in the Amazon EC2 Auto Scaling User Guide:
https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
ExampleMetadata: infused
Examples
Vpc vpc;
LaunchTemplate launchTemplate1;
LaunchTemplate launchTemplate2;
new AutoScalingGroup(this, "ASG", new AutoScalingGroupProps {
Vpc = vpc,
MixedInstancesPolicy = new MixedInstancesPolicy {
InstancesDistribution = new InstancesDistribution {
OnDemandPercentageAboveBaseCapacity = 50
},
LaunchTemplate = launchTemplate1,
LaunchTemplateOverrides = new [] { new LaunchTemplateOverrides { InstanceType = new InstanceType("t3.micro") }, new LaunchTemplateOverrides { InstanceType = new InstanceType("t3a.micro") }, new LaunchTemplateOverrides { InstanceType = new InstanceType("t4g.micro"), LaunchTemplate = launchTemplate2 } }
}
});
Synopsis
Constructors
InstancesDistribution() |
Properties
OnDemandAllocationStrategy | Indicates how to allocate instance types to fulfill On-Demand capacity. |
OnDemandBaseCapacity | The minimum amount of the Auto Scaling group's capacity that must be fulfilled by On-Demand Instances. |
OnDemandPercentageAboveBaseCapacity | Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond OnDemandBaseCapacity. |
SpotAllocationStrategy | If the allocation strategy is lowest-price, the Auto Scaling group launches instances using the Spot pools with the lowest price, and evenly allocates your instances across the number of Spot pools that you specify. |
SpotInstancePools | The number of Spot Instance pools to use to allocate your Spot capacity. |
SpotMaxPrice | The maximum price per unit hour that you are willing to pay for a Spot Instance. |
Constructors
InstancesDistribution()
public InstancesDistribution()
Properties
OnDemandAllocationStrategy
Indicates how to allocate instance types to fulfill On-Demand capacity.
public Nullable<OnDemandAllocationStrategy> OnDemandAllocationStrategy { get; set; }
Property Value
System.Nullable<OnDemandAllocationStrategy>
Remarks
The only valid value is prioritized, which is also the default value.
Default: OnDemandAllocationStrategy.PRIORITIZED
OnDemandBaseCapacity
The minimum amount of the Auto Scaling group's capacity that must be fulfilled by On-Demand Instances.
public Nullable<double> OnDemandBaseCapacity { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
This base portion is provisioned first as your group scales. Defaults to 0 if not specified. If you specify weights for the instance types in the overrides, set the value of OnDemandBaseCapacity in terms of the number of capacity units, and not the number of instances.
Default: 0
OnDemandPercentageAboveBaseCapacity
Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond OnDemandBaseCapacity.
public Nullable<double> OnDemandPercentageAboveBaseCapacity { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
Expressed as a number (for example, 20 specifies 20% On-Demand Instances, 80% Spot Instances). Defaults to 100 if not specified. If set to 100, only On-Demand Instances are provisioned.
Default: 100
SpotAllocationStrategy
If the allocation strategy is lowest-price, the Auto Scaling group launches instances using the Spot pools with the lowest price, and evenly allocates your instances across the number of Spot pools that you specify.
public Nullable<SpotAllocationStrategy> SpotAllocationStrategy { get; set; }
Property Value
System.Nullable<SpotAllocationStrategy>
Remarks
Defaults to lowest-price if not specified.
If the allocation strategy is capacity-optimized (recommended), the Auto Scaling group launches instances using Spot pools that are optimally chosen based on the available Spot capacity. Alternatively, you can use capacity-optimized-prioritized and set the order of instance types in the list of launch template overrides from highest to lowest priority (from first to last in the list). Amazon EC2 Auto Scaling honors the instance type priorities on a best-effort basis but optimizes for capacity first.
Default: SpotAllocationStrategy.LOWEST_PRICE
SpotInstancePools
The number of Spot Instance pools to use to allocate your Spot capacity.
public Nullable<double> SpotInstancePools { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
The Spot pools are determined from the different instance types in the overrides. Valid only when the Spot allocation strategy is lowest-price. Value must be in the range of 1 to 20. Defaults to 2 if not specified.
Default: 2
SpotMaxPrice
The maximum price per unit hour that you are willing to pay for a Spot Instance.
public string SpotMaxPrice { get; set; }
Property Value
System.String
Remarks
If you leave the value at its default (empty), Amazon EC2 Auto Scaling uses the On-Demand price as the maximum Spot price. To remove a value that you previously set, include the property but specify an empty string ("") for the value.
Default: "" - On-Demand price