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

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

# setDesiredCapacity

## 개요

지정된 Auto Scaling Group에 대한 desired capacity 설정

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| autoScalingGroupName | Yes | String | Min : 1 Max : 255 | 조회하고자 하는 오토스케일링 그룹명 입력 |
| desiredCapacity | Yes | Integer | Min: 0 Max : 30 | 기대 서비스 능력으로, 해당 그룹 소속으로 운영될 서버 인스턴스들의 수 설정 이 값이 오토스케일링에 이미 세팅되어 있는 기존 속성인 minSize보다 작아서는 안되고, maxSize보다 커서는 안됨 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

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

## 예시

### 요청 예시

```
{AUTOSCALILNG_API_URL}/setDesiredCapacity
?autoScalingGroupName=asg-1
&desiredCapacity=0
```

### 응답 예시

```
<setDesiredCapacityResponse>
   <requestId>9b414c18-0b78-4e8f-a20d-4f95a16628be</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 />
         <suspendedProcessList />
         <zoneList>
            <zone>
               <zoneNo>2</zoneNo>
               <zoneName>zone2</zoneName>
               <zoneDescription>nang zone</zoneDescription>
            </zone>
            <zone>
               <zoneNo>3</zoneNo>
               <zoneName>zone3</zoneName>
               <zoneDescription>nang zone2</zoneDescription>
            </zone>
         </zoneList>
      </autoScalingGroup>
   </autoScalingGroupList>
</setDesiredCapacityResponse>
```

​

## 오류 코드

아래 오류 코드는 이 액션(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 | 50160 | You cannot delete an Auto Scaling group while there are scaling activities in progress for that group. |