在某些情況下,自動健全狀態檢查可能無法準確發現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 | 設定執行個體的健康狀態,取值範圍:
|
返回資料
名稱 |
類型 |
樣本值 |
描述 |
| 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. |
指定的參數非法。 |