createAutoScalingGroup

Prev Next

Overview

Create a new Auto Scaling Group by specifying a name that acts as an identifier and other attributes. Once the creation request is complete, the Auto Scaling Group is in a completed state to be used in other calls. However, the completion of the creation request does not guarantee that the server instances belonging to the group have been created and put into service.

Request

Request parameters

Parameter name Required Type Restrictions Description
autoScalingGroupName No String Min: 1
Max: 255
- Autoscaling group name
It acts as a group identifier.
Once it is decided, it is unchangeable thereafter.
launchConfigurationName Yes String Min: 1
Max: 255
- Launch configuration name
Server-related information used when a server instance belonging to the corresponding auto scaling group is newly created
desiredCapacity No Integer Min: 0
Max: 30
- Expected service capacity
Set the number of server instances to be operated as a member of the group.
This value must not be less than the existing attribute minSize that is already set for autoscaling, and it must not be greater than maxSize.
minSize Yes Integer Min: 0
Max: 30
Minimum size (minimum of 0, must be less than or equal to the maxSize value)
maxSize Yes Integer Min: 0
Max: 30
Maximum size
defaultCooldown No Integer Min: 0
Max: 2147483647
Default cooldown time default : 300
loadBalancerNameList.N No List Up to 10 can be set. List of load balancer names to be registered when servers belonging to the group are created and put into service
healthCheckGracePeriod Conditional Integer Min: 0
Max: 2147483647
- Health check grace period
Set the time to hold off on health checks after a server instance is put into service.
Required if healthCheckTypeCode value is LOADB (load balancer)
healthCheckTypeCode No String Min: 1
Max: 5
Health check type code
SVR (server) LOADB (load balancer)
zoneNoList Yes String It can't be duplicated. - Zone number list
List of zone numbers where server instances belonging to this group will exist
responseFormatType No String - Format type of the response result
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

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

Response example

<createAutoScalingGroupResponse>
   <requestId>015a4c61-c887-43f7-89ba-997ccdd75732</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <autoScalingGroupList>
      <autoScalingGroup>
         <autoScalingGroupName>asg-0224</autoScalingGroupName>
         <autoScalingGroupNo>***517</autoScalingGroupNo>
         <launchConfigurationName>lc-1</launchConfigurationName>
         <launchConfigurationNo>***013</launchConfigurationNo>
         <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>

Errors

Errors that may occur while using this action are listed below. For more information about common errors, see NAVER Cloud Platform API.

HTTP Response Code Return code Return message
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.