software.amazon.awssdk.services.autoscaling.model

Interface InstancesDistribution.Builder

All Superinterfaces:

Buildable, CopyableBuilder<InstancesDistribution.Builder,InstancesDistribution>, SdkBuilder<InstancesDistribution.Builder,InstancesDistribution>, SdkPojo

Enclosing class:

InstancesDistribution

public static interface InstancesDistribution.Builder
extends SdkPojo, CopyableBuilder<InstancesDistribution.Builder,InstancesDistribution>

Method Summary

Modifier and Type	Method and Description
InstancesDistribution.Builder	onDemandAllocationStrategy(String onDemandAllocationStrategy) Indicates how to allocate instance types to fulfill On-Demand capacity.
InstancesDistribution.Builder	onDemandBaseCapacity(Integer onDemandBaseCapacity) The minimum amount of the Auto Scaling group's capacity that must be fulfilled by On-Demand Instances.
InstancesDistribution.Builder	onDemandPercentageAboveBaseCapacity(Integer onDemandPercentageAboveBaseCapacity) Controls the percentages of On-Demand Instances and Spot Instances for your additional capacity beyond OnDemandBaseCapacity.
InstancesDistribution.Builder	spotAllocationStrategy(String spotAllocationStrategy) Indicates how to allocate Spot capacity across Spot pools.
InstancesDistribution.Builder	spotInstancePools(Integer spotInstancePools) The number of Spot pools to use to allocate your Spot capacity.
InstancesDistribution.Builder	spotMaxPrice(String spotMaxPrice) The maximum price per unit hour that you are willing to pay for a Spot Instance.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

onDemandAllocationStrategy

InstancesDistribution.Builder onDemandAllocationStrategy(String onDemandAllocationStrategy)

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 type overrides for the 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.

Parameters:

onDemandAllocationStrategy - 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 type overrides for the 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:

Returns a reference to this object so that method calls can be chained together.

onDemandBaseCapacity

InstancesDistribution.Builder onDemandBaseCapacity(Integer onDemandBaseCapacity)

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.

Parameters:

onDemandBaseCapacity - 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:

Returns a reference to this object so that method calls can be chained together.

onDemandPercentageAboveBaseCapacity

InstancesDistribution.Builder onDemandPercentageAboveBaseCapacity(Integer onDemandPercentageAboveBaseCapacity)

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.

Parameters:

onDemandPercentageAboveBaseCapacity - 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:

Returns a reference to this object so that method calls can be chained together.

spotAllocationStrategy

InstancesDistribution.Builder spotAllocationStrategy(String spotAllocationStrategy)

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.

Parameters:

spotAllocationStrategy - 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:

Returns a reference to this object so that method calls can be chained together.

spotInstancePools

InstancesDistribution.Builder spotInstancePools(Integer spotInstancePools)

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.

Parameters:

spotInstancePools - 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:

Returns a reference to this object so that method calls can be chained together.

spotMaxPrice

InstancesDistribution.Builder spotMaxPrice(String spotMaxPrice)

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.

Parameters:

spotMaxPrice - 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.

Returns:

Returns a reference to this object so that method calls can be chained together.