Class: Aws::AutoScaling::Types::InstancesDistribution
- Inherits:
-
Struct
- Object
- Struct
- Aws::AutoScaling::Types::InstancesDistribution
- Defined in:
- gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb
Overview
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: "MixedInstanceSpotPrice",
}
Describes an instances distribution for an Auto Scaling group.
Constant Summary collapse
- SENSITIVE =
[]
Instance Attribute Summary collapse
-
#on_demand_allocation_strategy ⇒ String
The order of the launch template overrides to use in fulfilling On-Demand capacity.
-
#on_demand_base_capacity ⇒ Integer
The minimum amount of the Auto Scaling group's capacity that must be fulfilled by On-Demand Instances.
-
#on_demand_percentage_above_base_capacity ⇒ Integer
Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond
OnDemandBaseCapacity
. -
#spot_allocation_strategy ⇒ String
Indicates how to allocate instances across Spot Instance pools.
-
#spot_instance_pools ⇒ Integer
The number of Spot Instance pools across which to allocate your Spot Instances.
-
#spot_max_price ⇒ String
The maximum price per unit hour that you are willing to pay for a Spot Instance.
Instance Attribute Details
#on_demand_allocation_strategy ⇒ String
The order of the launch template overrides to use in fulfilling On-Demand capacity.
If you specify lowest-price
, Amazon EC2 Auto Scaling uses price to
determine the order, launching the lowest price first.
If you specify prioritized
, Amazon EC2 Auto Scaling uses the
priority that you assigned to each launch template override,
launching the highest priority first. If all your On-Demand capacity
cannot be fulfilled using your highest priority instance, then
Amazon EC2 Auto Scaling launches the remaining capacity using the
second priority instance type, and so on.
Default: lowest-price
for Auto Scaling groups that specify
InstanceRequirements in the overrides and prioritized
for Auto
Scaling groups that don't.
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] 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 launched first as your group scales.
If you specify weights for the instance types in the overrides, the base capacity is measured in the same unit of measurement as the instance types. If you specify InstanceRequirements in the overrides, the base capacity is measured in the same unit of measurement as your group's desired capacity.
Default: 0
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] 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
.
Expressed as a number (for example, 20 specifies 20% On-Demand
Instances, 80% Spot Instances). If set to 100, only On-Demand
Instances are used.
Default: 100
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] include Aws::Structure end |
#spot_allocation_strategy ⇒ String
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
(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: lowest-price
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] include Aws::Structure end |
#spot_instance_pools ⇒ Integer
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. Valid only when the Spot allocation strategy
is lowest-price
. Value must be in the range of 1–20.
Default: 2
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] 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 keep the value at its default (unspecified), 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.
4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 |
# File 'gems/aws-sdk-autoscaling/lib/aws-sdk-autoscaling/types.rb', line 4454 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) SENSITIVE = [] include Aws::Structure end |