createAutoScalingGroup

Prev Next

개요

식별자 역할을 하는 이름과 여타 속성을 지정해서 새로운 Auto Scaling Group을 생성합니다. 생성 요청이 완료되면 Auto Scaling Group은 다른 호출에서 사용될 완성된 상태가 되어 있습니다. 단, 생성 요청이 완료되었다고 그룹 소속의 서버 인스턴스들이 생성이 완료되어 서비스에 투입이 완료됨을 보장하지는 않습니다.

요청

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
autoScalingGroupName No String Min : 1
Max : 255		 Auto Scaling그룹명은 그룹 식별자 역할을 함
한 번 정해지면 그 뒤로는 불변
launchConfigurationName Yes String Min : 1
Max : 255		 - 론치설정명
해당 Auto Scaling 그룹 소속의 서버 인스턴스가 새로 생성될 때 사용되는 서버 관련 정보를 담고 있음
desiredCapacity No Integer Min : 0
Max : 30		 - 기대 서비스 능력
해당 그룹 소속으로 운영될 서버 인스턴스들의 수를 설정함
이 값이 Auto Scaling에 이미 세팅되어 있는 기존 속성인 minSize 보다 작아서는 안되고, maxSize보다 커서는 안됨
minSize Yes Integer Min : 0
Max : 30		 최소 사이즈 (최소 0이고 maxSize 값보다 작거나 같아야 함)
maxSize Yes Integer Min : 0
Max : 30		 최대사이즈
defaultCooldown No Integer Min : 0
Max : 2147483647		 디폴트 cooldown 시간
default : 300
loadBalancerNameList.N No List 10개 까지 설정가능 해당 그룹 소속 서버가 생성되어 서비스에 투입될 때 등록될 로드밸런서 이름 리스트
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 Yes String 중복 불가 - ZONE번호리스트
이 그룹 소속 서버 인스턴스들이 존재할 Zone 번호 리스트를 넣음
responseFormatType No String - 응답 결과의 포맷 타입
Options : xml | json
Default : xml

응답

응답 바디

예시

요청 예시

{AUTOSCALILNG_API_URL}/createAutoScalingGroup
?autoScalingGroupName=asg-0224
&desiredCapacity=0
&launchConfigurationName=lc-1
&maxSize=0&minSize=0
&zoneNoList.1=2
&zoneNoList.2=3

응답 예시

<createAutoScalingGroupResponse>
   <requestId>015a4c61-c887-43f7-89ba-997ccdd75732</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <autoScalingGroupList>
      <autoScalingGroup>
         <autoScalingGroupName>asg-0224</autoScalingGroupName>
         <launchConfigurationName>lc-1</launchConfigurationName>
         <desiredCapacity>0</desiredCapacity>
         <minSize>0</minSize>
         <maxSize>0</maxSize>
         <loadBalancerInstanceSummeryList />
         <healthCheckGracePeriod>0</healthCheckGracePeriod>
         <healthCheckType>
            <code>SVR</code>
            <codeName>Server</codeName>
         </healthCheckType>
         <createDate>2014-02-24T15:11:11+0900</createDate>
         <inAutoScalingGroupServerInstanceList />
         <suspendedProcessList />
         <zoneList>
            <zone>
               <zoneNo>2</zoneNo>
               <zoneName>zone2</zoneName>
               <zoneDescription>nang zone</zoneDescription>
            </zone>
            <zone>
               <zoneNo>3</zoneNo>
               <zoneName>zone3</zoneName>
               <zoneDescription>nang zone2</zoneDescription>
            </zone>
         </zoneList>
      </autoScalingGroup>
   </autoScalingGroupList>
</createAutoScalingGroupResponse>

에러 코드

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

HTTP Response Code 리턴 코드 리턴 메시지
400 50150 This is returned when you cannot delete a launch configuration, scaling policy, or auto scaling group because it is being used.
400 50160 You cannot request actions while there are scaling activities in progress for that group.