RemoveInstances
从指定的伸缩组里移出 ECS 实例。
描述
- 从伸缩组移出弹性伸缩自动创建的 ECS 实例时，ECS 实例进入停机不收费状态或者被释放。
- 从伸缩组移出用户手工加入的 ECS 实例时，不停止和释放该 ECS 实例。
- 当伸缩组为 Active 状态，才可以调用该接口。
- 当伸缩组没有伸缩活动正在执行，才可以调用该接口。
- 当伸缩组没有伸缩活动正在执行时，该接口可以绕过冷却时间（Cooldown）直接执行。
- 调用该接口返回成功，只是表示弹性伸缩服务接受了该接口调用的请求，伸缩活动可以执行，但不代表伸缩活动能够执行成功。用户需要通过返回的 ScalingActivityId 查看该伸缩活动的执行状态。
- 如果当前伸缩组的实例数（Total Capacity）减去该接口指定的实例数小于 MinSize 时，则调用失败。
调试
前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| InstanceId.N | RepeatList | 是 | i-28wt4**** |
ECS 实例的 ID。最多可以输入 20 个。 |
| ScalingGroupId | String | 是 | AG6CQdPU8OKdwLjgZcJ**** |
伸缩组的 ID。 |
| Action | String | 否 | RemoveInstances |
操作接口名，系统规定参数，取值：RemoveInstances。 |
| RemovePolicy | String | 否 | release |
指定被移出实例的动作，可选值：
默认值：release |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。无论调用接口成功与否，我们都会返回请求 ID。 |
| ScalingActivityId | String | bybj9OcaOT4ucPMbFhcq**** |
伸缩活动的 ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=RemoveInstances
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ****
&InstanceId.1=i-28wt4****
&<公共请求参数>
正常返回示例
XML 格式
<RemoveInstancesResponse>
<ScalingActivityId>bybj9OcaOT4ucPMbFhcqHfA3</ScalingActivityId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</RemoveInstancesResponse>
JSON 格式
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}错误码
HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
|
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
指定的伸缩组在该用户账号下不存在。 |
|
404 |
InvalidInstanceId.NotFound |
Instance “XXX” does not exist. |
指定的ECS实例在伸缩组下不存在。 |
|
400 |
InvalidParameter |
The specified group does not support the specified RemovePolicy. |
当前伸缩组不支持停机回收策略。 |
|
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
您未向弹性伸缩授予完整的Open API接口权限。 |
|
400 |
IncorrectScalingGroupStatus |
The current status of the specified scaling group does not support this action. |
指定的伸缩组为非active状态。 |
|
400 |
ScalingActivityInProgress |
You cannot delete a scaling group or launch a new scaling activity while there is a scaling activity in progress for the specified scaling group. |
指定的伸缩组有进行中的伸缩活动。 |
|
400 |
IncorrectLoadBalancerStatus |
The current status of the specified load balancer does not support this action. |
指定伸缩规则所属的伸缩组的负载均衡实例为非active状态。 |
|
400 |
IncorrectDBInstanceStatus |
The current status of DB instance “XXX” does not support this action. |
指定伸缩规则所属的伸缩组的RDS实例为非running状态。 |
|
400 |
IncorrectCapacity.MinSize |
To remove the instances, the total capacity will be lesser than the MinSize. |
移出的实例数使得Total Capacity小于MinSize。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4557.html
微信扫一扫
相关推荐
-
在弹性伸缩中使用负载均衡服务
伸缩组支持关联负载均衡实例，通过负载均衡实例将访问流量分发到伸缩组内的多个ECS实例，有效增强伸缩组的服务能力。 负载均衡服务简介 负载均衡服务通过设置虚拟服务地址，将添加的同一地域的多个ECS实例虚拟成一个高性能、高可用的应用服务池。简单来说，负载均衡服务通过组合负载均衡实例 …
-
阿里云弹性伸缩API使用须知
在调用弹性伸缩 OpenAPI 之前，需要在阿里云官网先开通弹性伸缩服务，并在弹性伸缩控制台将用户的 OpenAPI 权限授权予弹性伸缩。 具体操作请参见 。 前提条件 在调用弹性伸缩 OpenAPI 之前，需要在阿里云官网先开通弹性伸缩服务，并在弹性伸缩控制台将用户的 Open…
-
让ESS更灵活的新特性
弹性伸缩（Elastic Scaling Service, ESS）是一种根据业务需求和策略，自动调整其弹性计算资源的管理服务。在满足业务需求高峰增长时无缝地增加 ECS 实例，并在业务需求下降时自动减少ECS实例以节约成本。 为了提供更加弹性、灵活的伸缩服务，ESS弹性伸缩配置…
-
AttachInstances
往指定的伸缩组添加ECS实例。 描述 加入的ECS实例的限定条件包括： 加入的ECS实例必须与伸缩组在同一个地域。 加入的ECS实例必须是running状态。 加入的ECS实例不能已加入到其它伸缩组中。 加入的ECS实例支持包年包月和按量付费两种类型。 如果伸缩组指定Vswitc…
-
设置实例备用状态
本文介绍如何设置实例备用状态。 弹性伸缩支持设置ECS实例备用状态（Standby）。我们不会检查处于备用状态的ECS实例健康状态，也不会释放ECS实例。 功能特性 设置ECS实例备用状态后： ECS实例保持备用状态直至您使其退出备用状态。 弹性伸缩不会管理ECS实例的生命周期，…
-
DeleteScalingConfiguration
删除一个指定的伸缩配置。 描述 伸缩配置在伸缩组中属于生效状态，则该伸缩配置不允许删除。 某个伸缩配置创建的任意一个ECS实例仍存在于伸缩组中，则该伸缩配置不允许删除。 调试 前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码…
