Auto Scaling：ModifyScalingRule

Action

String

Yes

ModifyScalingRule

The operation that you want to perform. Set the value to ModifyScalingRule.

ScalingRuleId

String

Yes

asr-bp1dvirgwkoowxk7****

The ID of the scaling rule that you want to modify.

ScalingRuleName

String

No

scalingrule****

The name of the scaling rule. The name must be 2 to 64 characters in length, and can contain letters, digits, underscores (_), hyphens (-), and periods (.). The name must start with a letter or a digit.

Cooldown

Integer

No

60

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.

MinAdjustmentMagnitude

Integer

No

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.

AdjustmentType

String

No

QuantityChangeInCapacity

The adjustment method used by the scaling rule. If you set ScalingRuleType to SimpleScalingRule or StepScalingRule, you must specify this parameter. Valid values:

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

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

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

AdjustmentValue

Integer

No

100

The number of instances that can be added to or removed from the scaling group based on the scaling rule. If you set ScalingRuleType to SimpleScalingRule or StepScalingRule, you must specify this parameter. The maximum number of ECS instances that can be added or removed in a single scaling operation is 1,000 regardless of the scenario. The value range of this parameter varies based on the value of AdjustmentType.

• Valid values if you set AdjustmentType to QuantityChangeInCapacity: -1000 to 1000.

• Valid values if you set AdjustmentType to PercentChangeInCapacity: -100 to 10000.

• Valid values if you set AdjustmentType to TotalCapacity: 0 to 2000.

EstimatedInstanceWarmup

Integer

No

60

The warmup period of instances that can be added to or removed from the scaling group. You can specify this parameter only for simple scaling rules and step scaling rules. Auto Scaling adds ECS instances in the Warmup state to the scaling group but does not send monitoring data to CloudMonitor during the warmup period.

Valid values: 0 to 86400. Unit: seconds.

MetricName

String

No

CpuUtilization

The predefined metric of the scaling rule. If you set ScalingRuleType to TargetTrackingScalingRule or PredictiveScalingRule, you must also specify this parameter.

Valid values if you set ScalingRuleType to TargetTrackingScalingRule:

• CpuUtilizationAgent (recommended): the CPU utilization.

• MemoryUtilization (recommended): the memory usage.

• CpuUtilization: the average CPU utilization.

• IntranetTx: the outbound traffic over an internal network.

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

• VpcInternetTx: the outbound traffic from a virtual private cloud (VPC) to the Internet.

• VpcInternetRx: the inbound traffic from the Internet to a VPC.

• LoadBalancerRealServerAverageQps: the queries per second (QPS) per Application Load Balancer (ALB) server group.

Valid values if you set ScalingRuleType to PredictiveScalingRule:

• CpuUtilization: the average CPU utilization.

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

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

For more information, see Event-triggered tasks of the system monitoring type.

TargetValue

Float

No

0.125

The target value. This parameter is available only if you set ScalingRuleType to TargetTrackingScalingRule or PredictiveScalingRule. The value must be greater than 0 and can have a maximum of three decimal places.

DisableScaleIn

Boolean

No

true

Specifies whether to disable scale-in. This parameter is available if you set ScalingRuleType to TargetTrackingScalingRule.

ScaleInEvaluationCount

Integer

No

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.

ScaleOutEvaluationCount

Integer

No

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

No

PredictAndScale

The mode of the predictive scaling rule. Valid values:

• PredictAndScale: provides predictions and creates prediction tasks.

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

PredictiveValueBehavior

String

No

MaxOverridePredictiveValue

The action that you want to take on the predicted maximum value. 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.

PredictiveValueBuffer

Integer

No

50

The ratio based on which the predicted value is increased if you set PredictiveValueBehavior to PredictiveValueOverrideMaxWithBuffer. If the predicted value 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.

PredictiveTaskBufferTime

Integer

No

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.

InitialMaxSize

Integer

No

100

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

StepAdjustment.N.MetricIntervalUpperBound

Float

No

5.0

The upper limit of a step adjustment. This parameter takes effect only if you set ScalingRuleType to StepScalingRule. Valid values: -9.999999E18 to 9.999999E18.

StepAdjustment.N.ScalingAdjustment

Integer

No

1

The number of ECS instances that you want to scale in each step adjustment. This parameter is available only if you set ScalingRuleType to StepScalingRule.

StepAdjustment.N.MetricIntervalLowerBound

Float

No

1.0

The lower limit in a step adjustment. This parameter is available only if you set ScalingRuleType to StepScalingRule. Valid values: -9.999999E18 to 9.999999E18.

AlarmDimension.N.DimensionKey

String

No

rulePool

The dimension key of the metric.

AlarmDimension.N.DimensionValue

String

No

sgp-l1cbirz451yxu2****

The dimension value of the metric.

MetricType

String

No

system

The type of the metric used by the event-triggered task. Valid values:

• system: system metrics of CloudMonitor.

• custom: custom metrics that are reported to CloudMonitor.

• hybrid: metrics of Hybrid Cloud Monitoring.

HybridMonitorNamespace

String

No

aliyun-test

The ID of the Hybrid Cloud Monitoring namespace.

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

HybridMetrics.N.Id

String

No

a

The reference ID of the metric in the metric expression.

HybridMetrics.N.Expression

String

No

(a+b)/2

The metric expression that consists of multiple Hybrid Cloud Monitoring metrics. It calculates a result used to trigger scaling events.

The expression must be written in Reverse Polish Notation (RPN) format and supports only the following operators: +, -, *, /.

HybridMetrics.N.MetricName

String

No

AliyunSmq_NumberOfMessagesVisible

The name of the Hybrid Cloud Monitoring metric.

HybridMetrics.N.Statistic

String

No

Average

The statistical method of the metric value. Valid values:

• Average: calculates the average value of all metric values within a specified interval.

• Minimum: calculates the minimum value of all metric values within a specified interval.

• Maximum: calculates the maximum value of all metric values within a specified interval.

HybridMetrics.N.Dimensions.N.DimensionKey

String

No

queue

The key of the metric dimension.

HybridMetrics.N.Dimensions.N.DimensionValue

String

No

testQueue

The value of the metric dimension.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

The request ID.