---
title: "setServerInstanceHealth  "
slug: "compute-autoscaling-setserverinstancehealth"
tags: ["Auto Scaling"]
updated: 2026-10-22T10:47:10Z
published: 2026-10-22T10:47:10Z
canonical: "api-gov.ncloud-docs.com/compute-autoscaling-setserverinstancehealth"
---

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

# setServerInstanceHealth

## 개요

사용자가 보유하는 Auto Scaling Group 소속의 서버 인스턴스의 헬스 상태를 설정

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| serverInstanceNo | Yes | String | - | - 서버 인스턴스의 식별 번호 회원의 Auto Scaling 그룹 소속 서버 인스턴스가 아니면 유효하지 않음 |
| healthStatusCode | Yes | String | Min : 1 Max : 5 | - 헬스 상태 코드로 유효 값 `HLTHY(HEALTHY)`와 `UNHTH(UNHEALTHY)`가 있음 서버 인스턴스가 생성되고 나서 서비스에 투입된 이후에만 가능 |
| shouldRespectGracePeriod | No | Boolean | - | - healthCheckGracePeriod(헬스체크보류기간) 준수 여부 `true` `false` 서버 인스턴스가 생성되고 나서 서비스에 투입된 시각에서 healthCheckGracePeriod 기간이 지나지 않으면 unhealthy 상태로 변경하려 해도 적용되지 않음 `default : true` |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

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

## 예시

### 요청 예시

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

### 응답 예시

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

​