全部产品
Search
文档中心

弹性伸缩:ExitStandby

更新时间:May 21, 2024

伸缩组内发生伸缩活动时,不会移出处于备用状态的ECS实例或ECI实例。如果您需要再次使用该实例参与伸缩活动,您可以调用API ExitStandby将伸缩组中处于备用状态的ECS实例或ECI实例移出备用状态并转化为运行状态。

接口说明

伸缩组中的实例移出备用状态后,您需要注意以下事项:

  • ECS实例或ECI实例会转为运行状态(即恢复服务状态)。
  • 如果ECS实例或ECI实例所在伸缩组关联了负载均衡实例,则该ECS实例或ECI实例再次加入负载均衡实例时,权重默认为50。
  • 如果ECS实例或ECI实例被停止或者重启时,则该ECS实例或ECI实例会重新更新健康检查状态。
  • 当伸缩组发生收缩的伸缩活动时,弹性伸缩可以从伸缩组移出该ECS实例或ECI实例。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String ExitStandby

系统规定参数。取值:ExitStandby

ScalingGroupId String asg-bp1fo0dbtsbmqa9h****

伸缩组的ID。

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

保证请求幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

InstanceId.N String i-28wt4****

ECS实例的ID。取值可以由多个实例ID组成一个JSON数组,最多支持20个ID,ID之间用半角逗号(,)隔开。

Async Boolean false

是否采用异步任务方式执行。取值范围:

  • true:异步任务执行。
  • false:同步任务执行。

默认值: false。

RegionId String cn-hangzhou

伸缩组所属的地域ID。

返回数据

名称

类型

示例值

描述

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

请求ID。

ScalingActivityId String asa-2zeb04oym05qaceq****

伸缩活动ID。

示例

请求示例

http(s)://ess.aliyuncs.com]/?Action=ExitStandby
&ScalingGroupId=asg-bp1fo0dbtsbmqa9h****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&InstanceId=["i-28wt4****"]
&Async=false
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<ExitStandbyResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <ScalingActivityId>asa-2zeb04oym05qaceq****</ScalingActivityId>
</ExitStandbyResponse>

JSON格式

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

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

错误码

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

HttpCode

错误码

错误信息

描述

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

RAM用户无权限调用该接口,请联系主账号授权后重试。

404

InvalidInstanceId.NotFound

A required authorization for the specified action is not supplied.

指定的ECS实例或ECI实例不存在。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

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