---
title: "putScalingPolicy"
slug: "cli-vautoscaling-autoscalinggroup-putscalingpolicy"
tags: ["Auto Scaling"]
updated: 2026-04-23T08:57:02Z
published: 2026-04-23T08:58:56Z
canonical: "cli.ncloud-docs.com/cli-vautoscaling-autoscalinggroup-putscalingpolicy"
---

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

# putScalingPolicy

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

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


Scaling 정책을 생성 또는 수정합니다.

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


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


| 파라미터명                            | 필수 여부       | 타입                   | 제약 사항                   | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                           | - 리전 코드<br/>Scaling 정책을 생성 또는 수정할 Auto Scaling Group의 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택   |
| autoScalingGroupNo                 | Yes          | String                |                           | - Auto Scaling Group 번호<br/>autoScalingGroupNo는 [getAutoScalingGroupList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 액션을 통해 획득 가능    |
| policyNo                           | Conditional  | String                |                           | - 수정할 Scaling 정책 번호<br/>Scaling 정책 번호를 이용하여 수정할 정책 지정 가능<br/>새로운 Scaling 정책을 생성하는 경우에는 입력하지 않음<br/>수정하는 경우 policyNo와 policyName 중 반드시 한개를 필수로 입력<br/>policyNo는 [getAutoScalingPolicyList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalingpolicylist) 액션을 통해 획득 가능  |
| policyName                         | Conditional  | String                | Min : 1, Max : 255<br/>소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함<br/>영어 또는 숫자로 끝나야 함  | - Scaling 정책 이름<br/>새로 생성할 Scaling 정책 이름을 입력하거나 수정할 Scaling 정책 이름을 입력할 수 있음<br/>지정한 이름의 Scaling 정책이 이미 존재하는경우 해당 Scaling 정책의 내용이 수정됨<br/>수정하는 경우 policyNo와 policyName 중 반드시 한개를 필수로 입력함<br/>생성하는 경우에는 policyName을 필수로 입력함<br/>policyName는 [getAutoScalingPolicyList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalingpolicylist) 액션을 통해 획득 가능    |
| adjustmentTypeCode                 | Yes          | String                |                           | - 조정 유형 코드<br/>Scaling 정책이 수행될 때 서버의 대수가 조정되는 방식을 결정함<br/>Options :<br/>`CHANG (Change In Capacity (증감변경))` : 현재 그룹 크기와 상관없이 지정한 서버 대수를 직접 추가 또는 삭제하는 방법<br/>`PRCNT (Percent Change In Capacity (비율변경)` : 현재 그룹 크기 대비 일정한 비율(%)로 서버를 증감시키는 방법<br/>`EXACT (Exact Capacity (고정값))` : 그룹 크기를 지정한 값으로 고정시키는 방법<br/>adjustmentTypeCode는 [getAdjustmentTypeList](/docs/cli-vautoscaling-autoscalinggroup-getadjustmenttypelist) 액션을 통해 획득가능  |
| scalingAdjustment                  | Yes          | Integer               | Min: adjustmentTypeCode에 따라서 최소값 범위가 달라짐<br/>CHANG : -2147483648<br/>PRCNT : -100<br/>EXACT : 0<br/>Max : 2147483647  | - 조정값<br/>조정 유형에 맞는 조정값을 지정함<br/>adjustmentTypeCode 가 CHANG 또는 PRCNT 일때 감소시키려면 음수의 값 입력<br/>조정 유형에 따라서 단위가 (대) 또는 (%) 가 될 수 있음    |
| minAdjustmentStep                  | No           | Integer               | Min: 1, Max : 2147483647  | - 최소 조정 폭<br/>최소 조정 폭 만큼 서버 인스턴스 수를 변경함<br/>adjustmentTypeCode 가 PRCNT 일때만 유효함    |
| coolDown                           | No           | Integer               | Min: 0, Max : 2147483647  | - 쿨다운<br/>새로운 서버가 생성되었다고 해도, 초기화 스크립트 실행이나 업데이트 설치 등의 이유로 실제 서비스를 수행할 수 있을 정도로 준비되기까지는 시간이 소요될 수 있음<br/> 쿨다운(Cooldown) 시간이란 실제 Scaling이 수행 중이거나 수행 완료된 이후에 모니터링 이벤트 알람이 발생하더라도 반응하지 않고 무시하도록 설정한 기간<br/>Default : 300 초   |
| responseFormatType                 | No           | String                |                           | - 응답 결과의 포맷 타입<br/>Options : xml \| json<br/>Default : xml |

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


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

- ScalingPolicyList 타입

| ScalingPolicyList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<ScalingPolicy> scalingPolicyList = new ArrayList<>(); |

| ScalingPolicy |
| ---------- |
| private String autoScalingGroupNo; |
| private String policyNo; |
| private String policyName; |
| private CommonCode adjustmentType; |
| private Integer scalingAdjustment; |
| private Integer minAdjustmentStep; |
| private Integer coolDown; |


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


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

```
ncloud vautoscaling putScalingPolicy --regionCode KR --autoScalingGroupNo ***700 --policyName test-*** --adjustmentTypeCode CHANG --scalingAdjustment 1 --coolDown 300 --timeZone KST
```

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




```xml
<putScalingPolicyResponse>
  <requestId>dcbf41de-b9d4-460d-a594-60d77ec25bf1</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <scalingPolicyList>
      <scalingPolicy>
        <autoScalingGroupNo>***700</autoScalingGroupNo>
        <policyNo>***922</policyNo>
        <policyName>test-***</policyName>
        <adjustmentType>
          <code>CHANG</code>
          <codeName>ChangeInCapacity</codeName>
        </adjustmentType>
        <scalingAdjustment>1</scalingAdjustment>
        <coolDown>300</coolDown>
      </scalingPolicy>
    </scalingPolicyList>
</putScalingPolicyResponse>
```