DetachInstances
从一个伸缩组分离一台或多台 ECS 实例。
描述
分离 ECS 实例之后，ECS 实例可以独立于伸缩组存在，您可以将 ECS 实例附加到其他伸缩组（）。分离一台 ECS 实例并不会停止或释放该 ECS 实例，若有相关需要，您可以手动 或 ECS 实例。
- 目标伸缩组必须处于 启用（
Enable） 状态。 - 目标伸缩组不能有正在进行的伸缩活动。
- 目标伸缩组没有正在进行的伸缩活动时，该接口可以绕过 直接执行。
- 接口成功调用后，仅表示接受了该接口调用的请求。可以照常触发伸缩活动，但不能保证伸缩活动的成功性，您需要通过返回的
ScalingActivityId查看伸缩活动的状态。 - 目标伸缩组的 ECS 数减去当前分离的 ECS 数不能小于伸缩组最小实例数（
MinSize）。
调试
前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| InstanceId.N | RepeatList | 是 | i-28wt4**** |
ECS 实例 ID。N 的取值范围为 1~20。 |
| ScalingGroupId | String | 是 | AG6CQdPU8OKdwLjgZcJ**** |
伸缩组 ID。 |
| Action | String | 否 | DetachInstances |
系统规定参数，取值： DetachInstances。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。无论调用接口成功与否，我们都会返回请求 ID。 |
| ScalingActivityId | String | asa-**** |
伸缩活动 ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=DetachInstances
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ****
&InstanceId.1=i-28wt4****
&<公共请求参数>
正常返回示例
XML 格式
<DetachInstancesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<ScalingActivityId>asa-xxxxxxxxx</ScalingActivityId>
</DetachInstancesResponse>
JSON 格式
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"ScalingActivityId":"asa-****"
}错误码
HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
|
400 |
IncorrectScalingGroupStatus |
The current status of the specified scaling group does not support this action. |
目标伸缩组必须处于 启用（Enable） 状态。 |
|
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. |
目标伸缩组的 ECS 实例数减去当前分离的 ECS 实例数不能小于伸缩组最少实例数（MinSize）。 |
|
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
您暂未被授权使用 DetachInstances 接口。 |
|
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
指定的伸缩组不存在。 |
|
404 |
InvalidInstanceId.NotFound |
Instance “XXX” does not exist. |
指定的 ECS 实例不存在。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4556.html
微信扫一扫
相关推荐
-
注意事项
本文主要介绍弹性伸缩相关注意事项。 伸缩规则 在计算和执行过程中，伸缩规则可以根据伸缩组的 MinSize、MaxSize 进行自动调整其需要增加或减少的 ECS 实例数（例如：伸缩规则中指定将伸缩组的 ECS 实例数调整至 50 台，但伸缩组 MaxSize 只有 45 台，则…
-
实例移出保护状态
本文介绍如何将ECS实例移出保护状态。 操作步骤 登录。 在顶部状态栏处，选择地域。 找到实例所在伸缩组，在操作列中，单击管理。 在左侧导航栏中，单击ECS实例列表。 找到待操作的实例，在操作列中，单击移出保护状态。 单击确定。 赞微海报分享
-
查看伸缩活动
弹性伸缩提供了查看伸缩活动功能，帮助您了解通过定时任务、报警任务等途径执行伸缩活动的结果。本文介绍查看伸缩活动的步骤。 操作步骤 登录。 在伸缩组管理列表页面中，单击待查看伸缩组操作列下的管理。 单击左侧导航栏中伸缩活动。 说明 您最多可查看30天之内的伸缩活动信息。 单击指定伸…
-
弹性伸缩FAQ
如何避免因某个实例规格库存不足导致扩容失败？ 建议在创建伸缩组的时候设置多可用区（可用区下选择不同的Vswitch），创建伸缩配置的时候选择多实例规格，当某个ECS实例规格在某个可用区没有库存时，弹性伸缩服务会自动切换到有库存的实例规格及可用区进行扩容。更多说明请参考或。 报警任…
-
伸缩活动的流程
本文主要介绍弹性伸缩的伸缩活动流程。 伸缩活动的生命周期为判断伸缩组的健康状态和边界条件步骤与启动 cooldown 步骤之间的所有活动。 伸缩组自动伸缩 自动扩展 判断伸缩组的健康状态和边界条件。 分配 ActivityId 和执行伸缩活动。 创建 ECS 实例。 修改 Tot…
-
冷却时间
本文主要介绍弹性伸缩的冷却时间。 冷却时间指成功执行伸缩活动后的一段锁定时间。您可以通过以下两种方式配置冷却时间： 在伸缩组中配置默认冷却时间，默认冷却时间不能为空，请参照 创建伸缩组。 在伸缩规则中配置冷却时间，如果不配置，将使用默认冷却时间，请参照 创建伸缩规则。 说明 如果…
