aws-cdk-lib.aws_autoscalingplans.CfnScalingPlan.TargetTrackingConfigurationProperty

interface TargetTrackingConfigurationProperty

LanguageType name
.NETAmazon.CDK.AWS.AutoScalingPlans.CfnScalingPlan.TargetTrackingConfigurationProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsautoscalingplans#CfnScalingPlan_TargetTrackingConfigurationProperty
Javasoftware.amazon.awscdk.services.autoscalingplans.CfnScalingPlan.TargetTrackingConfigurationProperty
Pythonaws_cdk.aws_autoscalingplans.CfnScalingPlan.TargetTrackingConfigurationProperty
TypeScript aws-cdk-lib » aws_autoscalingplans » CfnScalingPlan » TargetTrackingConfigurationProperty

TargetTrackingConfiguration is a subproperty of ScalingInstruction that specifies a target tracking configuration to use with AWS Auto Scaling ( Auto Scaling Plans ).

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_autoscalingplans as autoscalingplans } from 'aws-cdk-lib';
const targetTrackingConfigurationProperty: autoscalingplans.CfnScalingPlan.TargetTrackingConfigurationProperty = {
  targetValue: 123,

  // the properties below are optional
  customizedScalingMetricSpecification: {
    metricName: 'metricName',
    namespace: 'namespace',
    statistic: 'statistic',

    // the properties below are optional
    dimensions: [{
      name: 'name',
      value: 'value',
    }],
    unit: 'unit',
  },
  disableScaleIn: false,
  estimatedInstanceWarmup: 123,
  predefinedScalingMetricSpecification: {
    predefinedScalingMetricType: 'predefinedScalingMetricType',

    // the properties below are optional
    resourceLabel: 'resourceLabel',
  },
  scaleInCooldown: 123,
  scaleOutCooldown: 123,
};

Properties

NameTypeDescription
targetValuenumberThe target value for the metric.
customizedScalingMetricSpecification?IResolvable | CustomizedScalingMetricSpecificationPropertyA customized metric.
disableScaleIn?boolean | IResolvableIndicates whether scale in by the target tracking scaling policy is disabled.
estimatedInstanceWarmup?numberThe estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics.
predefinedScalingMetricSpecification?IResolvable | PredefinedScalingMetricSpecificationPropertyA predefined metric.
scaleInCooldown?numberThe amount of time, in seconds, after a scale-in activity completes before another scale in activity can start.
scaleOutCooldown?numberThe amount of time, in seconds, after a scale-out activity completes before another scale-out activity can start.

targetValue

Type: number

The target value for the metric.

Although this property accepts numbers of type Double, it won't accept values that are either too small or too large. Values must be in the range of -2^360 to 2^360.


customizedScalingMetricSpecification?

Type: IResolvable | CustomizedScalingMetricSpecificationProperty (optional)

A customized metric.

You can specify either a predefined metric or a customized metric.


disableScaleIn?

Type: boolean | IResolvable (optional)

Indicates whether scale in by the target tracking scaling policy is disabled.

If the value is true , scale in is disabled and the target tracking scaling policy doesn't remove capacity from the scalable resource. Otherwise, scale in is enabled and the target tracking scaling policy can remove capacity from the scalable resource.

The default value is false .


estimatedInstanceWarmup?

Type: number (optional)

The estimated time, in seconds, until a newly launched instance can contribute to the CloudWatch metrics.

This value is used only if the resource is an Auto Scaling group.


predefinedScalingMetricSpecification?

Type: IResolvable | PredefinedScalingMetricSpecificationProperty (optional)

A predefined metric.

You can specify either a predefined metric or a customized metric.


scaleInCooldown?

Type: number (optional)

The amount of time, in seconds, after a scale-in activity completes before another scale in activity can start.

This value is not used if the scalable resource is an Auto Scaling group.


scaleOutCooldown?

Type: number (optional)

The amount of time, in seconds, after a scale-out activity completes before another scale-out activity can start.

This value is not used if the scalable resource is an Auto Scaling group.