This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::AutoScaling::AutoScalingGroup AvailabilityZoneDistribution
<a name="aws-properties-autoscaling-autoscalinggroup-availabilityzonedistribution"></a>

`AvailabilityZoneDistribution` is a property of the [AWS::AutoScaling::AutoScalingGroup](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-resource-autoscaling-autoscalinggroup.html) resource. 

## Syntax
<a name="aws-properties-autoscaling-autoscalinggroup-availabilityzonedistribution-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-autoscaling-autoscalinggroup-availabilityzonedistribution-syntax.json"></a>

```
{
  "[CapacityDistributionStrategy](#cfn-autoscaling-autoscalinggroup-availabilityzonedistribution-capacitydistributionstrategy)" : {{String}}
}
```

### YAML
<a name="aws-properties-autoscaling-autoscalinggroup-availabilityzonedistribution-syntax.yaml"></a>

```
  [CapacityDistributionStrategy](#cfn-autoscaling-autoscalinggroup-availabilityzonedistribution-capacitydistributionstrategy): {{String}}
```

## Properties
<a name="aws-properties-autoscaling-autoscalinggroup-availabilityzonedistribution-properties"></a>

`CapacityDistributionStrategy`  <a name="cfn-autoscaling-autoscalinggroup-availabilityzonedistribution-capacitydistributionstrategy"></a>
 If launches fail in an Availability Zone, the following strategies are available. The default is `balanced-best-effort`.   
+ `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.
*Required*: No  
*Type*: String  
*Allowed values*: `balanced-best-effort | balanced-only`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)