---
title: "setDesiredCapacity"
slug: "cli-vautoscaling-autoscalinggroup-setdesiredcapacity"
tags: ["Auto Scaling", "Auto Scaling Group"]
updated: 2026-09-17T09:10:32Z
published: 2026-09-17T09:10:32Z
canonical: "cli-fin.ncloud-docs.com/cli-vautoscaling-autoscalinggroup-setdesiredcapacity"
---

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

# setDesiredCapacity

Auto Scaling Group의 기대 용량을 변경합니다.

## 구문

`setDesiredCapacity` 구문은 다음과 같습니다.

```
./ncloud vautoscaling setDesiredCapacity \
    --autoScalingGroupNo <auto-scaling-group-no> \
    --desiredCapacity <desired-capacity> \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

## 옵션

`setDesiredCapacity` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`setDesiredCapacity`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--autoScalingGroupNo` | String | Required | Auto Scaling Group 번호 - [getAutoScalingGroupList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 참조 |
| `--desiredCapacity` | Integer | Required | 기대 용량 - `0`~`30` - 최소 용량(`minSize`) 이상, 최대 용량(`maxSize`) 이하로 설정 - 입력 값에 따라 서버 수 자동 조정 |

### 공통 옵션

`vautoscaling` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Auto Scaling 옵션](/docs/cli-vautoscaling#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

Auto Scaling Group 기대 용량 변경 요청이 성공하면 수정된 Auto Scaling Group의 구성 정보가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vautoscaling setDesiredCapacity \
    --autoScalingGroupNo 456789012 \
    --desiredCapacity 0 \
    --regionCode FKR \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "setDesiredCapacityResponse": {
    "totalRows": 1,
    "autoScalingGroupList": [
      {
        "vpcNo": "12345678",
        "subnetNo": "23456789",
        "serverNamePrefix": "test",
        "autoScalingGroupNo": "456789012",
        "autoScalingGroupName": "asg-01",
        "launchConfigurationNo": "345678901",
        "minSize": 0,
        "maxSize": 2,
        "desiredCapacity": 0,
        "defaultCoolDown": 600,
        "healthCheckGracePeriod": 300,
        "healthCheckType": {
          "code": "SVR",
          "codeName": "SERVER"
        },
        "createDate": "2026-08-06T14:17:15+0900",
        "autoScalingGroupStatus": {
          "code": "CREAT",
          "codeName": "CREATED"
        },
        "targetGroupNoList": [],
        "inAutoScalingGroupServerInstanceList": [],
        "accessControlGroupNoList": [
          "67890123"
        ],
        "suspendedProcessList": []
      }
    ],
    "requestId": "27774423-be2f-4b51-9ae8-a9058f67eb14",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```