SetInstanceHealth - 弹性伸缩

在某些情况下，自动健康检查可能无法准确发现ECS实例或ECI实例的健康状态，通过手动设置实例的健康状态可以对故障实例进行快速识别和处理。此时，您可以调用API SetInstanceHealth设置伸缩组内ECS实例或ECI实例的健康状态，能够更好地应对实际的业务需求和运维情况。

接口说明

伸缩组会检测并移出处于不健康状态的ECS实例或ECI实例，如果您需要保留指定的ECS实例或ECI实例，请将ECS实例或ECI实例转入备用或者保护状态，更多说明请参见EnterStandby和SetInstancesProtection。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	SetInstanceHealth	系统规定参数。取值：SetInstanceHealth。
InstanceId	String	是	i-bp1ap6bro51a7fsa****	伸缩组内实例的ID。
HealthStatus	String	是	Healthy	设置实例的健康状态，取值范围： Healthy：设置为健康状态。 Unhealthy：设置为不健康状态。

返回数据

名称	类型	示例值	描述
RequestId	String	B755AE57-6093-43E4-938E-DEA422A9****	请求ID。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=SetInstanceHealth
&InstanceId=i-bp1ap6bro51a7fsa****
&HealthStatus=Healthy
&公共请求参数

正常返回示例

XML格式

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

<SetInstanceHealthResponse>
    <RequestId>B755AE57-6093-43E4-938E-DEA422A9****</RequestId>
</SetInstanceHealthResponse>

JSON格式

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

{
  "RequestId" : "B755AE57-6093-43E4-938E-DEA422A9****"
}

错误码

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

HttpCode	错误码	错误信息	描述
400	InvalidInstanceId.NotFound	Instance "%s" does not exist.	伸缩组内不存在指定的实例。
400	InvalidParameter	The specified value of parameter "%s" is not valid.	指定的参数非法。