ExitStandby
伸缩组内发生伸缩活动时,不会移出处于备用状态的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 | 是否采用异步任务方式执行。取值范围:
默认值: 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. |
指定的伸缩组在该用户账号下不存在。 |