AWSAutoScalingInstancesDistribution

Objective-C

@interface AWSAutoScalingInstancesDistribution

Swift

class AWSAutoScalingInstancesDistribution

Describes an instances distribution for an Auto Scaling group with a MixedInstancesPolicy.

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.

When you update SpotAllocationStrategy, SpotInstancePools, or SpotMaxPrice, this update action does not deploy any changes across the running Amazon EC2 instances in the group. Your existing Spot Instances continue to run as long as the maximum price for those instances is higher than the current Spot price. When scale out occurs, Amazon EC2 Auto Scaling launches instances based on the new settings. When scale in occurs, Amazon EC2 Auto Scaling terminates instances according to the group’s termination policies.

  • Indicates how to allocate instance types to fulfill On-Demand capacity. The only valid value is prioritized, which is also the default value. This strategy uses the order of instance types in the overrides to define the launch priority of each instance type. The first instance type in the array is prioritized higher than the last. If all your On-Demand capacity cannot be fulfilled using your highest priority instance, then the Auto Scaling groups launches the remaining capacity using the second priority instance type, and so on.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSString *_Nullable onDemandAllocationStrategy;

    Swift

    var onDemandAllocationStrategy: String? { get set }
  • The minimum amount of the Auto Scaling group’s capacity that must be fulfilled by On-Demand Instances. 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSNumber *_Nullable onDemandBaseCapacity;

    Swift

    var onDemandBaseCapacity: NSNumber? { get set }
  • Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond OnDemandBaseCapacity. 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSNumber *_Nullable onDemandPercentageAboveBaseCapacity;

    Swift

    var onDemandPercentageAboveBaseCapacity: NSNumber? { get set }
  • Indicates how to allocate instances across Spot Instance pools. 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. If the allocation strategy is capacity-optimized, the Auto Scaling group launches instances using Spot pools that are optimally chosen based on the available Spot capacity. Defaults to lowest-price if not specified.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSString *_Nullable spotAllocationStrategy;

    Swift

    var spotAllocationStrategy: String? { get set }
  • The number of Spot Instance pools across which to allocate your Spot Instances. The Spot pools are determined from the different instance types in the overrides. Defaults to 2 if not specified. Valid only when the Spot allocation strategy is lowest-price.

    Valid Range: Minimum value of 1. Maximum value of 20.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSNumber *_Nullable spotInstancePools;

    Swift

    var spotInstancePools: NSNumber? { get set }
  • The maximum price per unit hour that you are willing to pay for a Spot Instance. If you leave the value of this parameter blank (which is the default), the maximum Spot price is set at the On-Demand price. To remove a value that you previously set, include the parameter but leave the value blank.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSString *_Nullable spotMaxPrice;

    Swift

    var spotMaxPrice: String? { get set }