DetachInstances

从一个伸缩组分离一台或多台 ECS 实例。

描述

分离 ECS 实例之后,ECS 实例可以独立于伸缩组存在,您可以将 ECS 实例附加到其他伸缩组(AttachInstances)。分离一台 ECS 实例并不会停止或释放该 ECS 实例,若有相关需要,您可以手动 停止 或 释放 ECS 实例。

说明

  • 目标伸缩组必须处于 启用Enable) 状态。
  • 目标伸缩组不能有正在进行的伸缩活动。
  • 目标伸缩组没有正在进行的伸缩活动时,该接口可以绕过 冷却时间 直接执行。
  • 接口成功调用后,仅表示接受了该接口调用的请求。可以照常触发伸缩活动,但不能保证伸缩活动的成功性,您需要通过返回的 ScalingActivityId 查看伸缩活动的状态。
  • 目标伸缩组的 ECS 数减去当前分离的 ECS 数不能小于伸缩组最小实例数(MinSize)。

请求参数

名称 类型 是否必选 描述
Action String 系统规定参数,取值: DetachInstances。
ScalingGroupId String 伸缩组 ID。
InstanceId.N String ECS 实例 ID。N 的取值范围为 [1, 20]。

返回参数

名称 类型 描述
RequestId String 请求 ID。
ScalingActivityId String 伸缩活动 ID。

示例

请求示例

http://ess.aliyuncs.com/?Action=DetachInstances
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJXXXXX
&InstanceId.1=i-28wt48iaa
&<公共请求参数>

正常返回示例

XML 格式

<DetachInstancesResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <ScalingActivityId>asa-xxxxxxxxx</ScalingActivityId>
</DetachInstancesResponse>

JSON 格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "ScalingActivityId": "asa-xxxxxxxxx"
}

错误码

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 实例不存在。

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1592.html

发表评论

邮箱地址不会被公开。 必填项已用*标注