---
title: "getAccessControlGroupList"
slug: "cli-server-getaccesscontrolgrouplist"
updated: 2026-04-23T08:56:59Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-getaccesscontrolgrouplist"
---

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

# getAccessControlGroupList

## 개요<a name="개요"></a>

접근 제어 그룹 리스트 조회

## 설명 <a name="설명"></a>

서버 인스턴스(VM)를 생성할 때 사용자가 설정한 AccessControlGroup을 넣어 방화벽 기능을 설정할 수 있습니다.
따라서 네이버 클라우드 플랫폼에서는 해당 설정에 필요한 AccessControlGroup 조회를 제공합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터 명                           | 필수   여부 | 타입         | 제약사항              | 설명                                                  |
| ------------------------------------- | ----------- | ------------ | --------------------- | ----------------------------------------------------- |
| accessControlGroupConfigurationNoList | No          | List<String> | Min:0, Max:5          | 조회할 접근 제어 그룹 설정 번호 리스트                |
| isDefault                             | No          | Boolean      |                       | 디폴트 그룹만 조회 여부                               |
| accessControlGroupName                | No          | String       | Min:3, Max:30         | 조회할 접근 제어 그룹 명                              |
| pageNo                                | No          | Integer      | Min:0, Max:2147483647 | 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호 |
| pageSize                              | No          | Integer      | Min:0, Max:2147483647 | 한 페이지에서 조회할 페이지 사이즈                    |

## 응답 데이터 타입 <a name="응답데이터타입"></a>

- AccessControlGroupList 타입

| AccessControlGroupList extends CommonResponse |
| ---------------------------------------- |
| private Integer totalRows;
| private List<AccessControlGroup> accessControlGroupList = new ArrayList<AccessControlGroup>(); |

| AccessControlGroup                                 |
| -------------------------------------------------- |
| private String accessControlGroupConfigurationNo;  |
| private String accessControlGroupName;             |
| private String accessControlGroupDescription;      |
| private Boolean isDefaultGroup;                    |
| private Date createDate;                           |

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

```
ncloud server getAccessControlGroupList --isDefault true
```

### 응답 <a name="응답"></a>

```json
{
  "getAccessControlGroupListResponse": {
    "requestId": "0c117c28-2146-45ce-9c77-bb22b72fdd84",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "accessControlGroupList": [
      {
        "accessControlGroupConfigurationNo": "1038",
        "accessControlGroupName": "ncloud-default-acg",
        "accessControlGroupDescription": "Default AccessControlGroup",
        "isDefault": true,
        "createDate": "2013-12-03T10:37:39+0900"
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8"?>
<getAccessControlGroupListResponse>
  <requestId>9e49410b-da4f-4f68-b10d-7ddedb37c3f9</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <accessControlGroupList>
    <accessControlGroup>
      <accessControlGroupConfigurationNo>4371</accessControlGroupConfigurationNo>
      <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
      <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
      <isDefault>true</isDefault>
      <createDate>2017-02-16T14:25:15+0900</createDate>
    </accessControlGroup>
  </accessControlGroupList>
</getAccessControlGroupListResponse>
```