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 PredictiveScalingPredefinedLoadMetric
<a name="aws-properties-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric"></a>

Contains load metric information for the `PredefinedLoadMetricSpecification` property of the [AWS::AutoScaling::ScalingPolicy PredictiveScalingMetricSpecification](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-scalingpolicy-predictivescalingmetricspecification.html) property type.

**Important**  
Does not apply to policies that use a *metric pair* for the metric specification.

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

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

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

```
{
  "[PredefinedMetricType](#cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-predefinedmetrictype)" : String,
  "[ResourceLabel](#cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-resourcelabel)" : String
}
```

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

```
  [PredefinedMetricType](#cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-predefinedmetrictype): String
  [ResourceLabel](#cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-resourcelabel): String
```

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

`PredefinedMetricType`  <a name="cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-predefinedmetrictype"></a>
The metric type.  
*Required*: Yes  
*Type*: String  
*Allowed values*: `ASGTotalCPUUtilization | ASGTotalNetworkIn | ASGTotalNetworkOut | ALBTargetGroupRequestCount`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ResourceLabel`  <a name="cfn-autoscaling-scalingpolicy-predictivescalingpredefinedloadmetric-resourcelabel"></a>
A label that uniquely identifies a specific Application Load Balancer target group from which to determine the request count served by your Auto Scaling group. You can't specify a resource label unless the target group is attached to the Auto Scaling group.  
You create the resource label by appending the final portion of the load balancer ARN and the final portion of the target group ARN into a single value, separated by a forward slash (/). The format of the resource label is:  
`app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff`.  
Where:  
+ app/<load-balancer-name>/<load-balancer-id> is the final portion of the load balancer ARN
+ targetgroup/<target-group-name>/<target-group-id> is the final portion of the target group ARN.
To find the ARN for an Application Load Balancer, use the [DescribeLoadBalancers](https://docs.amazonaws.cn/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html) API operation. To find the ARN for the target group, use the [DescribeTargetGroups](https://docs.amazonaws.cn/elasticloadbalancing/latest/APIReference/API_DescribeTargetGroups.html) API operation.  
*Required*: Conditional  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)