---
title: "setDesiredCapacity"
slug: "cli-autoscaling-setdesiredcapacity"
updated: 2026-04-23T08:57:03Z
published: 2026-04-23T08:58:56Z
canonical: "cli.ncloud-docs.com/cli-autoscaling-setdesiredcapacity"
---

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

# setDesiredCapacity

## 개요<a name="개요"></a>


기대 용량치(기대 서비스 능력) 갱신


## 설명<a name="설명"></a>


지정된 오토 스케일링 그룹에 대한 기대 서비스 능력 설정이 가능합니다.


## 요청 파라미터<a name="요청파라미터"></a>


| 파라미터 명          | 필수   여부 | 타입    | 제약사항           | 설명                                                         |
| -------------------- | ----------- | ------- | ------------------ | ------------------------------------------------------------ |
| autoScalingGroupName | Yes         | String  | Min : 1, Max : 255 | 조회하고자 하는 오토 스케일링 그룹명 입력           |
| desiredCapacity      | Yes         | Integer | Min: 0, Max : 30   | 기대 서비스 능력으로 해당 그룹 소속으로 운영될 서버 인스턴스들의 수 설정</br>이 값이 오토 스케일링에 이미 세팅되어 있는 기존 속성인 min   size보다 작아서는 안되고 max size보다 커서는 안됨 |



## 응답 데이터 타입<a name="응답데이터타입"></a>


- AutoScalingGroupList 타입

| AutoScalingGroupList extends CommonResponse                                                      |
| ------------------------------------------------------------------------------------------------ |
| private Integer totalRows;                                                                       |
| private List<AutoScalingGroup> autoScalingGroupList = new ArrayList<AutoScalingGroup>();         |


| AutoScalingGroup extends BaseObject                                                              |
| ------------------------------------------------------------------------------------------------ |
| private String autoScalingGroupName;                                                             |
| private String launchConfigurationName;                                                          |
| private Integer desiredCapacity;                                                                 |
| private Integer minSize;                                                                         |
| private Integer maxSize;                                                                         |
| private Integer defaultCooldown;                                                                 |
| private List<LoadBalancerInstanceSummary> loadBalancerInstanceSummaryList;                       |
| private Integer healthCheckGracePeriod;                                                          |
| private CommonCode healthCheckType;                                                              |
| private Date createDate;                                                                         |
| private List<InAutoScalingGroupServerInstance> inAutoScalingGroupServerInstanceList;             |
| private List<SuspendedProcess> suspendedProcessList;                                             |
| private List<Zone> zoneList;                                                                     |


| LoadBalancerInstanceSummary extends BaseObject                                                   |
| ------------------------------------------------------------------------------------------------ |
| private String loadBalancerInstanceNo;                                                           |
| private String loadBalancerName;                                                                 |


| InAutoScalingGroupServerInstance extends BaseObject                                              |
| ------------------------------------------------------------------------------------------------ |
| private CommonCode healthStatus;                                                                 |
| private CommonCode lifecycleState;                                                               |
| private LaunchConfiguration launchConfiguration;                                                 |
| private String serverInstanceNo;                                                                 |
| private String serverInstanceName;                                                               |


| SuspendedProcess
| ------------------------------------------------------------------------------------------------ |
| private CommonCode process;                                                                      |
| private String suspensionReason;                                                                 |


| Zone
| ------------------------------------------------------------------------------------------------ |
| private String zoneNo;                                                                           |
| private String zoneName;                                                                         |
| private String zoneCode;                                                                         |
| private String zoneDescription;                                                                  |
| private String regionNo;                                                                         |
| private long totalMemorySize;                                                                    |
| private long totalUsedMemorySize;                                                                |
| private long totalUsePossibleMemorySize;                                                         |


| CommonCode
| ------------------------------------------------------------------------------------------------ |
| private String codeKind;                                                                         |
| private String detailCategorizeCode;                                                             |
| private String code;                                                                             |
| private String codeName;                                                                         |
| private Integer codeOrder;                                                                       |
| private String javaConstantCode;                                                                 |


| LaunchConfiguration                                                                              |
| ------------------------------------------------------------------------------------------------ |
| private String launchConfigurationName;                                                          |
| private String serverImageProductCode;                                                           |
| private String serverProductCode;                                                                |
| private String memberServerImageNo;                                                              |
| private String loginKeyName;                                                                     |
| private Date createDate;                                                                         |
| private String userData;                                                                         |
| private List<AccessControlGroup> accessControlGroupList;                                         |


| AccessControlGroup extends BaseObject                                                            |
| ------------------------------------------------------------------------------------------------ |
| private String accessControlGroupConfigurationNo;                                                |
| private String accessControlGroupName;                                                           |
| private String accessControlGroupDescription;                                                    |
| private boolean isDefault;                                                                       |
| private Date createDate;                                                                         |


## 예시<a name="예시"></a>

### 호출<a name="호출"></a>


```
ncloud autoscaling setDesiredCapacity --autoScalingGroupName soso02 --desiredCapacity 5
```

### 응답<a name="응답"></a>


```json
{
  "setDesiredCapacityResponse": {
    "requestId": "e1e84571-50a0-451f-8acb-ff8dce840ecc",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "autoScalingGroupList": [
      {
        "autoScalingGroupName": "soso02",
        "launchConfigurationName": "test-autoscaling",
        "desiredCapacity": 5,
        "minSize": 0,
        "maxSize": 30,
        "defaultCooldown": 12,
        "loadBalancerInstanceSummaryList": [],
        "healthCheckGracePeriod": 42,
        "healthCheckType": {
          "code": "SVR",
          "codeName": "Server"
        },
        "createDate": "2017-08-18T14:11:49+0900",
        "inAutoScalingGroupServerInstanceList": [
          {
            "healthStatus": {
              "code": "HLTHY",
              "codeName": "Healthy (normal)"
            },
            "lifecycleState": {
              "code": "PNDNG",
              "codeName": "Pending status"
            },
            "launchConfiguration": {
              "launchConfigurationName": "test-autoscaling",
              "serverImageProductCode": "SPSW0LINUX000044",
              "serverProductCode": "SPSVRSTAND000003",
              "memberServerImageNo": "",
              "loginKeyName": "packer-1522153936",
              "createDate": "2018-04-05T14:53:16+0900",
              "userData": ""
            },
            "serverInstanceNo": "401886",
            "serverInstanceName": "s-3a1ry5007bc39y001"
          },
          {
            "healthStatus": {
              "code": "HLTHY",
              "codeName": "Healthy (normal)"
            },
            "lifecycleState": {
              "code": "PNDNG",
              "codeName": "Pending status"
            },
            "launchConfiguration": {
              "launchConfigurationName": "test-autoscaling",
              "serverImageProductCode": "SPSW0LINUX000044",
              "serverProductCode": "SPSVRSTAND000003",
              "memberServerImageNo": "",
              "loginKeyName": "packer-1522153936",
              "createDate": "2018-04-05T14:53:16+0900",
              "userData": ""
            },
            "serverInstanceNo": "401889",
            "serverInstanceName": "s-3a1ry5007bc39y002"
          }
        ],
        "suspendedProcessList": [],
        "zoneList": [
          {
            "zoneNo": "2",
            "zoneName": "KR-1",
            "zoneCode": "KR-1",
            "zoneDescription": "KR-1 zone",
            "regionNo": "1"
          }
        ]
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<setDesiredCapacityResponse>
  <requestId>e1e84571-50a0-451f-8acb-ff8dce840ecc</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <autoScalingGroupList>
    <autoScalingGroupName>soso02</autoScalingGroupName>
    <launchConfigurationName>test-autoscaling</launchConfigurationName>
    <desiredCapacity>5</desiredCapacity>
    <minSize>0</minSize>
    <maxSize>30</maxSize>
    <defaultCooldown>12</defaultCooldown>
    <loadBalancerInstanceSummaryList/>
    <healthCheckGracePeriod>42</healthCheckGracePeriod>
    <healthCheckType>
      <code>SVR</code>
      <codeName>Server</codeName>
    </healthCheckType>
    <createDate>2017-08-18T14:11:49+0900</createDate>
    <inAutoScalingGroupServerInstanceList>
      <healthStatus>
        <code>HLTHY</code>
        <codeName>Healthy (normal)</codeName>
      </healthStatus>
      <lifecycleState>
        <code>PNDNG</code>
        <codeName>Pending status</codeName>
      </lifecycleState>
      <launchConfiguration>
        <launchConfigurationName>test-autoscaling</launchConfigurationName>
        <serverImageProductCode>SPSW0LINUX000044</serverImageProductCode>
        <serverProductCode>SPSVRSTAND000003</serverProductCode>
        <memberServerImageNo></memberServerImageNo>
        <loginKeyName>packer-1522153936</loginKeyName>
        <createDate>2018-04-05T14:53:16+0900</createDate>
        <userData></userData>
      </launchConfiguration>
      <serverInstanceNo>401886</serverInstanceNo>
      <serverInstanceName>s-3a1ry5007bc39y001</serverInstanceName>
    </inAutoScalingGroupServerInstanceList>
    <inAutoScalingGroupServerInstanceList>
      <healthStatus>
        <code>HLTHY</code>
        <codeName>Healthy (normal)</codeName>
      </healthStatus>
      <lifecycleState>
        <code>PNDNG</code>
        <codeName>Pending status</codeName>
      </lifecycleState>
      <launchConfiguration>
        <launchConfigurationName>test-autoscaling</launchConfigurationName>
        <serverImageProductCode>SPSW0LINUX000044</serverImageProductCode>
        <serverProductCode>SPSVRSTAND000003</serverProductCode>
        <memberServerImageNo></memberServerImageNo>
        <loginKeyName>packer-1522153936</loginKeyName>
        <createDate>2018-04-05T14:53:16+0900</createDate>
        <userData></userData>
      </launchConfiguration>
      <serverInstanceNo>401889</serverInstanceNo>
      <serverInstanceName>s-3a1ry5007bc39y002</serverInstanceName>
    </inAutoScalingGroupServerInstanceList>
    <suspendedProcessList/>
    <zoneList>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zoneList>
  </autoScalingGroupList>
</setDesiredCapacityResponse>
```