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로 세팅됩니다
- 요청할 때 전달되지 않은 선택적 파라미터 모두 기존 값으로 남게 됩니다. 아무런 선택적 파라미터가 전달되지 않으면 아무 속성 값이 바뀌지 않습니다. (에러는 나지 않습니다.)
요청
요청 파라미터
파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
---|---|---|---|---|
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 번호 리스트를 넣음 |
응답
응답 바디
예시
요청 예시
{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. |
이 문서가 도움이 되었습니까?