---
title: "TargetGroup"
slug: "common-vapidatatype-targetgroup"
updated: 2026-07-23T09:04:11Z
published: 2026-07-23T09:04:11Z
canonical: "api.ncloud-docs.com/common-vapidatatype-targetgroup"
---

> ## 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.

# TargetGroup

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

타깃 그룹입니다.

## 구문

구문은 다음과 같습니다.

```
private String targetGroupNo;
private String targetGroupName;
private CommonCode targetType;
private String vpcNo;
private CommonCode targetGroupProtocolType;
private Integer targetGroupPort;
private String targetGroupDescription;
private Boolean useStickySession;
private Boolean useProxyProtocol;
private CommonCode algorithmType;
private Date createDate;
private String regionCode;
private String loadBalancerInstanceNo;
private CommonCode healthCheckProtocolType;
private Integer healthCheckPort;
private String healthCheckUrlPath;
private CommonCode healthCheckHttpMethodType;
private Integer healthCheckCycle;
private Integer healthCheckUpThreshold;
private Integer healthCheckDownThreshold;
private TargetNoList targetNoList;
```

## 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `targetGroupNo` | String | Required | 타깃 그룹 번호 - 타깃 그룹을 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| `targetGroupName` | String | Required | 타깃 그룹 이름 |
| `targetType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 타깃 구분 - `VSVR` - `VSVR`: Server (VPC) |
| `vpcNo` | String | Required | VPC 번호 |
| `targetGroupProtocolType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 타깃 그룹 프로토콜 유형 - `TCP` \| `UDP` \| `PROXY_TCP` \| `HTTP` \| `HTTPS` |
| `targetGroupPort` | Integer | Required | 타깃 그룹 포트 - 1~65534 |
| `targetGroupDescription` | String | Optional | 타깃 그룹 설명 |
| `useStickySession` | Boolean | Required | 세션별 접근 사용 여부 - `true` \| `false` |
| `useProxyProtocol` | Boolean | Required | 프록시 프로토콜 사용 여부 - `true` \| `false` |
| `algorithmType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 알고리즘 유형 - `RR` \| `SIPHS` \| `LC` \| `MH` - `RR`: Round Robin - `SIPHS`: Source IP Hash - `LC`: Least Connection - `MH`: Maglev Hash |
| `createDate` | Date | Required | 생성 일시(YYYY-MM-DDThh:mm:ssZ) |
| `regionCode` | String | Required | 리전 코드 |
| `loadBalancerInstanceNo` | String | Optional | 연결된 로드 밸런서 인스턴스 번호 |
| `healthCheckProtocolType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 헬스 체크 프로토콜 유형 - `TCP` \| `HTTP` \| `HTTPS` |
| `healthCheckPort` | Integer | Required | 헬스 체크 포트 - 1~65534 |
| `healthCheckUrlPath` | String | Optional | 헬스 체크 URL 경로 |
| `healthCheckHttpMethodType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | 헬스 체크 HTTP Method 유형 - `HEAD` \| `GET` |
| `healthCheckCycle` | Integer | Required | 헬스 체크 주기(초) - 5~300 |
| `healthCheckUpThreshold` | Integer | Required | 헬스 체크 정상 임곗값 - 2~10 |
| `healthCheckDownThreshold` | Integer | Required | 헬스 체크 실패 임곗값 - 2~10 |
| `targetNoList` | [TargetNoList](/docs/common-vapidatatype-targetnolist) | Optional | 타깃 그룹에 포함된 타깃 번호 목록 |