Class: Aws::AutoScaling::Types::InstancesDistribution

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-autoscaling/types.rb

Overview

Note:

When making an API call, you may pass InstancesDistribution data as a hash:

{
  on_demand_allocation_strategy: "XmlString",
  on_demand_base_capacity: 1,
  on_demand_percentage_above_base_capacity: 1,
  spot_allocation_strategy: "XmlString",
  spot_instance_pools: 1,
  spot_max_price: "SpotPrice",
}

Describes an instances distribution for an Auto Scaling group with 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.

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#on_demand_allocation_strategy ⇒ String

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 array of LaunchTemplate 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.

Returns:

  • (String) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end

#on_demand_base_capacity ⇒ Integer

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.

The default value is 0. If you leave this parameter set to 0, On-Demand Instances are launched as a percentage of the Auto Scaling group’s desired capacity, per the OnDemandPercentageAboveBaseCapacity setting.

Returns:

  • (Integer) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end

#on_demand_percentage_above_base_capacity ⇒ Integer

Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond OnDemandBaseCapacity.

The range is 0–100. The default value is 100. If you leave this parameter set to 100, the percentages are 100% for On-Demand Instances and 0% for Spot Instances.

Returns:

  • (Integer) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end

#spot_allocation_strategy ⇒ String

Indicates how to allocate Spot capacity across Spot pools.

The only valid value is ‘lowest-price`, which is also the default value. The Auto Scaling group selects the cheapest Spot pools and evenly allocates your Spot capacity across the number of Spot pools that you specify.

Returns:

  • (String) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end

#spot_instance_pools ⇒ Integer

The number of Spot pools to use to allocate your Spot capacity. The Spot pools are determined from the different instance types in the Overrides array of LaunchTemplate.

The range is 1–20 and the default is 2.

Returns:

  • (Integer) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end

#spot_max_price ⇒ String

The maximum price per unit hour that you are willing to pay for a Spot Instance. If you leave this value blank (which is the default), the maximum Spot price is set at the On-Demand price.

Returns:

  • (String) 


2616
2617
2618
2619
2620
2621
2622
2623
2624
 
# File 'lib/aws-sdk-autoscaling/types.rb', line 2616

class InstancesDistribution < Struct.new(
  :on_demand_allocation_strategy,
  :on_demand_base_capacity,
  :on_demand_percentage_above_base_capacity,
  :spot_allocation_strategy,
  :spot_instance_pools,
  :spot_max_price)
  include Aws::Structure
end