# CapacityDistributionStrategy

The strategies for when launches fail in an Availability Zone.

- Source: [`aws-autoscaling/lib/auto-scaling-group.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-autoscaling/lib/auto-scaling-group.ts#L1373)
- Type last changed: v2.174.0 · 4 Jan 2025

## 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,
});
```

## Members

| Member | Description |
| --- | --- |
| `BALANCED_ONLY` | If 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_EFFORT` | If launches fail in an Availability Zone, Auto Scaling will attempt to launch in another healthy Availability Zone instead. |

## Referenced by

- [`CommonAutoScalingGroupProps`](/v2/docs/aws-cdk-lib.aws_autoscaling.CommonAutoScalingGroupProps).azCapacityDistributionStrategy