触发任务：移出ECS实例
描述
从指定的伸缩组里移出ECS实例。
- 从伸缩组移出弹性伸缩自动创建的ECS实例时，停止和释放该ECS实例。
- 从伸缩组移出用户手工加入的ECS实例时，不停止和释放该ECS实例。
- 当伸缩组为active状态，才可以调用该接口。
- 当伸缩组没有伸缩活动正在执行，才可以调用该接口。
- 当伸缩组没有伸缩活动正在执行时，该接口可以绕过冷却时间（Cooldown）直接执行。
- 调用该接口返回成功，只是表示弹性伸缩服务接受了该接口调用的请求，伸缩活动可以执行，但不代表伸缩活动能够执行成功。用户需要通过返回的ScalingActivityId查看该伸缩活动的执行状态。
- 如果当前伸缩组的实例数（Total Capacity）减去该接口指定的实例数小于MinSize时，则调用失败。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：RemoveInstances。 |
| ScalingGroupId | String | 是 | 伸缩组的ID。 |
| InstanceId.N | String | 是 | ECS实例的ID。最多可以输入20个。 |
返回参数
| 名称 | 类型 | 描述 |
| ScalingActivityId | String | 伸缩活动的ID |
错误码
关于所有接口的通用性错误，请参考 客户端错误表或 服务器端错误表。
| 错误 | 错误代码 | 描述 | HTTP状态码 |
| 指定的伸缩组在该用户账号下不存在 | InvalidScalingGroupId.NotFound | The specified scaling group does not exist. | 404 |
| 指定的ECS实例在伸缩组下不存在 | InvalidInstanceId.NotFound | Instance “XXX” does not exist. | 404 |
| 用户并未向弹性伸缩完整授权Open API接口 | Forbidden.Unauthorized | A required authorization for the specified action is not supplied. | 403 |
| 指定的伸缩组为非active状态 | IncorrectScalingGroupStatus | The current status of the specified scaling group does not support this action. | 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 |
| 指定伸缩规则所属的伸缩组的负载均衡实例为非active状态 | IncorrectLoadBalancerStatus | The current status of the specified load balancer does not support this action. | 400 |
| 指定伸缩规则所属的伸缩组的RDS实例为非running状态 | IncorrectDBInstanceStatus | The current status of DB instance “XXX” does not support this action. | 400 |
| 移出的实例数使得Total Capacity小于MinSize | IncorrectCapacity.MinSize | To remove the instances, the total capacity will be lesser than the MinSize. | 400 |
示例
请求示例
- http://ess.aliyuncs.com/?Action=RemoveInstances
- &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
- &InstanceId.1=i-28wt48iaa
- &<公共请求参数>
返回示例
XML格式：
- <RemoveInstancesResponse>
- <ScalingActivityId>bybj9OcaOT4ucPMbFhcqHfA3</ScalingActivityId>
- <RequestId>DD0309B7-2613-4792-9B86-275906695253</RequestId>
- </RemoveInstancesResponse>
JSON格式：
- "RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE",
- "ScalingActivityId": "ebta5WbUzC8gcwUWvfchyT4U"
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
要从指定的伸缩组中移出ECS实例，需遵循以下步骤和注意事项：
操作前提
- 伸缩组状态：确保目标伸缩组处于
active状态。 - 无正在进行的伸缩活动：确认该伸缩组当前没有执行中的伸缩活动。
请求参数配置
- Action: 必须设置为
RemoveInstances，表示执行移除实例的操作。 - ScalingGroupId: 需提供要操作的伸缩组的ID。
- InstanceId.N: 列出你想要移出的ECS实例ID，最多可一次性指定20个。这里的
.N代表实例ID的序号，例如InstanceId.1,InstanceId.2等。
注意事项
- 实例数与最小实例数限制：在移出实例前，计算移出后伸缩组的总实例数（Total Capacity）是否将小于最小实例数（MinSize）。如果小于，移出操作将失败。
- 操作结果监控：调用接口成功仅表示请求被接受，实际移除操作的结果需要通过返回的
ScalingActivityId来追踪查看。 - 实例状态不变：移出操作不会直接停止或释放ECS实例，但自动创建的实例在移出后，若不再受伸缩组保护，可能会根据伸缩策略被弹性伸缩服务自动处理（如停止、释放）。
- 权限验证：确保调用API的账号对目标伸缩组有完整的操作权限，避免因权限不足导致操作失败。
- 错误处理：关注返回的错误码，如遇到
InvalidScalingGroupId.NotFound、InvalidInstanceId.NotFound等错误，需根据错误提示进行相应调整。
示例请求
http://ess.aliyuncs.com/?Action=RemoveInstances
&ScalingGroupId=your_scaling_group_id
&InstanceId.1=instance_id_1
&InstanceId.2=instance_id_2
请根据实际情况替换your_scaling_group_id、instance_id_1、instance_id_2等占位符内容。
后续操作
- 使用返回的
ScalingActivityId监控移除实例的伸缩活动状态，以确认操作是否成功完成。 - 对于手动加入且希望保留的ECS实例，考虑调整伸缩组的移除策略及最小实例数设置，以防止它们被误移除。
通过以上步骤，您可以有效地管理ECS实例的移出操作，同时确保符合特定的业务需求和资源管理策略。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答