You need to enable JavaScript to run this app.
导航

ModifyScalingGroup - 修改一个伸缩组

最近更新时间2024.05.16 10:34:04

首次发布时间2022.05.13 10:42:44

修改一个伸缩组的基本信息和所属子网,可选参数如果不填则表示不修改该参数,操作说明请参见修改伸缩组的实例数量信息

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

ModifyScalingGroup

要执行的操作,取值:ModifyScalingGroup。

Version
String

2020-01-01

API的版本,取值:2020-01-01。

SubnetIds.N
Array of String

subnet-24sdlkdplsjkdjd****

伸缩组中实例主网卡的子网ID列表,修改后与修改前的子网ID必须属于同一私有网络。您可以调用DescribeSubnets接口查询子网ID和子网所属的VPC信息。

  • 参数 - N:表示子网的序号,支持多选。多个子网需属于同一个VPC,同一可用区只允许选择一个子网。
  • 参数 - SubnetId:表示子网ID。
LaunchTemplateId
String

lt-yc5kwj1di33uw1qj****

实例启动模板ID,配置后表示选择启动模版作为伸缩配置来源。

LaunchTemplateVersion
String

Default

实例启动模板的版本。取值:

  • 模板的某个版本号。
  • Default:始终使用模板默认版本。
  • Latest:始终使用模板最新版本。

说明

本参数仅当LaunchTemplateId参数存在取值时生有效。\

MultiAZPolicy
String

PRIORITY

多子网伸缩组的扩缩容策略。取值:

  • PRIORITY:优先级策略。
  • BALANCE:均衡分布策略。

选择策略后的实例扩缩容情况请参见创建伸缩组中的“扩缩容”参数说明。

LaunchTemplateOverrides.N.InstanceType
Array of String

ecs.g2a.large

指定实例规格。

  • 参数 - N:表示实例规格的序号,取值为1 ~ 10。
  • 取值 - InstanceType:表示实例规格。
  • 多个实例规格之间用&分隔。
  • 填写后,会覆盖启动模板中原本的实例规格。

说明

本参数仅当LaunchTemplateId参数存在取值时生有效。

HealthCheckType
String

ECS

伸缩组的健康检查方式。取值范围:

  • NONE(默认):不做实例健康状态检查。
  • ECS:对伸缩组内的ECS实例做健康检查。
InstancesDistribution.OnDemandBaseCapacity
Integer

200

伸缩组中按量计费实例个数的最小值,取值范围:0~2000。当组中按量计费实例个数少于该值时,将优先创建按量计费的实例。

说明

该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效,且该参数不影响最终创建的实例数量,实例数量仍有最大/最小/期望实例数限制。

ScalingGroupId
String

scg-yblhryq64wgh9zmp****

伸缩组ID。您可以调用DescribeScalingGroups 接口查询伸缩组ID。

InstancesDistribution.CompensateWithOnDemand
Boolean

false

是否允许使用按量实例补充抢占式容量。当因价格、库存等原因无法创建足够的抢占式实例时,是否允许使用按量实例补充抢占式容量。取值:

  • true: 允许。
  • false: 不允许。
InstancesDistribution.SpotInstanceRemedy
Boolean

false

是否允许抢占式实例到期替换。开启则表示在抢占式实例被回收前5分钟左右,伸缩组将主动新建新的抢占式实例替换掉当前抢占式实例。取值:

  • true: 允许。
  • false: 不允许。
InstancesDistribution.OnDemandPercentageAboveBaseCapacity
Integer

0

伸缩组满足最小按量实例数要求后,超出的实例中按量实例应占的比例,取值范围:0~100。伸缩组满足最小按量实例数要求后,超出的实例中按量实例应占的比例,取值范围:0~100。

说明

该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效。

LaunchTemplateOverrides.N.PriceLimit
Array of Float

0.001

指定抢占式实例规格每小时的最高价格。

  • 参数 - N:表示实例规格的序号,取值为1 ~ 10。
  • 取值 - PriceLimit:表示抢占式实例规格每小时的最高价格。取值:大于0,且最大不超过3位小数。
  • 多个价格之间用&分隔。

说明

本参数仅当LaunchTemplateId参数存在取值,且启动模版的计费模式为设置出价上限的抢占式实例(即SpotWithPriceLimit)时有效。

ActiveScalingConfigurationId
String

scc-yblhz5oxzml8j1gv****

伸缩组绑定的伸缩配置的ID。您可以调用DescribeScalingConfigurations 接口查询伸缩配置ID。

DefaultCooldown
Integer

300

执行一次伸缩活动(添加或移出ECS实例)结束后的冷却时间。
冷却时间内,该伸缩组不执行其它的伸缩活动,仅针对云监控报警任务触发的伸缩活动和伸缩规则有效。
取值范围:5 ~ 86400,单位:秒。

DesireInstanceNumber
Integer

2

伸缩组中期望运行的实例个数,仅创建伸缩组时设置了期望实例数才能修改该值。更多介绍请参见 期望实例数

  • 修改期望实例数后,将立即触发一次健康检查行为,组中的实例个数也将会随之变化。
  • 取值:不小于最小实例数MinInstanceNumber且不大于最大实例数MaxInstanceNumber。
InstanceTerminatePolicy
String

NewestInstance

实例移除策略,取值:

  • OldestInstance:移出最早加入 (包括自动创建和手动添加)伸缩组的实例。
  • NewestInstance:移出最晚加入(包括自动创建和手动添加)伸缩组的实例。
  • OldestScalingConfigurationWithOldestInstance(默认):移出最早与伸缩组绑定的伸缩配置中,最早由伸缩组 自动创建 的实例。
  • OldestScalingConfigurationWithNewestInstance:移出 最早与伸缩组绑定的伸缩配置中,最晚由伸缩组 自动创建 的实例。
MaxInstanceNumber
Integer

3

伸缩组中实例个数的最大值,默认取值0 ~ 100。

MinInstanceNumber
Integer

1

伸缩组中实例个数的最小值,默认取值0 ~ 100。

ScalingGroupName
String

scaling-group-test

伸缩组名称,同一地域下伸缩组名称唯一,取值:

  • 只能以中文、字母开头。
  • 只能包含中文、字母、数字、下划线和中划线。
  • 长度限制为1 ~ 128个字符 。
  • 暂不支持特殊字符。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
ScalingGroupId
String

scg-yblhryq64wgh9zmp****

伸缩组ID。

请求示例

GET /?Action=ModifyScalingGroup&ScalingGroupId=scg-yblhryq64wgh9zmp%2A%2A%2A%2A%09&Version=2020-01-01 HTTP/1.1
Host: open.volcengineapi.com
X-Date: 20240507T092959Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240507/cn-beijing/auto_scaling/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f


返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024050717301203918304911202AAF7",
    "Version": "2020-01-01",
    "Service": "auto_scaling",
    "Region": "cn-beijing"
  },
  "Result": {
    "ScalingGroupId": "scg-yblhryq64wgh9zmp****"
  }
}

错误码

您可访问公共错误码,获取更多错误码信息。