---
title: "setServerInstanceHealth"
slug: "compute-autoscaling-setserverinstancehealth"
updated: 2026-09-17T10:05:57Z
published: 2026-09-17T10:05:57Z
canonical: "api.ncloud-docs.com/compute-autoscaling-setserverinstancehealth"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# setServerInstanceHealth

## Overview

Set the health status of a server instance under an Auto Scaling Group owned by the user.

## Request

### Request parameters

| Parameter name | Required | Type | Restrictions | Description |
| --- | --- | --- | --- | --- |
| serverInstanceNo | Yes | String | - | - Identification number of the server instance Invalid if the server instance is not part of the member's auto scaling group |
| healthStatusCode | Yes | String | Min: 1 Max: 5 | - Valid values for health status code `HLTHY(HEALTHY)` and `UNHTH(UNHEALTHY)` It is only possible after a server instance is created and put into service. |
| shouldRespectGracePeriod | No | Boolean | - | - Compliance with healthCheckGracePeriod (health check grace period) `true` `false` If the healthCheckGracePeriod period has not passed since the server instance was created and put into service, the attempt to change the status to unhealthy will not be applied. `default : true` |
| responseFormatType | No | String |  | - Format type of the response result Options: xml \| json Default: xml |

## Response

### Response body

- [CommonResponse](/docs/en/common-apidatatype-commonresponse)

## Examples

### Request example

```
{AUTOSCALILNG_API_URL}/setServerInstanceHealth
?healthStatusCode=UNHTH
&serverInstanceNo=68128
```

### Response example

```
<setServerInstanceHealthResponse>
   <requestId>2785401a-14e4-42b2-9e65-0f59b29424d4</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
</setServerInstanceHealthResponse>
```

​