StepScalingPolicyProps

class aws_cdk.aws_autoscaling.StepScalingPolicyProps(*, metric, scaling_steps, adjustment_type=None, cooldown=None, estimated_instance_warmup=None, evaluation_periods=None, metric_aggregation_type=None, min_adjustment_magnitude=None, auto_scaling_group)

Bases: aws_cdk.aws_autoscaling.BasicStepScalingPolicyProps

Parameters
  • metric (IMetric) – Metric to scale on.

  • scaling_steps (Sequence[ScalingInterval]) – The intervals for scaling. Maps a range of metric values to a particular scaling behavior.

  • adjustment_type (Optional[AdjustmentType]) – How the adjustment numbers inside ‘intervals’ are interpreted. Default: ChangeInCapacity

  • cooldown (Optional[Duration]) – Grace period after scaling activity. Default: Default cooldown period on your AutoScalingGroup

  • estimated_instance_warmup (Optional[Duration]) – Estimated time until a newly launched instance can send metrics to CloudWatch. Default: Same as the cooldown

  • evaluation_periods (Union[int, float, None]) – How many evaluation periods of the metric to wait before triggering a scaling action. Raising this value can be used to smooth out the metric, at the expense of slower response times. Default: 1

  • metric_aggregation_type (Optional[MetricAggregationType]) – Aggregation to apply to all data points over the evaluation periods. Only has meaning if evaluationPeriods != 1. Default: - The statistic from the metric if applicable (MIN, MAX, AVERAGE), otherwise AVERAGE.

  • min_adjustment_magnitude (Union[int, float, None]) – Minimum absolute number to adjust capacity with as result of percentage scaling. Only when using AdjustmentType = PercentChangeInCapacity, this number controls the minimum absolute effect size. Default: No minimum scaling effect

  • auto_scaling_group (IAutoScalingGroup) – The auto scaling group.

Attributes

adjustment_type

How the adjustment numbers inside ‘intervals’ are interpreted.

Default

ChangeInCapacity

Return type

Optional[AdjustmentType]

auto_scaling_group

The auto scaling group.

Return type

IAutoScalingGroup

cooldown

Grace period after scaling activity.

Default

Default cooldown period on your AutoScalingGroup

Return type

Optional[Duration]

estimated_instance_warmup

Estimated time until a newly launched instance can send metrics to CloudWatch.

Default

Same as the cooldown

Return type

Optional[Duration]

evaluation_periods

How many evaluation periods of the metric to wait before triggering a scaling action.

Raising this value can be used to smooth out the metric, at the expense of slower response times.

Default

1

Return type

Union[int, float, None]

metric

Metric to scale on.

Return type

IMetric

metric_aggregation_type

Aggregation to apply to all data points over the evaluation periods.

Only has meaning if evaluationPeriods != 1.

Default
  • The statistic from the metric if applicable (MIN, MAX, AVERAGE), otherwise AVERAGE.

Return type

Optional[MetricAggregationType]

min_adjustment_magnitude

Minimum absolute number to adjust capacity with as result of percentage scaling.

Only when using AdjustmentType = PercentChangeInCapacity, this number controls the minimum absolute effect size.

Default

No minimum scaling effect

Return type

Union[int, float, None]

scaling_steps

The intervals for scaling.

Maps a range of metric values to a particular scaling behavior.

Return type

List[ScalingInterval]