修改伸缩组
最近更新时间: 2024-10-18 10:38:33
1. 接口描述
接口请求域名： as.api3.fincloud.tencent.cn。
本接口（ModifyAutoScalingGroup）用于修改伸缩组。
默认接口请求频率限制：20次/秒。
接口更新时间：2019-10-31 17:04:15。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：ModifyAutoScalingGroup |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-19 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| AutoScalingGroupId | 是 | 否 | String | 伸缩组ID |
| AutoScalingGroupName | 否 | 否 | String | 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 |
| DefaultCooldown | 否 | 否 | Uint64 | 默认冷却时间，单位秒，默认值为300 |
| DesiredCapacity | 否 | 否 | Uint64 | 期望实例数，大小介于最小实例数和最大实例数之间 |
| LaunchConfigurationId | 否 | 否 | String | 启动配置ID |
| MaxSize | 否 | 否 | Uint64 | 最大实例数，取值范围为0-2000。 |
| MinSize | 否 | 否 | Uint64 | 最小实例数，取值范围为0-2000。 |
| ProjectId | 否 | 否 | Uint64 | 项目ID |
| SubnetIds | 否 | 否 | Array of String | 子网ID列表 |
| TerminationPolicies | 否 | 否 | Array of String | 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。<br><br><li> OLDEST_INSTANCE 优先销毁伸缩组中最旧的实例。<br><br><li> NEWEST_INSTANCE，优先销毁伸缩组中最新的实例。 |
| VpcId | 否 | 否 | String | VPC ID，基础网络则填空字符串。修改为具体VPC ID时，需指定相应的SubnetIds；修改为基础网络时，需指定相应的Zones。 |
| Zones | 否 | 否 | Array of String | 可用区列表 |
| RetryPolicy | 否 | 否 | String | 重试策略，取值包括 IMMEDIATE_RETRY、 INCREMENTAL_INTERVALS、NO_RETRY，默认取值为 IMMEDIATE_RETRY。<br><br><li> IMMEDIATE_RETRY，立即重试，在较短时间内快速重试，连续失败超过一定次数（5次）后不再重试。<br><br><li> INCREMENTAL_INTERVALS，间隔递增重试，随着连续失败次数的增加，重试间隔逐渐增大，重试间隔从秒级到1天不等。<br><br><li> NO_RETRY，不进行重试，直到再次收到用户调用或者告警信息后才会重试。 |
| ZonesCheckPolicy | 否 | 否 | String | 可用区校验策略，取值包括 ALL 和 ANY，默认取值为ANY。在伸缩组实际变更资源相关字段时（启动配置、可用区、子网）发挥作用。<br><br><li> ALL，所有可用区（Zone）或子网（SubnetId）都可用则通过校验，否则校验报错。<br><br><li> ANY，存在任何一个可用区（Zone）或子网（SubnetId）可用则通过校验，否则校验报错。<br><br>可用区或子网不可用的常见原因包括该可用区CVM实例类型售罄、该可用区CBS云盘售罄、该可用区配额不足、该子网IP不足等。<br>如果 Zones/SubnetIds 中可用区或者子网不存在，则无论 ZonesCheckPolicy 采用何种取值，都会校验报错。 |
| ServiceSettings | 否 | 否 | ServiceSettings | 服务设置，包括云监控不健康替换等服务设置。 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue.OnlyVpc | |
| InvalidParameter.InScenario | |
| InvalidParameterValue.LbProjectInconsistent | |
| InvalidParameterValue.Range | |
| InvalidParameterValue.TooLong | |
| ResourceUnavailable.ProjectInconsistent | |
| InvalidParameterValue.GroupNameDuplicated | |
| LimitExceeded.MaxSizeLimitExceeded | |
| ResourceNotFound.AutoScalingGroupIdNotFound | |
| InvalidParameterValue.Size | |
| MissingParameter | |
| InvalidParameterValue.LbVpcInconsistent | |
| LimitExceeded.MinSizeLimitExceeded | |
| LimitExceeded | |
| InvalidParameterValue.CvmError | |
| InvalidParameterValue.LaunchConfigurationNotFound | |
| InvalidParameterValue.SubnetIds | |
| MissingParameter.InScenario | |
| ResourceUnavailable.LaunchConfigurationStatusAbnormal | |
| InvalidParameterValue.LimitExceeded |