---
title: "updateAutoScalingGroup"
slug: "compute-autoscaling-updateautoscalinggroup"
tags: ["Auto Scaling", "Auto Scaling Group"]
updated: 2026-09-17T09:16:18Z
published: 2026-09-17T09:16:18Z
canonical: "api.ncloud-docs.com/compute-autoscaling-updateautoscalinggroup"
---

> ## 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.

# updateAutoScalingGroup

## 개요

지정된 Auto Scaling Group을 갱신합니다. 지정된 파라미터에 해당하는 속성만 그 값이 변경되고 전달되지 않은 파라미터에 해당하는 속성은 기존 값 그대로 남게 됩니다. 이 액션(Action) 호출에 의해 minSize, desiredCapacity또는 maxSize가 변경되어도 그 대소 관계는 계속 maxSize >= desiredCapacity >= minSize가 유지되어여야 합니다. zoneNoList가 변하면 zone rebalancing이 발생합니다. 이 액션(Action) 호출로 새로운 Launch Configuration이 지정되면, 그 이후 서버 인스턴스가 생성될 때 효과가 나타납니다. Auto Scaling Group이 현재 scaling action이 이루어지고 있는 상태에서 호출하면 오류를 뱉어냅니다.

- minSize는 지정되었으나 desiredCapacity가 지정되어 있지 않을 때, 새로운 minSize 값이 Auto Scaling Group의 현재 사이즈보다 크다면, 암시적으로 setDesiredCapacity가 호출되어서, 그룹 사이즈가 새로운 minSize로 세팅됩니다
- maxSize는 지정되었으나 desiredCapacity가 지정되어 있지 않을 때, 새로운 maxSize 값이 Auto Scaling Group의 현재 사이즈보다 작다면, 암시적으로 setDesiredCapacity가 호출되어서, 그룹 사이즈가 새로운 maxSize로 세팅됩니다
- 요청할 때 전달되지 않은 선택적 파라미터 모두 기존 값으로 남게 됩니다. 아무런 선택적 파라미터가 전달되지 않으면 아무 속성 값이 바뀌지 않습니다. (오류는 나지 않습니다.)

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| autoScalingGroupName | Yes | String | Min : 1, Max : 255 | 조회하고자 하는 오토스케일링 그룹명 입력 |
| launchConfigurationName | No | String | Min : 1, Max : 255 | - 론치설정명 해당 오토스케일링 그룹 소속의 서버 인스턴스가 새로 생성될 때 사용되는 서버 관련 정보 |
| desiredCapacity | No | Integer | Min : 0, Max : 30 | - 기대 서비스 능력 해당 그룹 소속으로 운영될 서버 인스턴스들의 수 설정 이 값이 오토스케일링에 이미 세팅되어 있는 기존 속성인 minSize보다 작아서는 안되고, maxSize보다 커서는 안됨 |
| minSize | No | Integer | Min : 0, Max : 30 | 최소 사이즈 (최소 0이고 maxSize 값보다 작거나 같아야 함) |
| maxSize | No | Integer | Min : 0, Max : 30 | 최대사이즈 |
| defaultCooldown | No | Integer | Min : 0, Max : 2147483647 | 디폴트 cooldown 시간 `default : 300` |
| healthCheckGracePeriod | Conditional | Integer | Min : 0, Max : 2147483647 | - health check 보류 기간 서버 인스턴스가 서비스에 투입된 후 health check를 보류할 시간을 설정 healthCheckTypeCode 값이 LOADB(로드밸런서)의 경우 필수 |
| healthCheckTypeCode | No | String | Min : 1, Max : 5 | Health check 유형 코드 `SVR`(서버) `LOADB`(로드밸런서) |
| zoneNoList | No | String | 중복 불가 | - Zone 번호 리스트 이 그룹 소속 서버 인스턴스들이 존재할 zone 번호 리스트 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [AutoScalingGroupList](/docs/common-apidatatype-autoscalinggrouplist)

## 예시

### 요청 예시

```
{AUTOSCALILNG_API_URL}/updateAutoScalingGroup
?autoScalingGroupName=asg-1
&desiredCapacity=0
&maxSize=0
&minSize=0
```

### 응답 예시

```
<updateAutoScalingGroupResponse>
   <requestId>5e40dcb6-56cc-46cd-ae08-98ec6e611cd9</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <autoScalingGroupList>
      <autoScalingGroup>
         <autoScalingGroupName>asg-1</autoScalingGroupName>
         <autoScalingGroupNo>***517</autoScalingGroupNo>
         <launchConfigurationName>lc-1</launchConfigurationName>
         <launchConfigurationNo>***013</launchConfigurationNo>
         <desiredCapacity>0</desiredCapacity>
         <minSize>0</minSize>
         <maxSize>0</maxSize>
         <loadBalancerInstanceSummeryList>
            <loadBalancerInstanceSummery>
               <loadBalancerName>slb-1</loadBalancerName>
            </loadBalancerInstanceSummery>
            <loadBalancerInstanceSummery>
               <loadBalancerName>slb-2</loadBalancerName>
            </loadBalancerInstanceSummery>
         </loadBalancerInstanceSummeryList>
         <healthCheckGracePeriod>600</healthCheckGracePeriod>
         <healthCheckType>
            <code>SVR</code>
            <codeName>Server</codeName>
         </healthCheckType>
         <createDate>2014-02-13T17:24:19+0900</createDate>
         <inAutoScalingGroupServerInstanceList>
            <InAutoScalingGroupServerInstance>
               <healthStatus>
                  <code>HLTHY</code>
                  <codeName>Healthy (normal)</codeName>
               </healthStatus>
               <lifecycleState>
                  <code>INSVC</code>
                  <codeName>In service</codeName>
               </lifecycleState>
               <launchConfiguration>
                  <launchConfigurationName>lc-1</launchConfigurationName>
                  <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
                  <serverProductCode>SPSVRSTAND000043</serverProductCode>
                  <memberServerImageNo />
                  <loginKeyName>yh-nang-test</loginKeyName>
                  <createDate>2014-02-13T13:45:57+0900</createDate>
                  <userData />
               </launchConfiguration>
               <serverInstanceNo>68084</serverInstanceNo>
               <serverInstanceName>svr-7f8879ae0826836</serverInstanceName>
            </InAutoScalingGroupServerInstance>
         </inAutoScalingGroupServerInstanceList>
         <suspendedProcessList />
         <zoneList>
            <zone>
               <zoneNo>2</zoneNo>
               <zoneName>KR-1</zoneName>
               <zoneCode>KR-1</zoneCode>
               <zoneDescription>가산 zone</zoneDescription>
            </zone>
         </zoneList>
      </autoScalingGroup>
   </autoScalingGroupList>
</updateAutoScalingGroupResponse>
```

## 오류 코드

아래 오류 코드는 이 액션(Action)에서 특징적으로 발생하는 오류입니다. 공통적으로 발생하는 오류에 대한 상세한 설명은 [NAVER Cloud Platform API](/docs/common-ncpapi)를 참고해주세요

| HTTP Response Code | 리턴 코드 | 리턴 메시지 |
| --- | --- | --- |
| 400 | 50120 | An invalid or out-of-range value was supplied for the input parameter. |
| 400 | 50130 | The quota for capacity groups or launch configurations for this customer has already been reached. |
| 400 | 50160 | You cannot delete an Auto Scaling group while there are scaling activities in progress for that group. |