---
title: "AutoScalingGroup"
slug: "common-vapidatatype-autoscalinggroup"
tags: ["VPC", "API", "AutoScalingGroup"]
updated: 2026-10-22T10:46:08Z
published: 2026-10-22T10:46:08Z
canonical: "api-gov.ncloud-docs.com/common-vapidatatype-autoscalinggroup"
---

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

# AutoScalingGroup

VPC 환경에서 이용 가능합니다.

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

## 구문

구문은 다음과 같습니다.

```
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;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

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