全部产品
Search
文档中心

弹性伸缩:DetachAlbServerGroups

更新时间:Jun 25, 2024

调用DetachAlbServerGroups,并可以指定伸缩组的ID、ALB 服务器组的ID、ALB 服务器组中 ECS 实例使用的端口号等参数,实现从伸缩组中移出一个或多个ALB服务器组。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DetachAlbServerGroups

系统规定参数。取值:DetachAlbServerGroups

RegionId String cn-hangzhou

伸缩组所属的地域ID,如cn-hangzhou、cn-shanghai。更多信息,请参见地域和可用区

ScalingGroupId String asg-bp18p2yfxow2dloq****

伸缩组的ID。

ClientToken String 123e4567-e89b-12d3-a456-42665544****

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。

只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

ForceDetach Boolean false

是否从待移出ALB服务器组中移出已有的ECS实例。

  • true:移出,并返回ScalingActivityId,您可以通过查看该伸缩活动ID来确定已有实例是否移出成功。
  • false:不移出。

默认值:false。

AlbServerGroup.N.AlbServerGroupId String sgp-ddwb0y0g6y9bjm****

ALB服务器组的ID。N为ALB服务器组的编号。

AlbServerGroup.N.Port Integer 22

ALB服务器组中ECS实例使用的端口号。N为ALB服务器组的编号。

返回数据

名称

类型

示例值

描述

ScalingActivityId String asa-2ze6wxj8vsohn6j9****

移出ALB服务器组,并移出该ALB服务器组内的ECS实例时,对应伸缩活动的ID。仅当ForceDetach取值为true时,返回该参数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DetachAlbServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceDetach=false
&AlbServerGroup=[{"AlbServerGroupId":"sgp-ddwb0y0g6y9bjm****","Port":22}]
&公共请求参数

正常返回示例

XML格式

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

<DetachAlbServerGroupsResponse>
    <ScalingActivityId>asa-2ze6wxj8vsohn6j9****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachAlbServerGroupsResponse>

JSON格式

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

{
  "ScalingActivityId" : "asa-2ze6wxj8vsohn6j9****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

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

HttpCode

错误码

错误信息

描述

400

AlbServerGroup.NotAttached

The ALB server groups are not attached to specific ScalingGroup.

当前ALB服务器组未添加到伸缩组中。