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 codeSVR (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. |