---
title: "getAccessControlGroupList  "
slug: "compute-server-getaccesscontrolgrouplist"
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/compute-server-getaccesscontrolgrouplist"
---

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

# getAccessControlGroupList  

## 개요

서버 인스턴스(VM)를 생성할 때 사용자가 설정한 Access Control Group을 넣어 방화벽 기능을 설정할 수 있습니다. 이 API는 사용자의 AccessControlGroup을 조회합니다.

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| accessControlGroupConfigurationNoList.N | No | List<String> | Min:0, Max:5 | 조회할 접근제어 그룹설정 번호 리스트 |
| isDefaultGroup | No | Boolean |  | 디폴트 그룹만 조회 가능 Options : true \| false |
| accessControlGroupName | No | String | Min:3, Max:30 | 조회할 접근 제어 그룹명 |
| pageNo | No | Integer | Min:0, Max:2147483647 | - 페이징된 결과의 페이지 번호 결과값을 pageNo를 이용하여 페이징 처리 가능 |
| pageSize | No | Integer | Min:0, Max:2147483647 | - 페이징시 보여줄 각 페이지 사이즈 결과값을 pageSize를 이용하여 페이징 처리 가능 |

## 응답

### 응답 바디

- [AccessControlGroupList](/docs/common-apidatatype-accesscontrolgrouplist)

## 예시

### 요청 예시

```
GET {SERVER_API_URL}/getAccessControlGroupList
```

### 응답 예시

```
<getAccessControlGroupListResponse>
  <requestId>f9d82d8e-6689-427e-b016-4cfa7b19a1a3</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <accessControlGroupList>
    <accessControlGroup>
      <accessControlGroupConfigurationNo>39995</accessControlGroupConfigurationNo>
      <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
      <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
      <isDefault>true</isDefault>
      <createDate>2018-04-09T11:12:54+0900</createDate>
    </accessControlGroup>
  </accessControlGroupList>
</getAccessControlGroupListResponse>
```