public class ModifyAutoScalingGroupRequest extends AbstractModel
header, skipSign| Constructor and Description | 
|---|
| ModifyAutoScalingGroupRequest() | 
| ModifyAutoScalingGroupRequest(ModifyAutoScalingGroupRequest source)NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy,
       and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy. | 
| Modifier and Type | Method and Description | 
|---|---|
| String | getAutoScalingGroupId()Get 伸缩组ID。可以通过如下方式获取可用的伸缩组ID:
通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ,取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 | 
| String | getAutoScalingGroupName()Get 伸缩组名称,在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超55个字节。 | 
| Boolean | getCapacityRebalance()Get 容量重平衡功能,仅对伸缩组内的竞价实例有效。取值范围:
 TRUE,开启该功能,当伸缩组内的竞价实例即将被竞价实例服务自动回收前,AS 主动发起竞价实例销毁流程,如果有配置过缩容 hook,则销毁前 hook 会生效。销毁流程启动后,AS 会异步开启一个扩容活动,用于补齐期望实例数。 
 FALSE,不开启该功能,则 AS 等待竞价实例被销毁后才会去扩容补齐伸缩组期望实例数。 | 
| Long | getDefaultCooldown()Get 默认冷却时间,单位秒,取值范围 [0,3600],默认值为300。 | 
| Long | getDesiredCapacity()Get 期望实例数,取值范围 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| String | getHealthCheckType()Get 伸缩组实例健康检查类型,取值如下:
CVM:根据实例网络状态判断实例是否处于不健康状态,不健康的网络状态即发生实例 PING 不可达事件,详细判断标准可参考[实例健康检查](https://cloud.tencent.com/document/product/377/8553)
CLB:根据 CLB 的健康检查状态判断实例是否处于不健康状态,CLB健康检查原理可参考[健康检查](https://cloud.tencent.com/document/product/214/6097) | 
| String | getInstanceAllocationPolicy()Get 实例分配策略,取值包括 LAUNCH_CONFIGURATION 和 SPOT_MIXED。
 LAUNCH_CONFIGURATION,代表传统的按照启动配置模式。
 SPOT_MIXED,代表竞价混合模式。目前仅支持启动配置为按量计费模式时使用混合模式,混合模式下,伸缩组将根据设定扩容按量或竞价机型。使用混合模式时,关联的启动配置的计费类型不可被修改。 | 
| InstanceNameIndexSettings | getInstanceNameIndexSettings()Get 实例名称序号相关设置。开启后为伸缩组内自动创建的实例名称添加递增的数字序号。 | 
| Long | getIpv6AddressCount()Get 实例具有IPv6地址数量的配置,取值包括0、1。默认值为 0,表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络,需在子网中开启 IPv6 CIDR,其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 | 
| String | getLaunchConfigurationId()Get 启动配置ID。可以通过如下方式获取可用的启动配置ID:
通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 查询启动配置ID。
通过调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ,取返回信息中的 LaunchConfigurationId 获取启动配置ID。 | 
| Long | getLoadBalancerHealthCheckGracePeriod()Get CLB健康检查宽限期。 | 
| Long | getMaxSize()Get 最大实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| Long | getMinSize()Get 最小实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| String | getMultiZoneSubnetPolicy()Get 多可用区/子网策略,取值包括 PRIORITY 和 EQUALITY,默认为 PRIORITY。
 PRIORITY,按照可用区/子网列表的顺序,作为优先级来尝试创建实例,如果优先级最高的可用区/子网可以创建成功,则总在该可用区/子网创建。 
 EQUALITY:扩容出的实例会打散到多个可用区/子网,保证扩容后的各个可用区/子网实例数相对均衡。 
与本策略相关的注意点:
 当伸缩组为基础网络时,本策略适用于多可用区;当伸缩组为VPC网络时,本策略适用于多子网,此时不再考虑可用区因素,例如四个子网ABCD,其中ABC处于可用区1,D处于可用区2,此时考虑子网ABCD进行排序,而不考虑可用区1、2。 
 本策略适用于多可用区/子网,不适用于启动配置的多机型。多机型按照优先级策略进行选择。 
 按照 PRIORITY 策略创建实例时,先保证多机型的策略,后保证多可用区/子网的策略。例如多机型A、B,多子网1、2、3,会按照A1、A2、A3、B1、B2、B3 进行尝试,如果A1售罄,会尝试A2(而非B1)。 | 
| Long | getProjectId()Get 项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 ProjectId 字段来获取。默认值为 0,表示使用默认项目。 | 
| String | getRetryPolicy()Get 重试策略,取值包括 IMMEDIATE_RETRY、 INCREMENTAL_INTERVALS、NO_RETRY,默认取值为 IMMEDIATE_RETRY。部分成功的伸缩活动判定为一次失败活动。
IMMEDIATE_RETRY,立即重试,在较短时间内快速重试,连续失败超过一定次数(5次)后不再重试。
INCREMENTAL_INTERVALS,间隔递增重试,随着连续失败次数的增加,重试间隔逐渐增大,重试间隔从秒级到1天不等。
 NO_RETRY,不进行重试,直到再次收到用户调用或者告警信息后才会重试。 | 
| ServiceSettings | getServiceSettings()Get 服务设置,包括云监控不健康替换等服务设置。 | 
| SpotMixedAllocationPolicy | getSpotMixedAllocationPolicy()Get 竞价混合模式下,各计费类型实例的分配策略。
仅当 InstanceAllocationPolicy 取 SPOT_MIXED 时可用。 | 
| String[] | getSubnetIds()Get 子网ID列表。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询;也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ,从接口返回中的SubnetId字段获取。 | 
| String[] | getTerminationPolicies()Get 销毁策略,目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。
 OLDEST_INSTANCE 优先销毁伸缩组中最旧的实例。
 NEWEST_INSTANCE,优先销毁伸缩组中最新的实例。 | 
| String | getVpcId()Get 私有网络ID。修改私有网络时,需将 SubnetIds 参数同步修改为该私有网络的子网。有效的 VpcId 可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询;也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ,从接口返回中的 VpcId 字段获取。 | 
| String[] | getZones()Get 可用区列表 | 
| String | getZonesCheckPolicy()Get 可用区校验策略,取值包括 ALL 和 ANY,默认取值为ANY。在伸缩组实际变更资源相关字段时(启动配置、可用区、子网)发挥作用。
 ALL,所有可用区(Zone)或子网(SubnetId)都可用则通过校验,否则校验报错。
 ANY,存在任何一个可用区(Zone)或子网(SubnetId)可用则通过校验,否则校验报错。
可用区或子网不可用的常见原因包括该可用区CVM实例类型售罄、该可用区CBS云盘售罄、该可用区配额不足、该子网IP不足等。
如果 Zones/SubnetIds 中可用区或者子网不存在,则无论 ZonesCheckPolicy 采用何种取值,都会校验报错。 | 
| void | setAutoScalingGroupId(String AutoScalingGroupId)Set 伸缩组ID。可以通过如下方式获取可用的伸缩组ID:
通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ,取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 | 
| void | setAutoScalingGroupName(String AutoScalingGroupName)Set 伸缩组名称,在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超55个字节。 | 
| void | setCapacityRebalance(Boolean CapacityRebalance)Set 容量重平衡功能,仅对伸缩组内的竞价实例有效。取值范围:
 TRUE,开启该功能,当伸缩组内的竞价实例即将被竞价实例服务自动回收前,AS 主动发起竞价实例销毁流程,如果有配置过缩容 hook,则销毁前 hook 会生效。销毁流程启动后,AS 会异步开启一个扩容活动,用于补齐期望实例数。 
 FALSE,不开启该功能,则 AS 等待竞价实例被销毁后才会去扩容补齐伸缩组期望实例数。 | 
| void | setDefaultCooldown(Long DefaultCooldown)Set 默认冷却时间,单位秒,取值范围 [0,3600],默认值为300。 | 
| void | setDesiredCapacity(Long DesiredCapacity)Set 期望实例数,取值范围 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| void | setHealthCheckType(String HealthCheckType)Set 伸缩组实例健康检查类型,取值如下:
CVM:根据实例网络状态判断实例是否处于不健康状态,不健康的网络状态即发生实例 PING 不可达事件,详细判断标准可参考[实例健康检查](https://cloud.tencent.com/document/product/377/8553)
CLB:根据 CLB 的健康检查状态判断实例是否处于不健康状态,CLB健康检查原理可参考[健康检查](https://cloud.tencent.com/document/product/214/6097) | 
| void | setInstanceAllocationPolicy(String InstanceAllocationPolicy)Set 实例分配策略,取值包括 LAUNCH_CONFIGURATION 和 SPOT_MIXED。
 LAUNCH_CONFIGURATION,代表传统的按照启动配置模式。
 SPOT_MIXED,代表竞价混合模式。目前仅支持启动配置为按量计费模式时使用混合模式,混合模式下,伸缩组将根据设定扩容按量或竞价机型。使用混合模式时,关联的启动配置的计费类型不可被修改。 | 
| void | setInstanceNameIndexSettings(InstanceNameIndexSettings InstanceNameIndexSettings)Set 实例名称序号相关设置。开启后为伸缩组内自动创建的实例名称添加递增的数字序号。 | 
| void | setIpv6AddressCount(Long Ipv6AddressCount)Set 实例具有IPv6地址数量的配置,取值包括0、1。默认值为 0,表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络,需在子网中开启 IPv6 CIDR,其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 | 
| void | setLaunchConfigurationId(String LaunchConfigurationId)Set 启动配置ID。可以通过如下方式获取可用的启动配置ID:
通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 查询启动配置ID。
通过调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ,取返回信息中的 LaunchConfigurationId 获取启动配置ID。 | 
| void | setLoadBalancerHealthCheckGracePeriod(Long LoadBalancerHealthCheckGracePeriod)Set CLB健康检查宽限期。 | 
| void | setMaxSize(Long MaxSize)Set 最大实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| void | setMinSize(Long MinSize)Set 最小实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。 | 
| void | setMultiZoneSubnetPolicy(String MultiZoneSubnetPolicy)Set 多可用区/子网策略,取值包括 PRIORITY 和 EQUALITY,默认为 PRIORITY。
 PRIORITY,按照可用区/子网列表的顺序,作为优先级来尝试创建实例,如果优先级最高的可用区/子网可以创建成功,则总在该可用区/子网创建。 
 EQUALITY:扩容出的实例会打散到多个可用区/子网,保证扩容后的各个可用区/子网实例数相对均衡。 
与本策略相关的注意点:
 当伸缩组为基础网络时,本策略适用于多可用区;当伸缩组为VPC网络时,本策略适用于多子网,此时不再考虑可用区因素,例如四个子网ABCD,其中ABC处于可用区1,D处于可用区2,此时考虑子网ABCD进行排序,而不考虑可用区1、2。 
 本策略适用于多可用区/子网,不适用于启动配置的多机型。多机型按照优先级策略进行选择。 
 按照 PRIORITY 策略创建实例时,先保证多机型的策略,后保证多可用区/子网的策略。例如多机型A、B,多子网1、2、3,会按照A1、A2、A3、B1、B2、B3 进行尝试,如果A1售罄,会尝试A2(而非B1)。 | 
| void | setProjectId(Long ProjectId)Set 项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 ProjectId 字段来获取。默认值为 0,表示使用默认项目。 | 
| void | setRetryPolicy(String RetryPolicy)Set 重试策略,取值包括 IMMEDIATE_RETRY、 INCREMENTAL_INTERVALS、NO_RETRY,默认取值为 IMMEDIATE_RETRY。部分成功的伸缩活动判定为一次失败活动。
IMMEDIATE_RETRY,立即重试,在较短时间内快速重试,连续失败超过一定次数(5次)后不再重试。
INCREMENTAL_INTERVALS,间隔递增重试,随着连续失败次数的增加,重试间隔逐渐增大,重试间隔从秒级到1天不等。
 NO_RETRY,不进行重试,直到再次收到用户调用或者告警信息后才会重试。 | 
| void | setServiceSettings(ServiceSettings ServiceSettings)Set 服务设置,包括云监控不健康替换等服务设置。 | 
| void | setSpotMixedAllocationPolicy(SpotMixedAllocationPolicy SpotMixedAllocationPolicy)Set 竞价混合模式下,各计费类型实例的分配策略。
仅当 InstanceAllocationPolicy 取 SPOT_MIXED 时可用。 | 
| void | setSubnetIds(String[] SubnetIds)Set 子网ID列表。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询;也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ,从接口返回中的SubnetId字段获取。 | 
| void | setTerminationPolicies(String[] TerminationPolicies)Set 销毁策略,目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。
 OLDEST_INSTANCE 优先销毁伸缩组中最旧的实例。
 NEWEST_INSTANCE,优先销毁伸缩组中最新的实例。 | 
| void | setVpcId(String VpcId)Set 私有网络ID。修改私有网络时,需将 SubnetIds 参数同步修改为该私有网络的子网。有效的 VpcId 可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询;也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ,从接口返回中的 VpcId 字段获取。 | 
| void | setZones(String[] Zones)Set 可用区列表 | 
| void | setZonesCheckPolicy(String ZonesCheckPolicy)Set 可用区校验策略,取值包括 ALL 和 ANY,默认取值为ANY。在伸缩组实际变更资源相关字段时(启动配置、可用区、子网)发挥作用。
 ALL,所有可用区(Zone)或子网(SubnetId)都可用则通过校验,否则校验报错。
 ANY,存在任何一个可用区(Zone)或子网(SubnetId)可用则通过校验,否则校验报错。
可用区或子网不可用的常见原因包括该可用区CVM实例类型售罄、该可用区CBS云盘售罄、该可用区配额不足、该子网IP不足等。
如果 Zones/SubnetIds 中可用区或者子网不存在,则无论 ZonesCheckPolicy 采用何种取值,都会校验报错。 | 
| void | toMap(HashMap<String,String> map,
     String prefix)Internal implementation, normal users should not use it. | 
any, fromJsonString, getBinaryParams, GetHeader, getMultipartRequestParams, getSkipSign, isStream, set, SetHeader, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonStringpublic ModifyAutoScalingGroupRequest()
public ModifyAutoScalingGroupRequest(ModifyAutoScalingGroupRequest source)
public String getAutoScalingGroupId()
public void setAutoScalingGroupId(String AutoScalingGroupId)
AutoScalingGroupId - 伸缩组ID。可以通过如下方式获取可用的伸缩组ID:
public String getAutoScalingGroupName()
public void setAutoScalingGroupName(String AutoScalingGroupName)
AutoScalingGroupName - 伸缩组名称,在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超55个字节。public Long getDefaultCooldown()
public void setDefaultCooldown(Long DefaultCooldown)
DefaultCooldown - 默认冷却时间,单位秒,取值范围 [0,3600],默认值为300。public Long getDesiredCapacity()
public void setDesiredCapacity(Long DesiredCapacity)
DesiredCapacity - 期望实例数,取值范围 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。public String getLaunchConfigurationId()
public void setLaunchConfigurationId(String LaunchConfigurationId)
LaunchConfigurationId - 启动配置ID。可以通过如下方式获取可用的启动配置ID:
public Long getMaxSize()
public void setMaxSize(Long MaxSize)
MaxSize - 最大实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。public Long getMinSize()
public void setMinSize(Long MinSize)
MinSize - 最小实例数,取值范围为 [0,2000]。需满足最大值大于等于期望值,期望值大于等于最小值。public Long getProjectId()
public void setProjectId(Long ProjectId)
ProjectId - 项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 ProjectId 字段来获取。默认值为 0,表示使用默认项目。public String[] getSubnetIds()
public void setSubnetIds(String[] SubnetIds)
SubnetIds - 子网ID列表。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询;也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ,从接口返回中的SubnetId字段获取。public String[] getTerminationPolicies()
public void setTerminationPolicies(String[] TerminationPolicies)
TerminationPolicies - 销毁策略,目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。
public String getVpcId()
public void setVpcId(String VpcId)
VpcId - 私有网络ID。修改私有网络时,需将 SubnetIds 参数同步修改为该私有网络的子网。有效的 VpcId 可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询;也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ,从接口返回中的 VpcId 字段获取。public String[] getZones()
public void setZones(String[] Zones)
Zones - 可用区列表public String getRetryPolicy()
public void setRetryPolicy(String RetryPolicy)
RetryPolicy - 重试策略,取值包括 IMMEDIATE_RETRY、 INCREMENTAL_INTERVALS、NO_RETRY,默认取值为 IMMEDIATE_RETRY。部分成功的伸缩活动判定为一次失败活动。
public String getZonesCheckPolicy()
public void setZonesCheckPolicy(String ZonesCheckPolicy)
ZonesCheckPolicy - 可用区校验策略,取值包括 ALL 和 ANY,默认取值为ANY。在伸缩组实际变更资源相关字段时(启动配置、可用区、子网)发挥作用。
public ServiceSettings getServiceSettings()
public void setServiceSettings(ServiceSettings ServiceSettings)
ServiceSettings - 服务设置,包括云监控不健康替换等服务设置。public Long getIpv6AddressCount()
public void setIpv6AddressCount(Long Ipv6AddressCount)
Ipv6AddressCount - 实例具有IPv6地址数量的配置,取值包括0、1。默认值为 0,表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络,需在子网中开启 IPv6 CIDR,其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。public String getMultiZoneSubnetPolicy()
public void setMultiZoneSubnetPolicy(String MultiZoneSubnetPolicy)
MultiZoneSubnetPolicy - 多可用区/子网策略,取值包括 PRIORITY 和 EQUALITY,默认为 PRIORITY。
public String getHealthCheckType()
public void setHealthCheckType(String HealthCheckType)
HealthCheckType - 伸缩组实例健康检查类型,取值如下:
public Long getLoadBalancerHealthCheckGracePeriod()
public void setLoadBalancerHealthCheckGracePeriod(Long LoadBalancerHealthCheckGracePeriod)
LoadBalancerHealthCheckGracePeriod - CLB健康检查宽限期。public String getInstanceAllocationPolicy()
public void setInstanceAllocationPolicy(String InstanceAllocationPolicy)
InstanceAllocationPolicy - 实例分配策略,取值包括 LAUNCH_CONFIGURATION 和 SPOT_MIXED。
public SpotMixedAllocationPolicy getSpotMixedAllocationPolicy()
public void setSpotMixedAllocationPolicy(SpotMixedAllocationPolicy SpotMixedAllocationPolicy)
SpotMixedAllocationPolicy - 竞价混合模式下,各计费类型实例的分配策略。
仅当 InstanceAllocationPolicy 取 SPOT_MIXED 时可用。public Boolean getCapacityRebalance()
public void setCapacityRebalance(Boolean CapacityRebalance)
CapacityRebalance - 容量重平衡功能,仅对伸缩组内的竞价实例有效。取值范围:
public InstanceNameIndexSettings getInstanceNameIndexSettings()
public void setInstanceNameIndexSettings(InstanceNameIndexSettings InstanceNameIndexSettings)
InstanceNameIndexSettings - 实例名称序号相关设置。开启后为伸缩组内自动创建的实例名称添加递增的数字序号。Copyright © 2025. All rights reserved.