调用SetInstanceHealth设置伸缩组内ECS实例的健康状态。

接口说明

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

调试

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

请求参数

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

系统规定参数。取值:SetInstanceHealth

HealthStatus String Healthy

设置ECS实例的健康状态,取值范围:

  • Healthy:设置为健康状态。
  • Unhealthy:设置为不健康状态。
InstanceId String i-bp1ap6bro51a7fsa****

伸缩组内ECS实例的ID。

返回数据

名称 类型 示例值 描述
RequestId String B755AE57-6093-43E4-938E-DEA422A9B10F

请求ID。

示例

请求示例

https://ess.aliyuncs.com/?Action=SetInstanceHealth
&HealthStatus=Unhealthy
&InstanceId=i-bp1ap6bro51a7fsa****
&<公共请求参数>

正常返回示例

XML 格式

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

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.

指定的参数非法。