Auto Scaling:DescribeScalingRules

MetricName

String

CpuUtilization

The predefined metric of the scaling rule. This parameter is applicable if ScalingRuleType is set to TargetTrackingScalingRule or PredictiveScalingRule.

Valid values if ScalingRuleType is set to TargetTrackingScalingRule:

• CpuUtilization: the average CPU utilization.

• ClassicInternetRx: the average inbound public traffic over the classic network.

• ClassicInternetTx: the average outbound public traffic over the classic network.

• VpcInternetRx: the average inbound public traffic over a virtual private cloud (VPC).

• VpcInternetTx: the average outbound public traffic over a VPC.

• IntranetRx: the average inbound traffic over the internal network.

• IntranetTx: the average outbound traffic over the internal network.

  Valid values if ScalingRuleType is set to PredictiveScalingRule:

• CpuUtilization: the average CPU utilization.

• IntranetRx: the average inbound traffic over the internal network.

• IntranetTx: the average outbound traffic over the internal network.

AdjustmentType

String

QuantityChangeInCapacity

The adjustment method of the scaling rule. Valid values:

• QuantityChangeInCapacity: adds the specified number of Elastic Compute Service (ECS) instances to or removes the specified number of ECS instances from the scaling group.

• PercentChangeInCapacity: adds the specified percentage of ECS instances to or removes the specified percentage of ECS instances from the scaling group.

• TotalCapacity: adjusts the number of ECS instances in the scaling group to a specified number.

InitialMaxSize

Integer

100

The maximum number of ECS instances that can be added to the scaling group. If you specify InitialMaxSize, you must also specify PredictiveValueBehavior.

EstimatedInstanceWarmup

Integer

300

The warm-up period during which a series of preparation measures are taken on new instances. Auto Scaling does not monitor the metric data of instances that are being warmed up.

ScaleOutEvaluationCount

Integer

3

After you create a target tracking scaling rule, an event-triggered task is automatically created and associated with the scaling rule. This parameter defines the number of consecutive times the alert condition must be satisfied before the event-triggered task initiates a scale-out operation.

PredictiveScalingMode

String

PredictAndScale

The mode of the predictive scaling rule. Valid values:

• PredictAndScale: produces predictions and creates prediction tasks.

• PredictOnly: provides predictions but does not create prediction tasks.

MinAdjustmentMagnitude

Integer

1

The minimum number of instances that must be scaled. This parameter takes effect if you set ScalingRuleType to SimpleScalingRule or StepScalingRule, and AdjustmentType to PercentChangeInCapacity.

ScalingRuleAri

String

ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****

The ARN of scaling rule N.

PredictiveTaskBufferTime

Integer

30

The amount of buffer time before prediction tasks are run. By default, all prediction tasks that are automatically created based on a predictive scaling rule are run on the hour. You can specify a buffer time for resource preparation before prediction tasks are run. Valid values: 0 to 60. Unit: minutes.

MinSize

Integer

1

The minimum number of ECS instances that the scaling group must contain.

ScalingGroupId

String

asg-bp1ffogfdauy0jw0****

The ID of the scaling group whose scaling rules are queried.

PredictiveValueBehavior

String

MaxOverridePredictiveValue

Indicates whether the initial maximum capacity or the predicted value can be utilized as the maximum value for prediction tasks. Valid values:

• MaxOverridePredictiveValue: uses the initial maximum capacity as the maximum value for prediction tasks if the predicted value is greater than the initial maximum capacity.

• PredictiveValueOverrideMax: uses the predicted value as the maximum value for prediction tasks if the predicted value is greater than the initial maximum capacity.

• PredictiveValueOverrideMaxWithBuffer: increases the predicted value by a ratio that is specified by PredictiveValueBuffer, and uses the increased value as the maximum value for prediction tasks if the predicted value increased by the ratio is greater than the initial maximum capacity.

TargetValue

Float

0.125

The target value of the metric. If you set ScalingRuleType to TargetTrackingScalingRule or PredictiveScalingRule, Auto Scaling keeps the metric value close to the target value by adding instances to or removing instances from the scaling group.

Cooldown

Integer

20

The cooldown period of the scaling rule. This parameter is available only if you set ScalingRuleType to SimpleScalingRule. Valid values: 0 to 86400. Unit: seconds.

MaxSize

Integer

2

The maximum number of ECS instances that the scaling group can contain.

PredictiveValueBuffer

Integer

50

The ratio based on which the predicted value is increased if you set PredictiveValueBehavior to PredictiveValueOverrideMaxWithBuffer. If the predicted value that is increased by this ratio is greater than the initial maximum capacity, the increased value is used as the maximum value for prediction tasks. Valid values: 0 to 100.

ScalingRuleType

String

SimpleScalingRule

The type of the scaling rule. Valid values:

• SimpleScalingRule: Once a simple scaling rule is executed, Auto Scaling adjusts the number of ECS instances or elastic container instances in the scaling group based on the values of AdjustmentType and AdjustmentValue.

• TargetTrackingScalingRule: Once a target tracking scaling rule is executed, Auto Scaling dynamically calculates the number of ECS instances or elastic container instances to scale based on the predefined metric (MetricName) and attempts to maintain the metric value close to the specified target value (TargetValue).

• StepScalingRule: a step scaling rule. Once a step scaling rule is executed, Auto Scaling scales instances step by step based on the predefined thresholds and metric values.

• PredictiveScalingRule: uses machine learning to analyze historical monitoring data of the scaling group and predicts the future values of metrics. In addition, Auto Scaling creates scheduled tasks to adjust the minimum and maximum numbers of instances for the scaling group.

AdjustmentValue

Integer

1

The adjustment value specified in the scaling rule.

ScaleInEvaluationCount

Integer

15

After you create a target tracking scaling rule, an event-triggered task is automatically created and associated with the scaling rule. This parameter defines the number of consecutive times the alert condition must be satisfied before the event-triggered task initiates a scale-in operation.

DisableScaleIn

Boolean

true

Indicates whether scale-in is disabled. This parameter is available only if you set ScalingRuleType to TargetTrackingScalingRule. Valid values:

• true

• false

ScalingRuleName

String

scalingrule****

The name of the scaling rule.

ScalingRuleId

String

asr-bp1dvirgwkoowxk7****

The ID of the scaling rule.

MetricType

String

system

The metric type. Valid values:

• system: system metrics of CloudMonitor.

• custom: custom metrics that are reported to CloudMonitor.

• hybrid: metrics of Hybrid Cloud Monitoring.

HybridMonitorNamespace

String

aliyun-test

The ID of the Hybrid Cloud Monitoring namespace.

For information about how to manage Hybrid Cloud Monitoring namespaces, see Manage namespaces.