修改期望实例数
最近更新时间: 2026-11-07 00:12:51
1. 接口描述
接口请求域名： as.api3.fincloud.tencent.cn。
本接口（ModifyDesiredCapacity）用于修改指定伸缩组的期望实例数
默认接口请求频率限制：20次/秒。
接口更新时间：2019-11-01 11:13:15。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：ModifyDesiredCapacity |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-19 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| AutoScalingGroupId | 是 | 否 | String | 伸缩组ID 示例值： asg-nvnlpbb8 |
| MinSize | 否 | 是 | Uint64 | 最小实例数，取值范围为0-2000。需满足最大值大于等于期望值，期望值大于等于最小值。 示例值： 1 |
| MaxSize | 否 | 是 | Uint64 | 最大实例数，取值范围为0-2000。需满足最大值大于等于期望值，期望值大于等于最小值。 示例值： 10 |
| AssertOriginDesiredCapacity | 否 | 是 | Uint64 | 声明修改前的原有期望实例数。若需要明确指定期望实例数由 A 修改为 B，则该参数传入 A，DesiredCapacity参数传入 B。如声明值与实际值不一致，则本次修改失败。 示例值： 10 |
| DesiredCapacity | 是 | 否 | Uint64 | 期望实例数 示例值： 2 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误 |
| LimitExceeded.DesiredCapacityLimitExceeded | 期望实例数超出限制。 |
| InvalidParameterValue.Size | 伸缩组最大数量、最小数量、期望实例数取值不合法。 |
| ResourceUnavailable.AutoScalingGroupDisabled | 伸缩组被停用。 |
| ResourceUnavailable.AutoScalingGroupAbnormalStatus | 伸缩组状态异常。 |
| InvalidParameterValue.Range | 取值超出指定范围。 |
| InvalidParameterValue.InvalidAutoScalingGroupId | |
| ResourceNotFound.AutoScalingGroupNotFound | |
| InvalidParameterValue.BaseCapacityTooLarge | |
| InvalidParameter.ActionNotFound | |
| InvalidParameterValue.AssertDesiredCapacityFailed |
5. 示例
示例1 修改伸缩组期望实例数
输入示例
https://as.api3.fincloud.tencent.cn/?Action=ModifyDesiredCapacity
&AutoScalingGroupId=asg-nvnlpbb8
&DesiredCapacity=2
&<Common Parameters>
输出示例
{
"Response": {
"RequestId": "2f7c0f11-edfd-4598-a5f6-fb5c10cc9d8e"
}
}