--- title: "putScalingPolicy" slug: "cli-autoscaling-putscalingpolicy" updated: 2026-04-23T08:57:04Z published: 2026-04-23T08:58:56Z 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 ``` ### 응답 ```json { "putScalingPolicyResponse": { "requestId": "e824e13a-c339-45cf-8192-e28b34a6765f", "returnCode": "0", "returnMessage": "success" } } ``` ```xml e824e13a-c339-45cf-8192-e28b34a6765f 0 success ```