putScalingPolicy
    • PDF

    putScalingPolicy

    • PDF

    기사 요약

    개요

    스케일링 정책 생성/변경

    설명

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

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    policyNameYesStringMin : 1, Max : 255- 정책 이름, 스케일링 정책의 식별자
    특정 Auto Scaling Group 소속이며 그 범위 안에서는 이 이름이 중복 생성될 수 없음
    이 api를 호출했을 때 지정된 Auto Scaling Group의 범위 안에서 정책 이름이 없다면 생성을 하고, 이미 존재한다면 그 내용을 변경함
    하나의 Auto Scaling Group 당 최대 10개의 정책을 생성할 수 있음
    autoScalingGroupNameYesStringMin : 1, Max : 255정책이 수행될 오토 스케일링 그룹명 입력
    adjustmentTypeCodeYesStringMin : 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
    scalingAdjustmentYesIntegerMin: -2147483647, Max : 2147483647- 스케일링을 위한 Group capacity 조정 값
    adjustmentTypeCode 값이 ChangeInCapacity(CHANG) 또는 PercentChangeInCapacity(PRCNT) 유형일 때
    i ) scalingAdjustment가 양수이면 capacity가 증가해서 scale-out
    ii) scalingAdjustment가 음수이면 capacity가 감소해서 scale-in
    PercentChangeInCapacity(PRCNT) 유형의 scalingAdjustment의 최소 값은 -100
    cooldownNoIntegerMin:0, Max:2147483647스케일링 액션 종료 이후 cooldown 시간 동안은 알람 통보를 받아도 무시
    minAdjustmentStepNoIntegerMin: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>
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.