---
title: "setDesiredCapacity"
slug: "compute-autoscaling-setdesiredcapacity"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
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 | 最小: 1 最大: 255 | 照会対象のオートスケーリンググループ名を入力 |
| desiredCapacity | Yes | Integer | 最小: 0 最大: 30 | 希望するサービス能力で、そのグループに属して運用されるサーバインスタンス数を設定 この値はオートスケーリングに既に設定されている既存の属性である minSizeより小さくてはならず、maxSizeより大きくてはならない |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [AutoScalingGroupList](/docs/ja/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クラウドプラットフォーム API](/docs/ja/common-ncpapi-index)をご参照ください。

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