修改一个伸缩组的基本信息和所属子网,可选参数如果不填则表示不修改该参数,操作说明请参见修改伸缩组的实例数量信息。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
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信息。
|
LaunchTemplateId | String | 否 | lt-yc5kwj1di33uw1qj**** | 实例启动模板ID,配置后表示选择启动模版作为伸缩配置来源。 |
LaunchTemplateVersion | String | 否 | Default | 实例启动模板的版本。取值:
说明 本参数仅当LaunchTemplateId参数存在取值时生有效。\ |
MultiAZPolicy | String | 否 | PRIORITY | 多子网伸缩组的扩缩容策略。取值:
选择策略后的实例扩缩容情况请参见创建伸缩组中的“扩缩容”参数说明。 |
LaunchTemplateOverrides.N.InstanceType | Array of String | 否 | ecs.g2a.large | 指定实例规格。
说明 本参数仅当LaunchTemplateId参数存在取值时生有效。 |
HealthCheckType | String | 否 | ECS | 伸缩组的健康检查方式。取值范围:
|
InstancesDistribution.OnDemandBaseCapacity | Integer | 否 | 200 | 伸缩组中按量计费实例个数的最小值,取值范围:0~2000。当组中按量计费实例个数少于该值时,将优先创建按量计费的实例。 说明 该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效,且该参数不影响最终创建的实例数量,实例数量仍有最大/最小/期望实例数限制。 |
ScalingGroupId | String | 是 | scg-yblhryq64wgh9zmp**** | 伸缩组ID。您可以调用DescribeScalingGroups 接口查询伸缩组ID。 |
InstancesDistribution.CompensateWithOnDemand | Boolean | 否 | false | 是否允许使用按量实例补充抢占式容量。当因价格、库存等原因无法创建足够的抢占式实例时,是否允许使用按量实例补充抢占式容量。取值:
|
InstancesDistribution.SpotInstanceRemedy | Boolean | 否 | false | 是否允许抢占式实例到期替换。开启则表示在抢占式实例被回收前5分钟左右,伸缩组将主动新建新的抢占式实例替换掉当前抢占式实例。取值:
|
InstancesDistribution.OnDemandPercentageAboveBaseCapacity | Integer | 否 | 0 | 伸缩组满足最小按量实例数要求后,超出的实例中按量实例应占的比例,取值范围:0~100。伸缩组满足最小按量实例数要求后,超出的实例中按量实例应占的比例,取值范围:0~100。 说明 该参数仅当伸缩组绑定的伸缩配置来源的计费类型为抢占式类型时生效。 |
LaunchTemplateOverrides.N.PriceLimit | Array of Float | 否 | 0.001 | 指定抢占式实例规格每小时的最高价格。
说明 本参数仅当 |
ActiveScalingConfigurationId | String | 否 | scc-yblhz5oxzml8j1gv**** | 伸缩组绑定的伸缩配置的ID。您可以调用DescribeScalingConfigurations 接口查询伸缩配置ID。 |
DefaultCooldown | Integer | 否 | 300 | 执行一次伸缩活动(添加或移出ECS实例)结束后的冷却时间。 |
DesireInstanceNumber | Integer | 否 | 2 | 伸缩组中期望运行的实例个数。更多介绍请参见 期望实例数。
|
InstanceTerminatePolicy | String | 否 | NewestInstance | 实例移除策略,取值:
|
MaxInstanceNumber | Integer | 否 | 3 | 伸缩组中实例个数的最大值,默认取值0 ~ 100。 |
MinInstanceNumber | Integer | 否 | 1 | 伸缩组中实例个数的最小值,默认取值0 ~ 100。 |
ScalingGroupName | String | 否 | scaling-group-test | 伸缩组名称,同一地域下伸缩组名称唯一,取值:
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
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****" } }
您可访问公共错误码,获取更多错误码信息。