interface StepAdjustmentProperty

Language	Type name
.NET	`Amazon.CDK.AWS.ApplicationAutoScaling.CfnScalingPolicy.StepAdjustmentProperty`
Go	`github.com/aws/aws-cdk-go/awscdk/v2/awsapplicationautoscaling#CfnScalingPolicy_StepAdjustmentProperty`
Java	`software.amazon.awscdk.services.applicationautoscaling.CfnScalingPolicy.StepAdjustmentProperty`
Python	`aws_cdk.aws_applicationautoscaling.CfnScalingPolicy.StepAdjustmentProperty`
TypeScript	`aws-cdk-lib` » `aws_applicationautoscaling` » `CfnScalingPolicy` » `StepAdjustmentProperty`

StepAdjustment specifies a step adjustment for the StepAdjustments property of the AWS::ApplicationAutoScaling::ScalingPolicy StepScalingPolicyConfiguration property type.

For the following examples, suppose that you have an alarm with a breach threshold of 50:

To trigger a step adjustment when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0 and an upper bound of 10.
To trigger a step adjustment when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10 and an upper bound of 0.

For more information, see Step adjustments in the Application Auto Scaling User Guide .

You can find a sample template snippet in the Examples section of the AWS::ApplicationAutoScaling::ScalingPolicy documentation.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_applicationautoscaling as appscaling } from 'aws-cdk-lib';
const stepAdjustmentProperty: appscaling.CfnScalingPolicy.StepAdjustmentProperty = {
  scalingAdjustment: 123,

  // the properties below are optional
  metricIntervalLowerBound: 123,
  metricIntervalUpperBound: 123,
};

Properties

Name	Type	Description
scalingAdjustment	`number`	The amount by which to scale.
metricIntervalLowerBound?	`number`	The lower bound for the difference between the alarm threshold and the CloudWatch metric.
metricIntervalUpperBound?	`number`	The upper bound for the difference between the alarm threshold and the CloudWatch metric.

scalingAdjustment

Type: number

The amount by which to scale.

The adjustment is based on the value that you specified in the AdjustmentType property (either an absolute number or a percentage). A positive value adds to the current capacity and a negative number subtracts from the current capacity.

metricIntervalLowerBound?

Type: number (optional)

The lower bound for the difference between the alarm threshold and the CloudWatch metric.

If the metric value is above the breach threshold, the lower bound is inclusive (the metric must be greater than or equal to the threshold plus the lower bound). Otherwise, it is exclusive (the metric must be greater than the threshold plus the lower bound). A null value indicates negative infinity.

You must specify at least one upper or lower bound.

metricIntervalUpperBound?

Type: number (optional)

The upper bound for the difference between the alarm threshold and the CloudWatch metric.

If the metric value is above the breach threshold, the upper bound is exclusive (the metric must be less than the threshold plus the upper bound). Otherwise, it is inclusive (the metric must be less than or equal to the threshold plus the upper bound). A null value indicates positive infinity.

You must specify at least one upper or lower bound.