SetInstanceHealth
在某些情況下,自動(dòng)健康檢查可能無法準(zhǔn)確發(fā)現(xiàn)ECS實(shí)例或ECI實(shí)例的健康狀態(tài),通過手動(dòng)設(shè)置實(shí)例的健康狀態(tài)可以對(duì)故障實(shí)例進(jìn)行快速識(shí)別和處理。此時(shí),您可以調(diào)用API SetInstanceHealth設(shè)置伸縮組內(nèi)ECS實(shí)例或ECI實(shí)例的健康狀態(tài),能夠更好地應(yīng)對(duì)實(shí)際的業(yè)務(wù)需求和運(yùn)維情況。
接口說明
伸縮組會(huì)檢測(cè)并移出處于不健康狀態(tài)的ECS實(shí)例或ECI實(shí)例,如果您需要保留指定的ECS實(shí)例或ECI實(shí)例,請(qǐng)將ECS實(shí)例或ECI實(shí)例轉(zhuǎn)入備用或者保護(hù)狀態(tài),更多說明請(qǐng)參見EnterStandby和SetInstancesProtection。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | SetInstanceHealth | 系統(tǒng)規(guī)定參數(shù)。取值:SetInstanceHealth。 |
InstanceId | String | 是 | i-bp1ap6bro51a7fsa**** | 伸縮組內(nèi)實(shí)例的ID。 |
HealthStatus | String | 是 | Healthy | 設(shè)置實(shí)例的健康狀態(tài),取值范圍:
|
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | B755AE57-6093-43E4-938E-DEA422A9**** | 請(qǐng)求ID。 |
示例
請(qǐng)求示例
http(s)://ess.aliyuncs.com/?Action=SetInstanceHealth
&InstanceId=i-bp1ap6bro51a7fsa****
&HealthStatus=Healthy
&公共請(qǐng)求參數(shù)
正常返回示例
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****"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
400 |
InvalidInstanceId.NotFound |
Instance "%s" does not exist. |
伸縮組內(nèi)不存在指定的實(shí)例。 |
400 |
InvalidParameter |
The specified value of parameter "%s" is not valid. |
指定的參數(shù)非法。 |