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
微信扫一扫
相关推荐
-
ModifyScalingRule
调用ModifyScalingRule修改一条已有的伸缩规则，重新定义伸缩动作。 描述 修改一条已有伸缩规则的指定属性，应对新的场景。 调试 前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使…
-
DetachLoadBalancers
移除一个或多个负载均衡实例。 调试 前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。 请求参数 名称 类型 是否必选 示例值 描述 LoadBalance…
-
自动将伸缩组ECS实例添加到Redis实例白名单
本文介绍如何使用弹性伸缩、消息服务和函数计算，将弹性扩张时创建的ECS实例自动添加到Redis实例的白名单。您可以作为参考，实现更多自动化操作。 背景信息 目前，弹性伸缩已经接入负载均衡、云数据库RDS等产品，但是暂未接入云数据库Redis。如果您将业务数据存储在Redis实例上…
-
DescribeScalingGroups
本文主要介绍查询伸缩组API操作。 描述 查询伸缩组的信息。伸缩组具有以下几种状态（LifecycleState）： Active：生效状态，在该状态下才能接收执行伸缩规则的请求并触发伸缩活动。 Inacitve：失效状态，在该状态下不接收任何执行伸缩规则的请求。 Deletin…
-
修改伸缩配置
如果业务需求发生变更，您可以修改现有伸缩配置的部分项，无须重新创建一个伸缩配置，提高运维效率。 背景信息 如果您想深入了解各配置项的含义，请参阅使用向导创建实例。 操作步骤 登录弹性伸缩控制台。 单击伸缩组操作列下的管理。 前往组内实例配置信息来源页面。 单击待修改伸缩配置操作列…
-
实例自定义数据
为了提供更加高效灵活的伸缩服务，弹性伸缩配置中新增了实例自定义数据（UserData）。您可以利用 UserData 自动完成 ECS 实例配置，从而安全快速地实现应用级别的扩容和缩容。 本文将详细介绍 UserData，并结合具体场景向您展示 UserData 的使用方式。您可…
