ScalingGroup

• Implements: IScalingGroup

This class encapsulates and extends the ROS resource type ALIYUN::ESS::ScalingGroup.

Initializers

import com.aliyun.ros.cdk.ess.ScalingGroup;
ScalingGroup.Builder.create(Construct scope, java.lang.String id, java.lang.Boolean enableResourcePropertyConstraint)
    .maxSize(java.lang.Number)
    .maxSize(IResolvable)
    .minSize(java.lang.Number)
    .minSize(IResolvable)
//  .allocationStrategy(java.lang.String)
//  .allocationStrategy(IResolvable)
//  .azBalance(java.lang.Boolean)
//  .azBalance(IResolvable)
//  .compensateWithOnDemand(java.lang.Boolean)
//  .compensateWithOnDemand(IResolvable)
//  .containerGroupId(java.lang.String)
//  .containerGroupId(IResolvable)
//  .customPolicyArn(java.lang.String)
//  .customPolicyArn(IResolvable)
//  .dbInstanceIds(IResolvable)
//  .dbInstanceIds(java.util.List<java.lang.String)
//  .dbInstanceIds(IResolvable>)
//  .defaultCooldown(java.lang.Number)
//  .defaultCooldown(IResolvable)
//  .desiredCapacity(java.lang.Number)
//  .desiredCapacity(IResolvable)
//  .groupDeletionProtection(java.lang.Boolean)
//  .groupDeletionProtection(IResolvable)
//  .groupType(java.lang.String)
//  .groupType(IResolvable)
//  .healthCheckType(java.lang.String)
//  .healthCheckType(IResolvable)
//  .healthCheckTypes(IResolvable)
//  .healthCheckTypes(java.util.List<java.lang.String)
//  .healthCheckTypes(IResolvable>)
//  .instanceId(java.lang.String)
//  .instanceId(IResolvable)
//  .launchTemplateId(java.lang.String)
//  .launchTemplateId(IResolvable)
//  .launchTemplateOverrides(IResolvable)
//  .launchTemplateOverrides(java.util.List<IResolvable)
//  .launchTemplateOverrides(LaunchTemplateOverridesProperty>)
//  .launchTemplateVersion(java.lang.String)
//  .launchTemplateVersion(IResolvable)
//  .loadBalancerIds(IResolvable)
//  .loadBalancerIds(java.util.List<java.lang.String)
//  .loadBalancerIds(IResolvable>)
//  .maxInstanceLifetime(java.lang.Number)
//  .maxInstanceLifetime(IResolvable)
//  .multiAzPolicy(java.lang.String)
//  .multiAzPolicy(IResolvable)
//  .notificationConfigurations(IResolvable)
//  .notificationConfigurations(java.util.List<IResolvable)
//  .notificationConfigurations(NotificationConfigurationsProperty>)
//  .onDemandBaseCapacity(java.lang.Number)
//  .onDemandBaseCapacity(IResolvable)
//  .onDemandPercentageAboveBaseCapacity(java.lang.Number)
//  .onDemandPercentageAboveBaseCapacity(IResolvable)
//  .protectedInstances(IResolvable)
//  .protectedInstances(java.util.List<java.lang.String)
//  .protectedInstances(IResolvable>)
//  .removalPolicys(IResolvable)
//  .removalPolicys(java.util.List<java.lang.String)
//  .removalPolicys(IResolvable>)
//  .resourceGroupId(java.lang.String)
//  .resourceGroupId(IResolvable)
//  .scalingGroupName(java.lang.String)
//  .scalingGroupName(IResolvable)
//  .scalingPolicy(java.lang.String)
//  .scalingPolicy(IResolvable)
//  .serverGroups(IResolvable)
//  .serverGroups(java.util.List<IResolvable)
//  .serverGroups(ServerGroupsProperty>)
//  .spotAllocationStrategy(java.lang.String)
//  .spotAllocationStrategy(IResolvable)
//  .spotInstancePools(java.lang.Number)
//  .spotInstancePools(IResolvable)
//  .spotInstanceRemedy(java.lang.Boolean)
//  .spotInstanceRemedy(IResolvable)
//  .standbyInstances(IResolvable)
//  .standbyInstances(java.util.List<java.lang.String)
//  .standbyInstances(IResolvable>)
//  .tags(java.util.List<TagsProperty>)
//  .vSwitchId(java.lang.String)
//  .vSwitchId(IResolvable)
//  .vSwitchIds(IResolvable)
//  .vSwitchIds(java.util.List<java.lang.String)
//  .vSwitchIds(IResolvable>)
    .build();

scope^Required

• Type: com.aliyun.ros.cdk.core.Construct

id^Required

• Type: java.lang.String

enableResourcePropertyConstraint^Optional

• Type: java.lang.Boolean

maxSize^Required

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property maxSize: The maximum number of ECS instances that can be contained in the scaling group.

If the number of ECS instances in the scaling group is greater than the value of the MaxSize parameter, Auto Scaling automatically removes ECS instances until the number of instances in the scaling group is equal to the maximum number. The value range of the MaxSize parameter varies based on the instance quota. You can go to Quota Center to check the maximum number of instances that a scaling group can contain. For example, if a scaling group can contain up to 2,000 instances, the value range of the MaxSize parameter is 0 to 2000.

minSize^Required

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property minSize: Minimum number of ECS instances in the scaling group.

Value range: [0, 2000].

allocationStrategy^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property allocationStrategy: The allocation policy of instances.

Auto Scaling selects instance types based on the allocation policy to create the required number of instances. The policy can be applied to pay-as-you-go instances and preemptible instances. This parameter takes effect only if you set MultiAZPolicy to COMPOSABLE. Valid values:

• priority: Auto Scaling selects instance types based on the specified order to create the required number of instances.
• lowestPrice: Auto Scaling selects instance types that have the lowest unit price of vCPUs to create the required number of instances. Default value: priority.

azBalance^Optional

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property azBalance: Specifies whether to evenly distribute instances in the scaling group across multiple zones.

This parameter takes effect only if you set MultiAZPolicy to COMPOSABLE. Valid values:

• true
• false Default value: false.

compensateWithOnDemand^Optional

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property compensateWithOnDemand: Specifies whether to automatically create pay-as-you-go instances to meet the requirements on the number of instances when the expected capacity of preemptible instances cannot be fulfilled due to reasons such as high prices or insufficient resources.

This parameter takes effect only when MultiAZPolicy is set to COST_OPTIMIZED. Default value: true.

containerGroupId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property containerGroupId: The ID of the elastic container instance.

customPolicyArn^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property customPolicyArn: The Alibaba Cloud Resource Name (ARN) of the custom scale-in policy (Function).

This parameter takes effect only if you specify CustomPolicy as the value of first item of RemovalPolicys.

dbInstanceIds^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property dbInstanceIds: The IDs of the ApsaraDB RDS instances that you want to associate with the scaling group.

The value can be a JSON array that contains multiple ApsaraDB RDS instance IDs. Separate multiple IDs with commas (,). You can associate only a limited number of ApsaraDB RDS instances with a scaling group. Go to Quota Center to check the maximum number of ApsaraDB RDS instances that you can associate with a scaling group.

defaultCooldown^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property defaultCooldown: Default cool-down time (in seconds) of the scaling group.

Value range: [0, 86400]. The default value is 300s.

desiredCapacity^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property desiredCapacity: The expected number of ECS instances in a scaling group.

The scaling group automatically keeps the number of ECS instances as expected. The number of ECS instances cannot be greater than the value of MaxSize and cannot be less than the value of MinSize.

groupDeletionProtection^Optional

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property groupDeletionProtection: Whether to enable deletion protection for scaling group.

Default to False.

groupType^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property groupType: The type of instances that are managed by the scaling group.

Valid values: ECS ECI Default value: ECS.

healthCheckType^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property healthCheckType: The health check type.

Allow values is "ECS" and "NONE", default to "ECS".

healthCheckTypes^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property healthCheckTypes: The health check method for the scaling group.

You can specify multiple values for this parameter to enable multiple health check options. If the HealthCheckType parameter is set, this parameter is ignored.

instanceId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property instanceId: The ID of the ECS instance from which the scaling group obtains configuration information of the specified instance.

launchTemplateId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property launchTemplateId: The ID of the instance launch template from which the scaling group obtains launch configurations.

launchTemplateOverrides^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListLaunchTemplateOverridesProperty>

Property launchTemplateOverrides: You can specify up to 10 overrides.

Note: This parameter takes effect only if you specify LaunchTemplateId.

launchTemplateVersion^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property launchTemplateVersion: The version of the instance launch template.

Valid values: A fixed template version numbe. Default: The default template version is always used. Latest: The latest template version is always used.

loadBalancerIds^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property loadBalancerIds: The IDs of the CLB instances that you want to associate with the scaling group.

The value can be a JSON array that contains multiple CLB instance IDs. Separate multiple IDs with commas (,). You can associate only a limited number of CLB instances with a scaling group. Go to Quota Center to check the maximum number of CLB instances that you can associate with a scaling group.

maxInstanceLifetime^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property maxInstanceLifetime: The maximum life span of an ECS instance in the scaling group.

Unit: seconds. Valid values: 86400 to the value of Integer.maxValue. Default value: null. Note: This parameter is unavailable for scaling groups of the ECI type or scaling groups whose ScalingPolicy is set to recycle.

multiAzPolicy^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property multiAzPolicy: The scaling policy for the multi-zone scaling group that contains ECS instances.

Valid values:

• PRIORITY: Auto Scaling scales ECS instances based on the priority of the vSwitch that is specified by the VSwitchIds.N parameter. Auto Scaling preferentially scales instances in the zone where the vSwitch that has the highest priority resides. If the scaling fails, Auto Scaling scales instances in the zone where the vSwitch that has the next highest priority resides.
• COST_OPTIMIZED: Auto Scaling preferentially creates ECS instances whose vCPUs are provided at the lowest price and removes ECS instances whose vCPUs are provided at the highest price. If preemptible instance types are specified in the scaling configuration, Auto Scaling preferentially creates preemptible instances. You can use the CompensateWithOnDemand parameter to specify whether to automatically create pay-as-you-go instances when preemptible instances cannot be created due to insufficient resources. Note The COST_OPTIMIZED **setting takes effect only when you specify multiple instance types or when you specify at least one preemptible instance type.
• BALANCE: Auto Scaling evenly distributes ECS instances across zones that are specified for the scaling group. If ECS instances are unevenly distributed across zones due to insufficient resources, you can call the RebalanceInstance operation to evenly distribute the instances across the zones.
• COMPOSABLE: You can combine the preceding policies based on your business requirements. Default value: PRIORITY.

notificationConfigurations^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListNotificationConfigurationsProperty>

Property notificationConfigurations: When a scaling event occurs in a scaling group, ESS will send a notification to Cloud Monitor or MNS.

onDemandBaseCapacity^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property onDemandBaseCapacity: The minimum number of pay-as-you-go instances required in the scaling group.

Valid values: 0 to 1000. If the number of pay-as-you-go instances is less than the value of this parameter, Auto Scaling preferentially creates pay-as-you-go instances. If you set MultiAZPolicy to COMPOSABLE Policy, the default value of this parameter is 0.

onDemandPercentageAboveBaseCapacity^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property onDemandPercentageAboveBaseCapacity: The percentage of pay-as-you-go instances that can be created when instances are added to the scaling group.

This parameter takes effect when the number of pay-as-you-go instances reaches the value for the OnDemandBaseCapacity parameter. Valid values: 0 to 100. If you set MultiAZPolicy to COMPOSABLE, the default value of this parameter is 100.

protectedInstances^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property protectedInstances: ECS instances of protected mode in the scaling group.

removalPolicys^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property removalPolicys: Policy for removing ECS instances from the scaling group.

Optional values:

• OldestInstance: removes the first ECS instance attached to the scaling group.
• NewestInstance: removes the first ECS instance attached to the scaling group.
• OldestScalingConfiguration: removes the ECS instance with the oldest scaling configuration.
• CustomPolicy: removes ECS instances based on the custom scale-in policy (Function). You can enter up to three removal policies. You cannot set any item of RemovalPolicys to the same value. The scaling configuration source specified by the OldestScalingConfiguration setting can be a scaling configuration or a launch template. You can specify CustomPolicy only as the value of first item of RemovalPolicys. If you set first item of RemovalPolicys to CustomPolicy, you must also specify CustomPolicyARN. Note: The removal of ECS instances from a scaling group is also affected by the value of MultiAZPolicy.

resourceGroupId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property resourceGroupId: Resource group id.

scalingGroupName^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property scalingGroupName: The name of the scaling group.

The name of each scaling group must be unique in a region. 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. If you do not specify this parameter, the value of the ScalingGroupId parameter is used.

scalingPolicy^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property scalingPolicy: The reclaim mode of the scaling group.

Valid values: recycle release forcerelease ScalingPolicy specifies the reclaim modes of scaling groups, but the policy that is used to remove ECS instances from scaling groups is determined by the RemovePolicy parameter of the RemoveInstances operation.

serverGroups^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListServerGroupsProperty>

Property serverGroups: The config of server group.

spotAllocationStrategy^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property spotAllocationStrategy: The allocation policy of preemptible instances.

You can use this parameter to individually specify the allocation policy of preemptible instances. This parameter takes effect only if you set MultiAZPolicy to COMPOSABLE. Valid values:

• priority: Auto Scaling selects instance types based on the specified order to create the required number of preemptible instances.
• lowestPrice: Auto Scaling selects instance types that have the lowest unit price of vCPUs to create the required number of preemptible instances. Default value: priority.

spotInstancePools^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property spotInstancePools: The number of instance types that are available.

The system creates preemptible instances of multiple instance types that are available at the lowest cost in the scaling group. Valid values: 1 to 10. If you set MultiAZPolicy to COMPOSABLE, the default value of this parameter is 2.

spotInstanceRemedy^Optional

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property spotInstanceRemedy: Specifies whether to supplement preemptible instances.

If this parameter is set to true, Auto Scaling attempts to create an instance to replace a preemptible instance when Auto Scaling receives a system message which indicates that the preemptible instance is to be reclaimed.

standbyInstances^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property standbyInstances: ECS instances of standby mode in the scaling group.

tags^Optional

• Type: java.util.List<TagsProperty>

Property tags: Tags to attach to instance.

Max support 20 tags to add during create instance. Each tag with two properties Key and Value, and Key is required.

vSwitchId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property vSwitchId: The ID of the vSwitch.

If you specify the VSwitchId parameter, the network type of the scaling group is VPC.

vSwitchIds^Optional

• Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.List

Property vSwitchIds: The IDs of vSwitches.

If you specify the VSwitchIds.N parameter, the VSwitchId parameter is ignored. If you specify the VSwitchIds.N parameter, the network type of the scaling group is VPC. If you specify multiple vSwitches, take note of the following items:

• The vSwitches must belong to the same VPC.
• The vSwitches can belong to different zones.
• The vSwitches are sorted in ascending order of priority. The first vSwitch that is specified by the VSwitchIds.N parameter has the highest priority. If Auto Scaling fails to create ECS instances in the zone where the vSwitch that has the highest priority resides, Auto Scaling creates ECS instances in the zone where the vSwitch that has the next highest priority resides.

Methods

toString

public java.lang.String toString()

Returns a string representation of this construct.

synthesize

public void synthesize(ISynthesisSession session)

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

session^Required

• Type: com.aliyun.ros.cdk.core.ISynthesisSession

The synthesis session.

addCondition

public void addCondition(RosCondition condition)

condition^Required

• Type: com.aliyun.ros.cdk.core.RosCondition

addCount

public void addCount(java.lang.Number OR IResolvable count)

count^Required

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

addDependency

public void addDependency(Resource resource)

resource^Required

• Type: com.aliyun.ros.cdk.core.Resource

addResourceDesc

public void addResourceDesc(java.lang.String desc)

desc^Required

• Type: java.lang.String

applyRemovalPolicy

public void applyRemovalPolicy(RemovalPolicy policy)

policy^Required

• Type: com.aliyun.ros.cdk.core.RemovalPolicy

fetchCondition

public RosCondition fetchCondition()

fetchDependency

public java.util.List<java.lang.String> fetchDependency()

fetchResourceDesc

public java.lang.String fetchResourceDesc()

getAtt

public IResolvable getAtt(java.lang.String name)

name^Required

• Type: java.lang.String

setMetadata

public void setMetadata(java.lang.String key, java.lang.Object value)

key^Required

• Type: java.lang.String

value^Required

• Type: java.lang.Object

Static Functions

isConstruct

import com.aliyun.ros.cdk.ess.ScalingGroup;
ScalingGroup.isConstruct(java.lang.Object x)

Return whether the given object is a Construct.

x^Required

• Type: java.lang.Object

Properties

node^Required

public ConstructNode getNode();

• Type: com.aliyun.ros.cdk.core.ConstructNode

The construct tree node associated with this construct.

env^Required

public IResourceEnvironment getEnv();

• Type: com.aliyun.ros.cdk.core.IResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

ref^Required

public java.lang.String getRef();

• Type: java.lang.String

stack^Required

public Stack getStack();

• Type: com.aliyun.ros.cdk.core.Stack

The stack in which this resource is defined.

resource^Optional

public RosResource getResource();

• Type: com.aliyun.ros.cdk.core.RosResource

attrArn^Required

public java.lang.Object getAttrArn();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Attribute Arn: The Alibaba Cloud Resource Name (ARN).

attrScalingGroupId^Required

public java.lang.Object getAttrScalingGroupId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Attribute ScalingGroupId: Scaling group Id.

attrScalingGroupName^Required

public java.lang.Object getAttrScalingGroupName();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Attribute ScalingGroupName: Scaling group name.

props^Required

public ScalingGroupProps getProps();

• Type: ScalingGroupProps