Package software.amazon.awscdk.services.autoscaling

Interface CfnScalingPolicy.StepAdjustmentProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnScalingPolicy.StepAdjustmentProperty.Jsii$Proxy

Enclosing class:

CfnScalingPolicy

@Stability(Stable)
public static interface CfnScalingPolicy.StepAdjustmentProperty
extends software.amazon.jsii.JsiiSerializable

StepAdjustment specifies a step adjustment for the StepAdjustments property of the AWS::AutoScaling::ScalingPolicy resource.

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.

There are a few rules for the step adjustments for your step policy:

• The ranges of your step adjustments can't overlap or have a gap.
• At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.
• At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.
• The upper and lower bound can't be null in the same step adjustment.

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

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

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.autoscaling.*;
 StepAdjustmentProperty stepAdjustmentProperty = StepAdjustmentProperty.builder()
         .scalingAdjustment(123)
         // the properties below are optional
         .metricIntervalLowerBound(123)
         .metricIntervalUpperBound(123)
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-scalingpolicy-stepadjustment.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnScalingPolicy.StepAdjustmentProperty.Builder	A builder for CfnScalingPolicy.StepAdjustmentProperty
static final class	CfnScalingPolicy.StepAdjustmentProperty.Jsii$Proxy	An implementation for CfnScalingPolicy.StepAdjustmentProperty

Method Summary

Modifier and Type	Method	Description
static CfnScalingPolicy.StepAdjustmentProperty.Builder	builder()
default Number	getMetricIntervalLowerBound()	The lower bound for the difference between the alarm threshold and the CloudWatch metric.
default Number	getMetricIntervalUpperBound()	The upper bound for the difference between the alarm threshold and the CloudWatch metric.
Number	getScalingAdjustment()	The amount by which to scale, based on the specified adjustment type.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getScalingAdjustment

@Stability(Stable)
@NotNull
Number getScalingAdjustment()

The amount by which to scale, based on the specified adjustment type.

A positive value adds to the current capacity while a negative number removes from the current capacity. For exact capacity, you must specify a non-negative value.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-scalingpolicy-stepadjustment.html#cfn-autoscaling-scalingpolicy-stepadjustment-scalingadjustment

getMetricIntervalLowerBound

@Stability(Stable)
@Nullable
default Number getMetricIntervalLowerBound()

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.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-scalingpolicy-stepadjustment.html#cfn-autoscaling-scalingpolicy-stepadjustment-metricintervallowerbound

getMetricIntervalUpperBound

@Stability(Stable)
@Nullable
default Number getMetricIntervalUpperBound()

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.

The upper bound must be greater than the lower bound.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-scalingpolicy-stepadjustment.html#cfn-autoscaling-scalingpolicy-stepadjustment-metricintervalupperbound

builder

@Stability(Stable)
static CfnScalingPolicy.StepAdjustmentProperty.Builder builder()

Returns:

a CfnScalingPolicy.StepAdjustmentProperty.Builder of CfnScalingPolicy.StepAdjustmentProperty