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::ScalingPolicy TargetTrackingMetricStat
<a name="aws-properties-autoscaling-scalingpolicy-targettrackingmetricstat"></a>

This structure defines the CloudWatch metric to return, along with the statistic and unit.

`TargetTrackingMetricStat` is a property of the [TargetTrackingMetricDataQuery](https://docs.amazonaws.cn/autoscaling/ec2/APIReference/API_TargetTrackingMetricDataQuery.html) object.

For more information about the CloudWatch terminology below, see [Amazon CloudWatch concepts](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) in the *Amazon CloudWatch User Guide*.

## Syntax
<a name="aws-properties-autoscaling-scalingpolicy-targettrackingmetricstat-syntax"></a>

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

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

```
{
  "[Metric](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-metric)" : {{Metric}},
  "[Period](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-period)" : {{Integer}},
  "[Stat](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-stat)" : {{String}},
  "[Unit](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-unit)" : {{String}}
}
```

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

```
  [Metric](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-metric): {{
    Metric}}
  [Period](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-period): {{Integer}}
  [Stat](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-stat): {{String}}
  [Unit](#cfn-autoscaling-scalingpolicy-targettrackingmetricstat-unit): {{String}}
```

## Properties
<a name="aws-properties-autoscaling-scalingpolicy-targettrackingmetricstat-properties"></a>

`Metric`  <a name="cfn-autoscaling-scalingpolicy-targettrackingmetricstat-metric"></a>
The metric to use.  
*Required*: Yes  
*Type*: [Metric](aws-properties-autoscaling-scalingpolicy-metric.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Period`  <a name="cfn-autoscaling-scalingpolicy-targettrackingmetricstat-period"></a>
 The period of the metric in seconds. The default value is 60. Accepted values are 10, 30, and 60. For high resolution metric, set the value to less than 60. For more information, see [Create a target tracking policy using high-resolution metrics for faster response](https://docs.amazonaws.cn/autoscaling/ec2/userguide/policy-creating-high-resolution-metrics.html).   
*Required*: No  
*Type*: Integer  
*Minimum*: `1`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Stat`  <a name="cfn-autoscaling-scalingpolicy-targettrackingmetricstat-stat"></a>
The statistic to return. It can include any CloudWatch statistic or extended statistic. For a list of valid values, see the table in [Statistics](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic) in the *Amazon CloudWatch User Guide*.  
The most commonly used metric for scaling is `Average`.  
*Required*: Yes  
*Type*: String  
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`  
*Minimum*: `1`  
*Maximum*: `100`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Unit`  <a name="cfn-autoscaling-scalingpolicy-targettrackingmetricstat-unit"></a>
The unit to use for the returned data points. For a complete list of the units that CloudWatch supports, see the [MetricDatum](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html) data type in the *Amazon CloudWatch API Reference*.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)