调用EnterStandby将伸缩组内的ECS实例设置为备用状态。

接口说明

  • 如果伸缩组关联了负载均衡实例，会把负载均衡中对应的ECS实例权重设置为0。
  • 当ECS实例处于备用状态时，如果您手动移出伸缩组并释放实例，可以正常移出伸缩组并释放。
  • 对于伸缩组数量变化或监控任务触发的自动缩容的伸缩活动，不会移出处于备用状态的ECS实例。
  • 当ECS实例处于备用状态时，ECS实例如果处于非健康状态（例如停止中、重启中等），ECS实例的健康检查状态不会被更新，并且不会触发移出不健康实例的伸缩活动，只有ECS实例退出备用状态后才会重新更新健康检查状态。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 EnterStandby

系统规定参数。取值：EnterStandby
InstanceId.N RepeatList 是 i-28wt4****

ECS实例的ID。
ScalingGroupId String 是 asg-bp1fo0dbtsbmqa9h****

伸缩组的ID。
ClientToken String 否 123e4567-e89b-12d3-a456-42665544****

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

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ess.aliyuncs.com/?Action=EnterStandby
&ScalingGroupId=asg-bp1fo0dbtsbmqa9h****
&InstanceId.1=i-28wt4****
&<公共请求参数>

正常返回示例

XML 格式 

<EnterStandbyResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</EnterStandbyResponse>

JSON 格式 

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

错误码

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

HttpCode

错误码

错误信息

描述

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

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

404

InvalidInstanceId.NotFound

Instance “XXX” does not exist.

指定的ECS实例不存在。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

指定的伸缩组不存在。