---
title: "getAccessControlGroupList "
slug: "cli-server-getaccesscontrolgrouplist"
updated: 2026-09-17T10:11:03Z
published: 2026-09-17T10:11:03Z
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 

## 概要

アクセス制御グループリスト照会

## 説明

サーバインスタンス(VM)を作成する時、ユーザーが設定したAccessControlGroupを入れてファイアウォール機能を設定できます。 従って、Naverクラウドプラットフォームでは該当設定に必要なAccessControlGroup照会を提供します。

## リクエストパラメータ

| パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| accessControlGroupConfigurationNoList | No | List | Min:0, Max:5 | 照会するアクセス制御グループ設定番号リスト |
| isDefault | No | Boolean |  | デフォルトグループのみ照会するかに対する区分 |
| accessControlGroupName | No | String | Min:3, Max:30 | 照会するアクセス制御グループ名 |
| pageNo | No | Integer | Min:0, Max:2147483647 | 件数が多い場合、ページサイズに該当するページ番号 |
|  | No | Integer | Min:0, Max:2147483647 | 一つのページで照会するページサイズ |

## レスポンスデータタイプ

- AccessControlGroupListタイプ

| AccessControlGroupList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<accesscontrolgroup data-tomark-pass=""> accessControlGroupList = new ArrayList<accesscontrolgroup data-tomark-pass="">();</accesscontrolgroup></accesscontrolgroup> |

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

## 例示

### 呼び出し

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

### レスポンス

```
{
  "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 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>
```