执行一条伸缩规则。
接口说明
接口说明
调用该接口需注意以下几点:
-
调用该接口前,请确保满足以下条件:
伸缩组处于
Active状态。伸缩组没有执行中的伸缩活动。
-
当伸缩组没有执行中的伸缩活动时,该接口可以绕过冷却时间(Cooldown)直接执行伸缩活动。
-
如果伸缩规则需要增加的 ECS 实例数加上当前伸缩组的实例数(Total Capacity)大于最大实例数(MaxSize),则按 Total Capacity=MaxSize 执行伸缩活动。
-
如果当前伸缩组的实例数(Total Capacity)减去伸缩规则需要减少的 ECS 实例数小于最小实例数(MinSize),则按 Total Capacity=MinSize 执行伸缩活动。
调用该接口返回成功,只是表示弹性伸缩服务接受了该接口的调用请求,可以执行伸缩活动,但不代表伸缩活动能够执行成功。您需要通过返回的ScalingActivityId查看该伸缩活动的执行状态。
单次调整的 ECS 实例台数存在限制,请参见 CreateScalingRule 中的 AdjustmentValue 参数说明。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ess:ExecuteScalingRule |
update |
*ScalingGroup
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ScalingRuleAri |
string |
是 |
伸缩规则唯一标识符。 说明
调用 API 执行伸缩规则时,只支持执行简单规则和步进规则,且执行步进规则时必须同时指定 |
ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7**** |
| ClientToken |
string |
否 |
用于保证请求的幂等性。 由客户端生成该参数值,要保证在不同请求间唯一,最大不超过 64 个 ASCII 字符。更多信息,请参见如何保证幂等性。 |
123e4567-e89b-12d3-a456-426655440000 |
| BreachThreshold |
number |
否 |
执行步进伸缩规则时指定的当前阈值,取值范围:-9.999999E18~9.999999E18。 |
1.0 |
| MetricValue |
number |
否 |
执行步进伸缩规则时指定的当前指标值,取值范围:-9.999999E18~9.999999E18。 |
1.0 |
| RegionId |
string |
否 |
伸缩规则所属地域 ID。 |
cn-qingdao |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| ScalingActivityId |
string |
伸缩活动的 id。 |
asa-bp13o672yeautiil**** |
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
示例
正常返回示例
JSON格式
{
"ScalingActivityId": "asa-bp13o672yeautiil****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。