updateAutoScalingGroup
    • PDF

    updateAutoScalingGroup

    • PDF

    기사 요약

    개요

    지정된 Auto Scaling Group을 갱신합니다.

    지정된 파라미터에 해당하는 속성만 그 값이 변경되고 전달되지 않은 파라미터에 해당하는 속성은 기존 값 그대로 남게 됩니다.

    이 액션(Action) 호출에 의해 minSize, desiredCapacity또는 maxSize가 변경되어도 그 대소 관계는 계속 maxSize >= desiredCapacity >= minSize가 유지되어여야 합니다.

    zoneNoList가 변하면 zone rebalancing이 발생합니다.

    이 액션(Action) 호출로 새로운 Launch Configuration이 지정되면, 그 이후 서버 인스턴스가 생성될 때 효과가 나타납니다.

    Auto Scaling Group이 현재 scaling action이 이루어지고 있는 상태에서 호출하면 에러를 뱉어냅니다.

    • minSize는 지정되었으나 desiredCapacity가 지정되어 있지 않을 때, 새로운 minSize 값이 Auto Scaling Group의 현재 사이즈보다 크다면, 암시적으로 setDesiredCapacity가 호출되어서, 그룹 사이즈가 새로운 minSize로 세팅됩니다
    • maxSize는 지정되었으나 desiredCapacity가 지정되어 있지 않을 때, 새로운 maxSize 값이 Auto Scaling Group의 현재 사이즈보다 작다면, 암시적으로 setDesiredCapacity가 호출되어서, 그룹 사이즈가 새로운 maxSize로 세팅됩니다
    • 요청할 때 전달되지 않은 선택적 파라미터 모두 기존 값으로 남게 됩니다. 아무런 선택적 파라미터가 전달되지 않으면 아무 속성 값이 바뀌지 않습니다. (에러는 나지 않습니다.)

    요청

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    autoScalingGroupNameYesStringMin : 1, Max : 255조회하고자 하는 Auto Scaling 그룹명을 입력함
    launchConfigurationNameNoStringMin : 1, Max : 255- 론치설정명
    해당 Auto Scaling 그룹 소속의 서버 인스턴스가 새로 생성될 때 사용되는 서버 관련 정보를 담고 있음
    desiredCapacityNoIntegerMin : 0, Max : 30- 기대 서비스 능력
    해당 그룹 소속으로 운영될 서버 인스턴스들의 수 설정
    이 값이 Auto Scaling에 이미 세팅되어 있는 기존 속성인 minSize보다 작아서는 안되고, maxSize보다 커서는 안됨
    minSizeNoIntegerMin : 0, Max : 30최소 사이즈 (최소 0이고 maxSize 값보다 작거나 같아야 함)
    maxSizeNoIntegerMin : 0, Max : 30최대사이즈
    defaultCooldownNoIntegerMin : 0, Max : 2147483647디폴트 cooldown 시간
    default : 300
    healthCheckGracePeriodConditionalIntegerMin : 0, Max : 2147483647- health check 보류 기간
    서버 인스턴스가 서비스에 투입된 이후 health check를 보류할 시간을 설정함
    healthCheckTypeCode 값이 LOADB(로드밸런서)이면 필수
    healthCheckTypeCodeNoStringMin : 1, Max : 5Health check 유형 코드
    SVR(서버) LOADB(로드밸런서)
    zoneNoListNoString중복 불가- Zone 번호 리스트
    이 그룹 소속 서버 인스턴스들이 존재할 Zone 번호 리스트를 넣음

    응답

    응답 바디

    예시

    요청 예시

    {AUTOSCALILNG_API_URL}/updateAutoScalingGroup
    ?autoScalingGroupName=asg-1
    &desiredCapacity=0
    &maxSize=0
    &minSize=0
    

    응답 예시

    <updateAutoScalingGroupResponse>
       <requestId>5e40dcb6-56cc-46cd-ae08-98ec6e611cd9</requestId>
       <returnCode>0</returnCode>
       <returnMessage>success</returnMessage>
       <totalRows>1</totalRows>
       <autoScalingGroupList>
          <autoScalingGroup>
             <autoScalingGroupName>asg-1</autoScalingGroupName>
             <launchConfigurationName>lc-1</launchConfigurationName>
             <desiredCapacity>0</desiredCapacity>
             <minSize>0</minSize>
             <maxSize>0</maxSize>
             <loadBalancerInstanceSummeryList>
                <loadBalancerInstanceSummery>
                   <loadBalancerName>slb-1</loadBalancerName>
                </loadBalancerInstanceSummery>
                <loadBalancerInstanceSummery>
                   <loadBalancerName>slb-2</loadBalancerName>
                </loadBalancerInstanceSummery>
             </loadBalancerInstanceSummeryList>
             <healthCheckGracePeriod>600</healthCheckGracePeriod>
             <healthCheckType>
                <code>SVR</code>
                <codeName>Server</codeName>
             </healthCheckType>
             <createDate>2014-02-13T17:24:19+0900</createDate>
             <inAutoScalingGroupServerInstanceList>
                <InAutoScalingGroupServerInstance>
                   <healthStatus>
                      <code>HLTHY</code>
                      <codeName>Healthy (normal)</codeName>
                   </healthStatus>
                   <lifecycleState>
                      <code>INSVC</code>
                      <codeName>In service</codeName>
                   </lifecycleState>
                   <launchConfiguration>
                      <launchConfigurationName>lc-1</launchConfigurationName>
                      <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
                      <serverProductCode>SPSVRSTAND000043</serverProductCode>
                      <memberServerImageNo />
                      <loginKeyName>yh-nang-test</loginKeyName>
                      <createDate>2014-02-13T13:45:57+0900</createDate>
                      <userData />
                   </launchConfiguration>
                   <serverInstanceNo>68084</serverInstanceNo>
                   <serverInstanceName>svr-7f8879ae0826836</serverInstanceName>
                </InAutoScalingGroupServerInstance>
             </inAutoScalingGroupServerInstanceList>
             <suspendedProcessList />
             <zoneList>
                <zone>
                   <zoneNo>2</zoneNo>
                   <zoneName>KR-1</zoneName>
                   <zoneCode>KR-1</zoneCode>
                   <zoneDescription>가산 zone</zoneDescription>
                </zone>
             </zoneList>
          </autoScalingGroup>
       </autoScalingGroupList>
    </updateAutoScalingGroupResponse>
    

    에러 코드

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

    HTTP Response Code리턴 코드리턴 메시지
    40050120An invalid or out-of-range value was supplied for the input parameter.
    40050130The quota for capacity groups or launch configurations for this customer has already been reached.
    40050160You cannot delete an Auto Scaling group while there are scaling activities in progress for that group.

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

    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.