aws-cdk-lib.aws_lambda.TargetTrackingScalingPolicy

TargetTrackingScalingPolicy Class

A target tracking scaling policy that automatically adjusts the capacity provider's compute resources to maintain a specified target value by tracking the required CloudWatch metric.

Source

aws-lambda/lib/capacity-provider.ts

Type last changed

v2.231.0 · 1 Dec 2025

Example

import * as ec2 from 'aws-cdk-lib/aws-ec2';

const vpc = new ec2.Vpc(this, 'MyVpc');
const securityGroup = new ec2.SecurityGroup(this, 'SecurityGroup', { vpc });

const capacityProvider = new lambda.CapacityProvider(this, 'MyCapacityProvider', {
  subnets: vpc.privateSubnets,
  securityGroups: [securityGroup],
  scalingOptions: lambda.ScalingOptions.manual([
    lambda.TargetTrackingScalingPolicy.cpuUtilization(70),
  ]),
});

Properties

metricTypestringmetric_typestrmetricTypeStringMetricTypestringMetricType*string#

The predefined metric type.

predefinedMetricTypestringpredefined_metric_typestrpredefinedMetricTypeStringPredefinedMetricTypestringPredefinedMetricType*string#

The predefined metric type for this scaling policy.

targetValuenumbertarget_valueint | floattargetValueNumberTargetValuedoubleTargetValue*float64#

The target value for the specified metric as a percentage.

The capacity provider will scale resources to maintain this target value.

valuenumbervalueint | floatvalueNumberValuedoubleValue*float64#

The target value for the metric.

Methods

cpuUtilization(targetCpuUtilization: number): TargetTrackingScalingPolicy // chainable@staticmethod def cpu_utilization(target_cpu_utilization: int | float) -> TargetTrackingScalingPolicypublic static TargetTrackingScalingPolicy cpuUtilization(Number targetCpuUtilization)public static TargetTrackingScalingPolicy CpuUtilization(double targetCpuUtilization)func CpuUtilization(TargetCpuUtilization *float64) TargetTrackingScalingPolicystatic#

Creates a target tracking scaling policy for CPU utilization.

1 parameter

Parameters

• targetCpuUtilizationtarget_cpu_utilizationtargetCpuUtilizationtargetCpuUtilizationTargetCpuUtilization — The target value for CPU utilization.