---
title: "Target Group 목록 조회"
slug: "devtools-sourcedeploy-targetgrouplist"
tags: ["SourceDeploy"]
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/devtools-sourcedeploy-targetgrouplist"
---

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

# Target Group 목록 조회

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

사용 가능한 Auto Scaling 그룹과 연결된 로드 밸런서 Target Group 목록을 조회합니다.

참고

Target Group 목록을 조회하려면 Load Balancer 서비스에서 생성한 Target Group이 Auto Scaling 그룹과 연결되어 있어야 합니다. Auto Scaling 그룹 생성 시 헬스 체크 기준을 Load Balancer로 선택하고 Target Group을 지정해야 연결됩니다. 리소스 생성 및 연결 방법은 다음을 참조해 주십시오.

- 네이버 클라우드 플랫폼 콘솔에서 생성 및 연결
  - [Load Balancer 사용 가이드](https://guide.ncloud-docs.com/docs/networking-loadbalancer-loadbalanceroverview) 참조
  - [Auto Scaling 사용 가이드](https://guide.ncloud-docs.com/docs/autoscaling-overview) 참조
- API를 사용하여 생성 및 연결
  - [Load Balancer (VPC) API 가이드](/docs/networking-vloadbalancer) 참조
  - [Auto Scaling (VPC) API 가이드](/docs/compute-vautoscaling) 참조

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /api/v1/autoscaling/{autoScalingName} |

### 요청 헤더

SourceDeploy API에서 공통으로 사용하는 헤더에 대한 정보는 [SourceDeploy 요청 헤더](/docs/devtools-sourcedeploy#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `autoScalingName` | String | Required | Auto Scaling 그룹 이름 - [Auto Scaling 그룹 목록 조회](/docs/devtools-sourcedeploy-autoscalinggrouplist) 참조 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://vpcsourcedeploy.apigw.ntruss.com/api/v1/autoscaling/asg2' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `result` | Object | - | 응답 결과 |
| `result.targetGroupList` | Array | - | Target Group 목록: [targetGroupList](/docs/devtools-sourcedeploy-targetgrouplist#targetGroupList) |

#### `targetGroupList`

`targetGroupList`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `id` | Number | - | 로드 밸런서 Target Group 번호 |
| `name` | String | - | 로드 밸런서 Target Group 이름 |
| `permission` | String | - | 상세 정보 조회 권한 소유 여부 - `Allow` \| `Deny` - `Allow`: 소유 - `Deny`: 소유 안 함 |
| `actionName` | String | - | 상세 정보 조회 권한 이름 |

### 응답 상태 코드

SourceDeploy API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [SourceDeploy 응답 상태 코드](/docs/devtools-sourcedeploy#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "result": {
        "targetGroupList": [
            {
                "id": 41****,
                "name": "target-001",
                "permission": "Allow",
                "actionName": "View/getLoadBalancerDetail"
            }
        ]
    }
}
```