---
title: "AutoScalingGroup"
slug: "common-vapidatatype-autoscalinggroup"
updated: 2026-04-23T08:54:57Z
published: 2026-04-23T09:02:00Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AutoScalingGroup

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

오토 스케일링 그룹입니다.

## 구문 <a name="구문"></a>
구문은 다음과 같습니다.

```Java
private String vpcNo;
private String subnetNo;
private String serverNamePrefix;
private String autoScalingGroupNo;
private String autoScalingGroupName;
private String launchConfigurationNo;
private Integer minSize;
private Integer maxSize;
private Integer desiredCapacity;
private Integer defaultCoolDown;
private Integer healthCheckGracePeriod;
private CommonCode healthCheckType;
private Date createDate;
private CommonCode autoScalingGroupStatus;
private TargetGroupNoList targetGroupNoList;
private List<InAutoScalingGroupServerInstance> inAutoScalingGroupServerInstanceList;
private AccessControlGroupNoList accessControlGroupNoList;
private List<SuspendedProcess> suspendedProcessList;
```

## 필드 <a name="필드"></a>
필드에 대한 설명은 다음과 같습니다.

| 필드                               | 타입       | 필수 여부                                           | 설명                                                        |
| ------------------------------------- | ------------- | --------------------------------------------- | ---------------------------------------------------------- |
| `vpcNo`                                 | String           | Required                                        | 오토 스케일링이 수행될 VPC 번호 |
| `subnetNo`                              | String           | Required                                        | 오토 스케일링이 수행될 Subnet 번호   |
| `serverNamePrefix`                      | String            | Optional                                        | Scale-out에 의해 생성되는 서버 이름의 Prefix |
| `autoScalingGroupNo`                    | String           | Required                                        | 오토 스케일링 그룹 번호<ul><li>오토 스케일링 그룹을 식별하기 위한 네이버 클라우드 플랫폼의 식별자</li></ul>   |
| `autoScalingGroupName`                  | String           | Required                                        | 오토 스케일링 그룹 이름 |
| `launchConfigurationNo`                 | String           | Required                                        | 오토 스케일링 그룹에 설정된 Launch Configuration 번호   |
| `minSize`                               | Integer           | Required                                       | 최소 용량<ul><li>0~30</li></ul>|
| `maxSize`                               | Integer           | Required                                       | 최대 용량<ul><li>0~30</li></ul>|
| `desiredCapacity`                       | Integer           | Required                                       | 기대 용량<ul><li>0~30</li></ul>|
| `defaultCoolDown`                       | Integer           | Required                                       | 쿨다운 기본값(초)<ul><li>실제 스케일링이 수행 중이거나 수행 완료된 이후에 모니터링 이벤트 알람이 발생하더라도 반응하지 않고 무시하도록 설정한 기간</li></ul>   |
| `healthCheckGracePeriod`                | Integer           | Required                                       | 헬스 체크 보류 기간(초)<ul><li>서버가 정상 응답하지 않더라도 해당 기간 동안 헬스 체크를 보류</li></ul>   |
| `healthCheckType`                       | [CommonCode](/docs/common-vapidatatype-commoncode)           | Required                                    | `헬스 체크 유형`<ul><li>`SVR` \| `LOADB`<ul><li>`SVR`: Server</li><li>`LOADB`: Load Balancer</li></ul><li>헬스 체크 유형을 `LOADB`로 설정 시 설정된 타겟 그룹의 헬스 체크 방식과 기준에 따라 서버의 상태를 판단</li></li></ul>    |
| `createDate`                            | Date           | Required                                          | 생성 일시(YYYY-MM-DDThh:mm:ssZ)|
| `autoScalingGroupStatus`                | [CommonCode](/docs/common-vapidatatype-commoncode) | Required                                    | 오토 스케일링 그룹 상태<ul><li>`CREAT` \| `DELTD`<ul><li>`CREAT`: Created</li><li>`DELTD`: Deleted</li></ul>   |
| `targetGroupNoList`                     | [TargetGroupNoList](/docs/common-vapidatatype-targetgroupnolist)            | Optional                             | 타겟 그룹 번호 목록<ul><li>헬스 체크 유형을 `LOADB`로 설정 시 유효하며 각 타겟 그룹의 헬스 체크 방식과 기준에 따라 서버의 상태를 판단</li></ul>  |
| `inAutoScalingGroupServerInstanceList`  | List&lt;[InAutoScalingGroupServerInstance](/docs/common-vapidatatype-InAutoScalingGroupServerInstance)&gt;            | Optional  | 오토 스케일링 그룹에 속한 서버 인스턴스 목록    |
| `accessControlGroupNoList`              | [AccessControlGroupNoList](/docs/common-vapidatatype-accesscontrolgroupnolist)           | Required                      | Scale-out에 의해 생성되는 서버 그룹에 적용되는 ACG 번호 목록<ul><li>최대 3개까지 적용 가능</li></ul>  |
| `suspendedProcessList`                  | List&lt;[SuspendedProcess](/docs/common-vapidatatype-SuspendedProcess)&gt;             | Optional                 | 일시 정지된 프로세스 목록   |