---
title: "getAccessControlGroupList"
slug: "compute-server-getaccesscontrolgrouplist"
updated: 2026-09-17T09:57:42Z
published: 2026-09-17T09:57:42Z
canonical: "api.ncloud-docs.com/compute-server-getaccesscontrolgrouplist"
---

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

# getAccessControlGroupList

## 概要

サーバインスタンス(VM)を作成する際に、ユーザーが設定し たAccess Control Groupを入れてファイアウォール機能を設定できます。この APIはユーザーの AccessControlGroupを照会します。

## リクエスト

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

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| accessControlGroupConfigurationNoList.N | No | List<String> | 最小: 0, 最大: 5 | 照会対象のアクセス制御グループ設定番号リスト |
| isDefaultGroup | No | Boolean |  | デフォルトグループのみ照会できる オプション: true \| false |
| accessControlGroupName | No | String | 最小: 3, 最大: 30 | 照会対象のアクセス制御グループ名 |
| pageNo | No | Integer | 最小: 0, 最大: 2147483647 | - ページングされた結果のページ番号 結果値は pageNoを利用してページング処理できる |
| pageSize | No | Integer | 最小: 0, 最大: 2147483647 | - ページング時に表示する各ページサイズ 結果値は pageSizeを利用してページング処理できる |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [AccessControlGroupList](/docs/ja/common-apidatatype-accesscontrolgroup)

## 例

### リクエスト例

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