aws-cdk-lib.aws_applicationautoscaling.CfnScalingPolicy.StepScalingPolicyConfigurationProperty

interface StepScalingPolicyConfigurationProperty

LanguageType name
.NETAmazon.CDK.AWS.ApplicationAutoScaling.CfnScalingPolicy.StepScalingPolicyConfigurationProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsapplicationautoscaling#CfnScalingPolicy_StepScalingPolicyConfigurationProperty
Javasoftware.amazon.awscdk.services.applicationautoscaling.CfnScalingPolicy.StepScalingPolicyConfigurationProperty
Pythonaws_cdk.aws_applicationautoscaling.CfnScalingPolicy.StepScalingPolicyConfigurationProperty
TypeScript aws-cdk-lib » aws_applicationautoscaling » CfnScalingPolicy » StepScalingPolicyConfigurationProperty

StepScalingPolicyConfiguration is a property of the AWS::ApplicationAutoScaling::ScalingPolicy resource that specifies a step scaling policy configuration for Application Auto Scaling.

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

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 stepScalingPolicyConfigurationProperty: appscaling.CfnScalingPolicy.StepScalingPolicyConfigurationProperty = {
  adjustmentType: 'adjustmentType',
  cooldown: 123,
  metricAggregationType: 'metricAggregationType',
  minAdjustmentMagnitude: 123,
  stepAdjustments: [{
    scalingAdjustment: 123,

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

Properties

NameTypeDescription
adjustmentType?stringSpecifies whether the ScalingAdjustment value in the StepAdjustment property is an absolute number or a percentage of the current capacity.
cooldown?numberThe amount of time, in seconds, to wait for a previous scaling activity to take effect.
metricAggregationType?stringThe aggregation type for the CloudWatch metrics.
minAdjustmentMagnitude?numberThe minimum value to scale by when the adjustment type is PercentChangeInCapacity .
stepAdjustments?IResolvable | IResolvable | StepAdjustmentProperty[]A set of adjustments that enable you to scale based on the size of the alarm breach.

adjustmentType?

Type: string (optional)

Specifies whether the ScalingAdjustment value in the StepAdjustment property is an absolute number or a percentage of the current capacity.


cooldown?

Type: number (optional)

The amount of time, in seconds, to wait for a previous scaling activity to take effect.

If not specified, the default value is 300. For more information, see Cooldown period in the Application Auto Scaling User Guide .


metricAggregationType?

Type: string (optional)

The aggregation type for the CloudWatch metrics.

Valid values are Minimum , Maximum , and Average . If the aggregation type is null, the value is treated as Average .


minAdjustmentMagnitude?

Type: number (optional)

The minimum value to scale by when the adjustment type is PercentChangeInCapacity .

For example, suppose that you create a step scaling policy to scale out an Amazon ECS service by 25 percent and you specify a MinAdjustmentMagnitude of 2. If the service has 4 tasks and the scaling policy is performed, 25 percent of 4 is 1. However, because you specified a MinAdjustmentMagnitude of 2, Application Auto Scaling scales out the service by 2 tasks.


stepAdjustments?

Type: IResolvable | IResolvable | StepAdjustmentProperty[] (optional)

A set of adjustments that enable you to scale based on the size of the alarm breach.

At least one step adjustment is required if you are adding a new step scaling policy configuration.