updateAutoScalingGroup

Prev Next

개요

지정된 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로 세팅됩니다
  • 요청할 때 전달되지 않은 선택적 파라미터 모두 기존 값으로 남게 됩니다. 아무런 선택적 파라미터가 전달되지 않으면 아무 속성 값이 바뀌지 않습니다. (에러는 나지 않습니다.)

요청

요청 파라미터

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

응답

응답 바디

예시

요청 예시

{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 리턴 코드 리턴 메시지
400 50120 An invalid or out-of-range value was supplied for the input parameter.
400 50130 The quota for capacity groups or launch configurations for this customer has already been reached.
400 50160 You cannot delete an Auto Scaling group while there are scaling activities in progress for that group.