---
title: "putScalingPolicy"
slug: "compute-autoscaling-putscalingpolicy"
tags: ["Auto Scaling"]
updated: 2026-10-22T10:47:10Z
published: 2026-10-22T10:47:10Z
canonical: "api-gov.ncloud-docs.com/compute-autoscaling-putscalingpolicy"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.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 소속이며 그 범위 안에서는 이 이름이 중복 생성될 수 없음 Auto Scaling Group의 범위 안에서 정책 이름이 없다면 생성을 하고 이미 존재한다면 그 내용을 변경함 하나의 Auto Scaling Group 당 최대 10개의 정책을 생성할 수 있음 |
| autoScalingGroupName | Yes | String | Min : 1, Max : 255 | 정책이 수행될 Auto Scaling 그룹명 입력 |
| adjustmentTypeCode | Yes | String | Min : 1, Max : 5 | Group의 capacity를 조정하는 유형코드 `CHANG(Change In Capacity)` `EXACT(ExactCapacity)` `PRCNT(PercentChangeInCapacity)` |
| scalingAdjustment | Yes | Integer | Min: -2147483647, Max : 2147483647 | 스케일링을 위한 Group capacity 조정 값 |
| cooldown | No | Integer | Min:0, Max:2147483647 | 스케일링 액션 종료 이후 cooldown 시간 동안은 알람 통보를 받아도 무시함 |
| minAdjustmentStep | No | Integer | Min:1, Max:2147483647 | - 최소 조정 폭(step) adjustmentTypeCode 유형이 `PRCNT(PercentChangeInCapacity)`일 때만 지정 가능 (지정 안 하는 것도 가능) `PRCNT(PercentChangeInCapacity)` 유형일 때 scalingAdjustment에 의한 변경량이 minAdjustmentStep값 보다 작으면 변경량을 minAdjustmentStep으로 세팅함 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [CommonResponse](/docs/common-apidatatype-commonresponse)

## 예시

### 요청 예시

```
{AUTOSCALILNG_API_URL}/putScalingPolicy
?adjustmentTypeCode=PRCNT
&autoScalingGroupName=asg-0602b
&cooldown=100
&minAdjustmentStep=2
&policyName=p-0602
&scalingAdjustment=40
```

### 응답 예시

```
<putScalingPolicyResponse>
   <requestId>492648d9-9016-4b29-9773-bc457c2bdefd</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
</putScalingPolicyResponse>
```

## 에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 [NAVER Cloud Platform API](/docs/common-ncpapi-ncpapi)를 참고해주세요

| HTTP Response Code | 리턴 코드 | 리턴 메시지 |
| --- | --- | --- |
| 400 | 50130 | The quota for capacity groups or launch configurations for this customer has already been reached. |