putScalingPolicy

VPC 환경에서 이용 가능합니다.

Auto Scaling Group의 Scaling 정책을 생성하거나 수정합니다.

구문

putScalingPolicy 구문은 다음과 같습니다.

./ncloud vautoscaling putScalingPolicy \
    --autoScalingGroupNo <auto-scaling-group-no> \
    --adjustmentTypeCode <CHANG|PRCNT|EXACT> \
    --scalingAdjustment <scaling-adjustment> \
    [--policyNo <policy-no>] \
    [--policyName <policy-name>] \
    [--minAdjustmentStep <min-adjustment-step>] \
    [--coolDown <cooldown>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

putScalingPolicy 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

putScalingPolicy의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--autoScalingGroupNo`	String	Required	Auto Scaling Group 번호 getAutoScalingGroupList 참조
`--adjustmentTypeCode`	String	Required	조정 유형 코드 `CHANG` \| `PRCNT` \| `EXACT` `CHANG`: 용량 변경치 (증감 변경, change in capacity) `PRCNT`: 용량 변경 퍼센티지 (비율 변경, percent change in capacity) `EXACT`: 세팅할 정확한 용량 (고정값, exact capacity) getAdjustmentTypeList 참조
`--scalingAdjustment`	Integer	Required	조정값 조정 유형에 따라 지정 `CHANG`: `-2147483648` 이상 `PRCNT`: `-100` 이상 `EXACT`: `0` 이상 최대 `2147483647`까지 입력 가능 `CHANG`/`PRCNT`는 음수 입력 시 감소
`--policyNo`	String	Conditional	정책 번호 정책 생성 시 입력하지 않음 정책 수정 시 `policyNo`, `policyName` 중 하나는 필수 입력 getAutoScalingPolicyList 참조
`--policyName`	String	Conditional	정책 이름 새로운 이름 입력 시 정책 생성 영문 소문자, 숫자, 특수문자 `-`를 조합하여 1~255자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 기존 이름 입력 시 정책 수정 정책 생성 시 필수 입력 정책 수정 시 `policyNo`, `policyName` 중 하나는 필수 입력 getAutoScalingPolicyList 참조

선택 옵션

putScalingPolicy의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--minAdjustmentStep`	Integer	Optional	최소 조정 폭 `1`~`2147483647` 최소 조정 폭만큼 서버 인스턴스 수 변경 `adjustmentTypeCode`가 `PRCNT`인 경우에만 유효
`--coolDown`	Integer	Optional	쿨다운 (초) `0`~`2147483647` (기본값: `300`) Scaling 후 서버 준비를 위한 모니터링 대기 시간

공통 옵션

vautoscaling 명령에서 공통으로 사용하는 옵션에 대한 정보는 Auto Scaling (VPC) 옵션을 참조해 주십시오.

예시

Scaling 정책 생성 또는 수정 요청이 성공하면 Scaling 정책의 구성 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vautoscaling putScalingPolicy \
    --autoScalingGroupNo 20461037 \
    --policyName policy-01 \
    --adjustmentTypeCode CHANG \
    --scalingAdjustment 1 \
    --coolDown 300 \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "putScalingPolicyResponse": {
    "totalRows": 1,
    "scalingPolicyList": [
      {
        "autoScalingGroupNo": "456789012",
        "policyNo": "567890123",
        "policyName": "policy-01",
        "adjustmentType": {
          "code": "CHANG",
          "codeName": "용량 변경치"
        },
        "scalingAdjustment": 1,
        "coolDown": 300
      }
    ],
    "requestId": "f7cbe3eb-2261-481c-860b-f22c0179aeee",
    "returnCode": "0",
    "returnMessage": "success"
  }
}