Skip to content
v2.278.0

CapacityDistributionStrategy Enum ​

The strategies for when launches fail in an Availability Zone.

Example ​

ts
declare const vpc: ec2.Vpc;
declare const instanceType: ec2.InstanceType;
declare const machineImage: ec2.IMachineImage;

new autoscaling.AutoScalingGroup(this, 'ASG', {
  vpc,
  instanceType,
  machineImage,

  // ...

  azCapacityDistributionStrategy: autoscaling.CapacityDistributionStrategy.BALANCED_ONLY,
});
python
# vpc: ec2.Vpc
# instance_type: ec2.InstanceType
# machine_image: ec2.IMachineImage


autoscaling.AutoScalingGroup(self, "ASG",
    vpc=vpc,
    instance_type=instance_type,
    machine_image=machine_image,

    # ...

    az_capacity_distribution_strategy=autoscaling.CapacityDistributionStrategy.BALANCED_ONLY
)
java
Vpc vpc;
InstanceType instanceType;
IMachineImage machineImage;


AutoScalingGroup.Builder.create(this, "ASG")
        .vpc(vpc)
        .instanceType(instanceType)
        .machineImage(machineImage)

        // ...

        .azCapacityDistributionStrategy(CapacityDistributionStrategy.BALANCED_ONLY)
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
Vpc vpc;
InstanceType instanceType;
IMachineImage machineImage;


new AutoScalingGroup(this, "ASG", new AutoScalingGroupProps {
    Vpc = vpc,
    InstanceType = instanceType,
    MachineImage = machineImage,

    // ...

    AzCapacityDistributionStrategy = CapacityDistributionStrategy.BALANCED_ONLY
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var vpc Vpc
var instanceType InstanceType
var machineImage IMachineImage


autoscaling.NewAutoScalingGroup(this, jsii.String("ASG"), &AutoScalingGroupProps{
	Vpc: Vpc,
	InstanceType: InstanceType,
	MachineImage: MachineImage,

	// ...

	AzCapacityDistributionStrategy: autoscaling.CapacityDistributionStrategy_BALANCED_ONLY,
})

Members ​

MemberDescription
BALANCED_ONLYIf launches fail in an Availability Zone, Auto Scaling will continue to attempt to launch in the unhealthy zone to preserve a balanced distribution.
BALANCED_BEST_EFFORTIf launches fail in an Availability Zone, Auto Scaling will attempt to launch in another healthy Availability Zone instead.

Referenced by ​

  • CommonAutoScalingGroupProps.azCapacityDistributionStrategyaz_capacity_distribution_strategyazCapacityDistributionStrategyAzCapacityDistributionStrategyAzCapacityDistributionStrategy