调用SetInstanceHealth设置伸缩组内ECS实例的健康状态。
接口说明
伸缩组会检测并移出处于不健康状态的ECS实例,如果您需要保留指定的ECS实例,请将ECS实例转入备用或者保护状态,更多说明请参见EnterStandby和SetInstancesProtection。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetInstanceHealth | 系统规定参数。取值:SetInstanceHealth |
HealthStatus | String | 是 | Healthy | 设置ECS实例的健康状态,取值范围:
|
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. |
指定的参数非法。 |