调用EnterStandby将伸缩组内的ECS实例设置为备用状态。
接口说明 如果伸缩组设置了负载均衡,会把负载均衡对应的实例权重设置为0。
当实例处于备用状态的时候,如果您自行移出伸缩组并释放实例,可以正常移出伸缩组并释放。 对于伸缩组数量变化或监控任务触发的自动缩容的伸缩活动,不会移除处于备用状态的实例。 当实例处于备用状态的时候,实例如果处于非健康状态(停止、重启等),实例的健康检查状态不会被更新,并且不会触发移除不健康实例的伸缩活动,只有实例退出备用状态才会重新更新健康检查状态。 调试 您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试 请求参数 名称 类型 是否必选 示例值 描述 InstanceId.N RepeatList 是 i-28wt4**** ECS实例的ID。
ScalingGroupId String 是 AG6CQdPU8OKdwLjgZcJ**** 伸缩组的ID。
Action String 否 EnterStandby 系统规定参数,取值:EnterStandby。
返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
示例 请求示例
http://ess.aliyuncs.com/?Action=EnterStandby &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ**** &InstanceId.1=i-28wt4**** &<公共请求参数> 正常返回示例
XML 格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 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.
指定的伸缩组不存在。调用ExitStandby使伸缩组内处于备用状态的ECS实例进入运行状态。
接口说明 如果伸缩组设置了负载均衡服务,会将ECS实例权重设置为伸缩配置中定义的权重值。
调试 您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试 请求参数 名称 类型 是否必选 示例值 描述 InstanceId.N RepeatList 是 i-28wt4**** ECS实例的ID。取值可以由多个实例ID组成一个JSON数组,最多支持20个ID,ID之间用半角逗号(,)隔开。
ScalingGroupId String 是 AG6CQdPU8OKdwLjgZcJ**** 伸缩组的ID。
Action String 否 ExitStandby 系统规定参数,取值:ExitStandby。
返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
示例 请求示例
http://ess.aliyuncs.com/?Action=ExitStandby &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ**** &InstanceId.1=i-28wt4**** &<公共请求参数> 正常返回示例
XML 格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 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
A required authorization for the specified action is not supplied.
指定的ECS实例不存在。
404
InvalidScalingGroupId.NotFound
The specified scaling group does not exist.
指定的伸缩组在该用户账号下不存在。调用RebalanceInstances重新平衡多可用区伸缩组内ECS实例的分布。
接口说明 分布再平衡会通过新建ECS实例替换已有ECS实例补偿平衡可用区,终止已有ECS实例前会先启动新ECS实例,分布再平衡不会影响您的应用程序性能或可用性。
只支持设置了MultiAZPolicy为BALANCE的多可用区伸缩组,用于平衡多可用区间ECS实例的分布。 只有伸缩组内实例分布严重不平衡时可以执行再平衡操作。 一次分布再平衡活动最多只替换20台ECS实例。 分布再平衡活动期间,如果组内实例数量接近或达到指定的最大ECS实例台数(MaxSize),但需要继续分布再平衡,弹性伸缩允许暂时超出MaxSize的10%,最低允许超出1台ECS实例。该超出状态持续重新平衡该伸缩组所需的时间,通常为1至6分钟。 调试 您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试 请求参数 名称 类型 是否必选 示例值 描述 ScalingGroupId String 是 AG6CQdPU8OKdwLjgZcJ**** 伸缩组的ID。
Action String 否 RebalanceInstances 系统规定参数,取值: RebalanceInstances。
返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
ScalingActivityId String asa-kjgffgdfadah**** 伸缩活动的ID。
示例 请求示例
http://ess.aliyuncs.com/?Action=RebalanceInstances &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ**** &<公共请求参数> 正常返回示例
XML 格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E asa-kjgffgdfadah**** JSON 格式
{ "RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E", "ScalingActivityId":"asa-kjgffgdfadah****" } 错误码 访问错误中心查看更多错误码。
HttpCode
错误码
错误信息
描述
400
IncorrectScalingGroupStatus
The current status of the specified scaling group does not support this action.
您需要启用伸缩组。
400
OperationDenied
This operation is denied because the specified scaling group does not support this action.
指定伸缩组的扩缩容策略MultiAZPolicy不是BALANCE,或者ECS实例分布不存在严重不平衡的情况。
403
Forbidden.Unauthorized
A required authorization for the specified action is not supplied.
您还未被授权使用RebalanceInstances接口。
404
InvalidScalingGroupId.NotFound
The specified scaling group does not exist.
指定的伸缩组在该用户账号下不存在。调用SetInstanceHealth设置伸缩组内ECS实例的健康状态。
接口说明 伸缩组会检测并移出处于不健康状态的ECS实例,如果您需要保留指定的ECS实例,请将ECS实例转入备用或者保护状态,更多说明请参见EnterStandby和SetInstancesProtection。
调试 您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试 请求参数 名称 类型 是否必选 示例值 描述 HealthStatus String 是 Healthy 设置ECS实例的健康状态,取值范围:
Healthy:设置为健康状态。 Unhealthy:设置为不健康状态。 InstanceId String 是 i-bp1ap6bro51a7fsa**** 伸缩组内ECS实例的ID。
Action String 否 SetInstanceHealth 系统规定参数。取值:SetInstanceHealth。
返回数据 名称 类型 示例值 描述 RequestId String B755AE57-6093-43E4-938E-DEA422A9B10F 请求ID。
示例 请求示例
http(s)://ess.aliyuncs.com/?Action=SetInstanceHealth &HealthStatus=Unhealthy &InstanceId=i-bp1ap6bro51a7fsa**** &<公共请求参数> 正常返回示例
XML 格式
B755AE57-6093-43E4-938E-DEA422A9B10F JSON 格式
{ "RequestId":"B755AE57-6093-43E4-938E-DEA422A9B10F" } 错误码 访问错误中心查看更多错误码。
HttpCode
错误码
错误信息
描述
400
InvalidInstanceId.NotFound
Instance "%s" does not exist.
伸缩组内不存在指定的实例。
400
InvalidParameter
The specified value of parameter "%s" is not valid.
指定的参数非法。调用SetInstancesProtection保护或者停止保护伸缩组内的一台或者多台ECS实例。
接口说明 ECS实例开启保护状态后:
实例保持此状态,直至您停止保护状态。 即使伸缩组内实例数量的变化和监控任务触发自动缩容的伸缩活动,也不会移除处于保护状态的ECS实例。您需要自行移出ECS实例后才能释放ECS实例。 ECS实例被停止或者重启时,不会更新ECS实例的健康检查状态。 调试 您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试 请求参数 名称 类型 是否必选 示例值 描述 InstanceId.N RepeatList 是 i-28wt4**** ECS实例的ID,N的取值范围为:1~20。
ProtectedFromScaleIn Boolean 是 true 伸缩组自动缩容时是否保护ECS实例,使其不被终止或移出伸缩组,取值范围:
true false ScalingGroupId String 是 AG6CQdPU8OKdwLjgZcJ**** 伸缩组的ID。
Action String 否 SetInstancesProtection 系统规定参数,取值:SetInstancesProtection。
返回数据 名称 类型 示例值 描述 RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
示例 请求示例
http://ess.aliyuncs.com/?Action=SetInstancesProtection &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ**** &InstanceId.1=i-28wt4**** &InstanceId.2=i-28wt4**** &ProtectedFromScaleIn=true &<公共请求参数> 正常返回示例
XML 格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E JSON 格式
{ "RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E" } 错误码 访问错误中心查看更多错误码。
HttpCode
错误码
错误信息
描述
400
IncorrectScalingGroupStatus
The current status of the specified scaling group does not support this action.
您需要启用伸缩组。
403
Forbidden.Unauthorized
A required authorization for the specified action is not supplied.
您还未被授权使用SetInstancesProtection接口。
404
InvalidInstanceId.NotFound
Instance “XXX” does not exist.
指定的ECS实例不存在。
404
InvalidScalingGroupId.NotFound
The specified scaling group does not exist.
指定的伸缩组不存在。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。