ModifyScalingGroup
修改伸缩组的属性。
描述
- 创建伸缩组的属性中，有以下属性不可修改：
- RegionId
- LoadBalancerId
说明 如果需要修改负载均衡实例，请使用和接口。
- DBInstanceId
说明 如果需要修改数据库实例，请使用和接口。
- 当伸缩组为 active 或 inactive 状态，才可以调用该接口。
- 当伸缩组已被指定伸缩配置，而需要再次修改伸缩配置时，修改的伸缩配置的 instancetype 属性要和当前生效的伸缩配置的 instancetyp 属性一致。
在伸缩组中加入新的伸缩配置，不会影响通过早前的伸缩配置创建并正在运行的 ECS 实例。
- 当伸缩组的 ECS 实例数（Total Capacity）不满足修改后的 MaxSize 或 MinSize，弹性伸缩服务会自动加入或移出 ECS 实例，使得伸缩组的 ECS 实例数等于 MaxSize 或 MinSize。
请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名，系统规定参数，取值：ModifyScalingGroup。 |
| ScalingGroupId | String | 是 | 伸缩组的 ID。 |
| ScalingGroupName | String | 否 | 伸缩组的显示名称，2-40 个英文或中文字符，以数字、大小字母或中文开头，可包含数字，“_”，“-”或“.”。同一用户账号同一地域内唯一。 |
| ActiveScalingConfigurationId | String | 否 | 伸缩组内生效的伸缩配置 ID。 |
| MinSize | Integer | 否 | 伸缩组内 ECS 实例个数的最小值，取值范围：[0, 100] 。 |
| MaxSize | Integer | 否 | 伸缩组内 ECS 实例个数的最大值，取值范围：[0, 100]。 |
| DefaultCooldown | Integer | 否 | 伸缩组默认的冷却时间，取值范围：[0, 86400]，单位：秒。 |
| RemovalPolicy.N | String | 否 | ECS 实例移出伸缩组的策略。可选值：
最多可以输入 2 个。 |
| LaunchTemplateId | String | 否 | 实例启动模板 ID，用于指定伸缩组从实例启动模板获取启动配置信息。 |
| LaunchTemplateVersion | String | 否 | 实例启动模板采用版本，可选值：
|
| VSwitchIds.N | String | 否 |
|
返回参数
。
示例
请求示例
http://ess.aliyuncs.com/?Action=ModifyScalingGroup
&ScalingGroupId=cqS5QbbhmvGLcJbWoDbWLj2V
&ScalingGroupName=ScalingGroup
&<公共请求参数>正常返回示例
XML 格式
< ModifyScalingGroupResponse>
<RequestId>6469DCD0-13AC-487E-85A0-CE4922908FDE</RequestId>
</ ModifyScalingGroupResponse>JSON 格式
"RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE"错误码
关于所有接口的通用性错误，请参考 或 。
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | InvalidScalingGroupId.NotFound | The specified scaling group does not exist. | 指定的伸缩组在该用户账号下不存在。 |
| 400 | InvalidScalingGroupName.Duplicate | The specified value of parameter <parameter name> is duplicated. |
伸缩组名已存在。 |
| 404 | InvalidScalingConfigurationId.NotFound | The specified scaling configuration does not exist. | 指定的伸缩配置不存在指定的伸缩组中。 |
| 400 | InvalidScalingConfigurationId.InstanceTypeMismatch | The specified scaling configuration and existing active scaling configuration have different instance type. | 指定的伸缩配置的实例规格与当前生效的伸缩配置的实例规格不匹配。 |
| 400 | InvalidParameter.Conflict | The value of parameter <parameter name> and parameter <parameter name> are confilict. |
指定的 MinSize 大于 MaxSize。 |
| 400 | LaunchTemplateVersionSet.NotFound | The specific version of launch template is not exist. | 实例启动模板指定版本不存在。 |
| 400 | LaunchTemplateSet.NotFound | The specified launch template set is not found. | 指定实例启动模板不存在。 |
| 400 | TemplateMissingParameter.ImageId | The input parameter “ImageId” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少镜像信息。 |
| 400 | TemplateMissingParameter.InstanceTypes | The input parameter “InstanceTypes” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少实例规格信息。 |
| 400 | TemplateMissingParameter.SecurityGroup | The input parameter “SecurityGroup” that is mandatory for processing this request is not supplied. | 实例启动模板指定版本缺少安全组信息。 |
| 400 | TemplateVersion.NotNumber | The input parameter “LaunchTemplateVersion” is supposed to be a string representing the version number. | 指定实例启动模板固定版本号为非数字。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4580.html
微信扫一扫
相关推荐
-
开启实例释放保护
如果您的ECS实例承载了关键业务，可以为ECS实例开启实例释放保护，防止手动释放ECS实例，有效避免因沟通不畅、操作疏忽等原因造成不可挽回的后果。本文为您介绍如何开启和关闭实例释放保护，查看实例的保护状态，并演示了保护效果。 使用限制 实例释放保护仅适用于按量付费实例。 因合理原…
-
ECS实例生命周期的管理
本文主要介绍ECS实例生命周期管理。 加入伸缩组的 ECS 实例有两种类型：自动创建的 ECS 实例、手工添加的 ECS 实例。 自动创建的 ECS 实例 自动创建的 ECS 实例是指根据用户的伸缩配置和伸缩规则，由弹性伸缩服务自动创建的 ECS 实例。 弹性伸缩服务负责该类型 …
-
移出不健康ECS实例
本文主要介绍移出不健康实例的操作。 当 ECS 实例成功加入伸缩组后，弹性伸缩服务会定期扫描该 ECS 实例的运行状态，如果发现该 ECS 实例为非 运行中（Running）状态，则会将该 ECS 实例移出伸缩组。 对于弹性服务自动创建的 ECS 实例：将立即启动移出和释放该 E…
-
费用计算
本文主要介绍弹性伸缩的费用计算。 您可以免费开通弹性伸缩服务。但是，如果弹性伸缩服务根据伸缩配置自动创建了 ECS 实例，或者您手动添加了已有 ECS 实例，您需要为 ECS 实例支付费用。有关 ECS 实例的产品定价，请参考 计费概述。实例停机不收费功能仅适用于按量付费的 VP…
-
CreateScalingGroup
创建一个伸缩组（CreateScalingGroup）。伸缩组是具有相同应用场景的 ECS 实例集合，伸缩组有最大 ECS 实例数、最小 ECS 实例数、移出策略、冷却时间、关联的负载均衡实例和关联的 RDS 实例等属性。 描述 伸缩组、关联的负载均衡实例和关联的 RDS 实例必…
-
如何保证幂等性
本文介绍如何保证幂等性。 当通过调用执行伸缩规则接口在创建或释放 ECS 实例时，如果遇到了请求超时或服务器内部错误时，客户端可能会尝试重发请求，这时客户端可以通过提供可选参数 ClientToken 避免服务器创建或释放出比预期要多的实例，即通过提供 ClientToken 参…
