---
title: "putScalingPolicy"
slug: "cli-autoscaling-putscalingpolicy"
tags: ["Auto Scaling"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-autoscaling-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

## 개요

스케일링 정책 생성/변경

## 설명

Scaling 정책(policy)을 생성하거나 변경합니다. 정책 수행을 요청하면 설정된 정책에 따라 scale-in 또는 scale-out action을 수행합니다.

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| policyName | Yes | String | Min : 1, Max : 255 | - 정책 이름, 스케일링 정책의 식별자 특정 Auto Scaling Group 소속이며 그 범위 안에서는 이 이름이 중복 생성될 수 없음 이 api를 호출했을 때 지정된 Auto Scaling Group의 범위 안에서 정책 이름이 없다면 생성을 하고, 이미 존재한다면 그 내용을 변경함 하나의 Auto Scaling Group 당 최대 10개의 정책 생성 가능 |
| autoScalingGroupName | Yes | String | Min : 1, Max : 255 | 정책이 수행될 오토 스케일링 그룹명 입력 |
| adjustmentTypeCode | Yes | String | Min : 1, Max : 5 | - Group의 capacity를 조정하는 유형 코드 다음과 같이 3개의 코드가 유효(괄호 안이 입력 가능한 코드 값) * ChangeInCapacity(CHANG): 아래 수식과 같이 capacity가 지정된 값만큼 변경됨 수식) (new desired capacity) = (current actual capacity) + (scalingAdjustment of ChangeInCapacity type) * ExactCapacity(EXACT): capacity가 지정된 값으로 변경됨 수식) (new desired capacity) = (scalingAdjustment of ExactCapacity type) * PercentChangeInCapacity(PRCNT) : capacity가 지정된 perecent 값만큼 변경됨 수식) (new desired capacity) = (current actual capacity) + (current actual capacity) X (scalingAdjustment of PercentChangeInCapacity type) / 100 |
| scalingAdjustment | Yes | Integer | Min: -2147483647, Max : 2147483647 | - 스케일링을 위한 Group capacity 조정 값 adjustmentTypeCode 값이 ChangeInCapacity(CHANG) 또는 PercentChangeInCapacity(PRCNT) 유형일 때 i ) scalingAdjustment가 양수이면 capacity가 증가해서 scale-out ii) scalingAdjustment가 음수이면 capacity가 감소해서 scale-in PercentChangeInCapacity(PRCNT) 유형의 scalingAdjustment의 최소 값은 -100 |
| cooldown | No | Integer | Min:0, Max:2147483647 | 스케일링 액션 종료 이후 cooldown 시간 동안은 알람 통보를 받아도 무시함 |
| minAdjustmentStep | No | Integer | Min:1, Max:2147483647 | - 최소 조정 폭(step) adjustmentTypeCode 유형이 PercentChangeInCapacity(PRCNT)일 때만 지정 가능 (따라서 지정 안 하는 것도 가능) 다른 유형 값일 경우는 지정이 안됨 PercentChangeInCapacity(PRCNT) 유형일 때 scalingAdjustment에 의한 변경량(change)이 minAdjustmentStep 보다 작으면 변경량을 minAdjustmentStep으로 세팅함 |

## 응답 데이터 타입

- CommonResponse 타입

| CommonResponse extends BaseObject |
| --- |
| private String requestId; |
| private String returnCode; |
| private String returnMessage; |

## 예시

### 호출

```
ncloud autoscaling putScalingPolicy --policyName test-autoscaling-policy --autoScalingGroupName soso02 --adjustmentTypeCode EXACT --scalingAdjustment 22
```

### 응답

```
{
  "putScalingPolicyResponse": {
    "requestId": "e824e13a-c339-45cf-8192-e28b34a6765f",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<putScalingPolicyResponse>
  <requestId>e824e13a-c339-45cf-8192-e28b34a6765f</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
</putScalingPolicyResponse>
```