文档

DeleteScalingGroup

更新时间:

如果您不再需要某个伸缩组,可以调用API DeleteScalingGroup删除该伸缩组来空出伸缩组配额,删除伸缩组会同时删除组内的伸缩配置和伸缩规则。

接口说明

删除伸缩组需注意以下信息:

  • 删除伸缩组会删除相关联的伸缩配置、伸缩规则、伸缩活动、伸缩请求的信息。
  • 删除伸缩组不会删除定时任务、云监控报警任务、负载均衡实例以及RDS实例。
  • 如果创建伸缩组时设置了开启伸缩组保护功能,则您不能在控制台或者通过API删除该伸缩组,可以有效避免误删除伸缩组的操作。
  • 创建ECS实例时开启了实例释放保护功能,并加入伸缩组进行托管后,如果您需要删除伸缩组,则手动添加的ECS实例会被强制移出该伸缩组,自动创建的ECS实例也会随该伸缩组一起被自动释放掉。

    说明 删除伸缩组前,为了避免伸缩组中的ECS实例被强制释放,即使您单独为ECS实例开启了实例释放保护功能,仍然需要在伸缩组中设置伸缩组内ECS实例的保护功能,使其在删除伸缩组时不会被强制释放。具体操作,请参见SetInstancesProtection

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String DeleteScalingGroup

系统规定参数。取值:DeleteScalingGroup

ScalingGroupId String asg-bp18p2yfxow2dloq****

伸缩组的ID。

ForceDelete Boolean false

如果伸缩组存在ECS实例/ECI实例或正在进行伸缩活动,是否强制删除伸缩组并移出和释放ECS实例/ECI实例。取值范围:

  • true:强制删除伸缩组。会先停止伸缩组,拒绝接收新的伸缩活动请求,然后等待已有的伸缩活动完成,最后将伸缩组内所有ECS实例/ECI实例移出伸缩组(手动添加的ECS实例/ECI实例会被移出伸缩组,弹性伸缩自动创建的ECS实例/ECI实例会被自动删除)并删除伸缩组。
  • false:不强制删除伸缩组。满足以下两个条件时,会先停止伸缩组,然后再删除伸缩组。
    • 伸缩组没有任何伸缩活动正在执行。
    • 伸缩组当前的ECS实例/ECI实例数量(Total Capacity)为0。

默认值:false。

RegionId String cn-qingdao

伸缩组所属的地域ID。

返回数据

名称

类型

示例值

描述

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DeleteScalingGroup
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ForceDelete=false
&RegionId=cn-qingdao
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteScalingGroupResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DeleteScalingGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

访问错误中心查看更多错误码。

HttpCode

错误码

错误信息

描述

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

指定的伸缩组在该用户账号下不存在。

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

您并未向弹性伸缩完整授权OpenAPI接口。

400

InstanceInUse

You cannot delete a scaling configuration or scaling group while there is an instance associated with it.

指定的伸缩组中存在ECS实例/ECI实例。