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
微信扫一扫
相关推荐
-
创建生命周期挂钩
本文主要介绍生命周期挂钩的定义和创建。 在 中，您已经成功实现弹性扩张或收缩 ECS 资源。但是，这些 ECS 资源只进行了简单的初始配置，面对复杂的业务情况，您可能希望在启用这些 ECS 资源前进行自定义操作，这时就需要使用生命周期挂钩。 什么是生命周期挂钩 如果您为伸缩组创建…
-
DeleteScalingGroup
本文介绍删除伸缩组 API 操作。 描述 删除一个指定的伸缩组。 ForceDelete属性表示如果伸缩组存在ECS实例或正在进行伸缩活动，是否强制删除伸缩组并移出和释放ECS实例。 如果ForceDelete属性为false，必须满足以下两个条件，才能删除伸缩组： 条件一：伸缩…
-
DescribeNotificationTypes
查询弹性伸缩事件及资源变化通知类型（`DescribeNotificationTypes`）。 调试 前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。 请…
-
步骤1. 开通并授权服务
本文主要介绍弹性伸缩的开通及授权服务操作。 操作步骤 登录 。 单击 前往授权 进入 RAM 控制台授权。 勾选 AliyunESSDefaultRole，单击 同意授权。 返回并刷新弹性伸缩控制台。 下一步 授权完成后，弹性伸缩可以为您服务了。下一步，您可以在相应地域，如华东2…
-
数量限制
本文为您介绍弹性伸缩服务涉及的数量限制。 目前，弹性伸缩服务的功能项存在以下数量限制： 同一个账号一个地域下最多创建 50 个伸缩组。 一个伸缩组内最多创建 10 个伸缩配置。 一个伸缩组内最多创建 50 个伸缩规则。 一个伸缩组内最多创建 6 个事件通知。 一个伸缩组内最多创建…
-
CreateLifecycleHook
为一个伸缩组创建生命周期挂钩（CreateLifecycleHook）。 描述 一个伸缩组最多可以创建 6 个生命周期挂钩。创建了生命周期挂钩的伸缩组，在发生伸缩活动时，生命周期挂钩会暂停伸缩活动一段时间，我们称之为伸缩活动等待状态，具体等待时长您可以通过 HeartbeatTi…
