Auto Scaling:CreateScalingRule

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

The ID of the scaling group for which you want to create the scaling rule.

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.

The name of a scaling rule must be unique within an Alibaba Cloud account in a region.

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.

You can leave this parameter empty.

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.

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

• QuantityChangeInCapacity: adds the specified number of 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.

The number of instances that must be scaled based on the scaling rule. If you set ScalingRuleType to SimpleScalingRule or StepScalingRule, you must specify this parameter. The number of ECS instances that must be scaled in a scaling activity cannot exceed 1,000. Valid values of AdjustmentValue vary based on the value of AdjustmentType.

• Valid values if AdjustmentType is set to QuantityChangeInCapacity: -1000 to 1000.
• Valid values if AdjustmentType is set to PercentChangeInCapacity: -100 to 10000.
• Valid values if AdjustmentType is set to TotalCapacity: 0 to 2000.

The type of the scaling rule. Valid values:

• SimpleScalingRule: scales the number of ECS instances based on the values of AdjustmentType and AdjustmentValue.
• TargetTrackingScalingRule: calculates the number of ECS instances that must be scaled and maintains the value of a predefined metric close to the value of TargetValue.
• StepScalingRule: scales ECS instances in steps based on the specified 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 automatically creates scheduled tasks to specify the value range for the scaling group.

Default value: SimpleScalingRule

The warmup period of an ECS instance. This parameter is available only if you set ScalingRuleType to TargetTrackingScalingRule or PredictiveScalingRule. Auto Scaling adds ECS instances that are in the Warmup state to a scaling group, but does not report monitoring data of the ECS instances to CloudMonitor during the warmup period.

Valid values: 0 to 86400. Unit: seconds.

Default value: 300

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

Valid values if ScalingRuleType is set to TargetTrackingScalingRule:

• CpuUtilization: the average CPU utilization
• ClassicInternetRx: the average inbound Internet traffic over the classic network
• ClassicInternetTx: the average outbound Internet traffic over the classic network
• VpcInternetRx: the average inbound Internet traffic over a virtual private cloud (VPC)
• VpcInternetTx: the average outbound Internet 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

The target value. If you set ScalingRuleType to TargetTrackingScalingRule or PredictiveScalingRule, you must also specify this parameter. The value must be greater than 0 and can contain up to three decimal places.

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

Default value: false

The number of consecutive times that the event-triggered task created for scale-ins must meet the threshold conditions before an alert is triggered. After a target tracking scaling rule is created, an event-triggered task is automatically created and associated with the target tracking scaling rule.

Default value: 15

The number of consecutive times that the event-triggered task created for scale-outs must meet the threshold conditions before an alert is triggered. After a target tracking scaling rule is created, an event-triggered task is automatically created and associated with the target tracking scaling rule.

Default value: 3

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.

Default value: PredictAndScale

The action 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.

Default value: MaxOverridePredictiveValue

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.

Default value: 0

The amount of buffer time before the prediction task runs. By default, all prediction tasks that are automatically created by a predictive scaling rule run on the hour. You can specify a buffer time to run prediction tasks and prepare resources in advance. Valid values: 0 to 60. Unit: minutes.

Default value: 0

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

The default value of this parameter is the value of MaxSize.

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.

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

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

The region ID of the scaling group.

The dimension key of the metric.

The dimension value of the metric.

The unique identifier of the scaling rule.

The ID of the request.

The ID of the scaling rule, which is generated by the system and is globally unique.