---
title: "getCloudCacheConfigGroupList"
slug: "cli-vcache-getcloudcacheconfiggrouplist"
tags: ["Cloud DB for Cache", "VPC"]
updated: 2026-04-23T08:57:06Z
published: 2026-04-23T08:58:56Z
canonical: "cli.ncloud-docs.com/cli-vcache-getcloudcacheconfiggrouplist"
---

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

# getCloudCacheConfigGroupList

<p class="platform-info type-vpc">VPC 환경에서 이용 가능</p>

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

Cloud DB for Cache Config group 리스트를 조회합니다.

:::(info) (참고)
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
* getCloudCacheConfigGroupList CLI: Valkey, Redis DBMS 이용 가능
* getCloudRedisConfigGroupList CLI: Redis DBMS 이용 가능
:::


## getCloudCacheConfigGroupList CLI<a name="getCloudCacheConfigGroupList CLI"></a> 
getCloudCacheConfigGroupList CLI의 요청, 응답 형식을 설명합니다.

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

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

| 파라미터명                 | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                               |
|-----------------------|-------|--------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode            | No    | String |       | - 리전 코드<br/>Cloud DB for Cache Config Group 리스트가 조회될 리전(Region)을 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default: getRegionList 조회 결과의 첫 번째 리전 선택 |
| cloudCacheInstanceNo  | No    | String |       | - 조회할 ConfigGroup이 적용된 Cloud DB for Cache 인스턴스 번호<br/>cloudCacheInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                                |
| cloudCacheServiceName | No    | String |       | - 조회할 ConfigGroup이 적용된 Cloud DB for Cache 서비스 이름<br/>cloudCacheServiceName는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                                |
| configGroupNo         | No    | String |       | - 조회할 ConfigGroup 번호<br/>configGroupNo는 [getCloudCacheConfigGroupList](/docs/cli-vcache-getcloudcacheconfiggrouplist) 액션을 통해서 획득 가능                                                                              |
| configGroupName       | No    | String |       | - 조회할 ConfigGroup 이름<br/>configGroupName는 [getCloudCacheConfigGroupList](/docs/cli-vcache-getcloudcacheconfiggrouplist) 액션을 통해서 획득 가능                                                                            |
| cloudCacheModeCode    | No    | String |       | - Cloud DB for Cache 구성<br/> 조회할 ConfigGroup이 적용된 Cloud DB for Cache의 구성.<br/>cloudCacheModeCode는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능 <br/>Options : SIMPLE \| CLUSTER    |
| cloudCacheDbmsCode | String | Optional | | Cloud DB for Cache 인스턴스의 DBMS 코드 <br/> Options: Redis \| Valkey |
| output                | No    | String |       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                                                                                        |

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

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

- CloudCacheConfigGroupList 타입

| CloudCacheConfigGroupList extends CommonResponse                                         |
|------------------------------------------------------------------------------------------|
| private Integer totalRows;                                                               |
| private List&lt;CloudCacheConfigGroup&gt; cloudCacheConfigGroupList = new ArrayList<>(); |

| CloudCacheConfigGroup                                      |
|------------------------------------------------------------|
| private String configGroupNo;                              |
| private String configGroupName;                            |
| private String configGroupDescription;                     |
| private String configGroupStatusName;                      |
| private CommonCode configGroupStatus;                      |
| private String cloudCacheVersion;                          |
| private String cloudCacheDbmsCode; |
| private Date createDate;                                   |
| private Date modifyDate;                                   |
| private CloudCacheInstanceNoList cloudCacheInstanceNoList; |

| CloudCacheInstanceNoList                                                 |
|--------------------------------------------------------------------------|
| private List&lt;String&gt; cloudCacheInstanceNoList = new ArrayList<>(); |

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

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

```
ncloud vcache getCloudCacheConfigGroupList --regionCode KR --cloudCacheInstanceNo ****821 --cloudCacheServiceName ***test --configGroupNo ***9 --configGroupName test-****-config --cloudCacheModeCode SIMPLE
```

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

```xml

<getCloudCacheConfigGroupListResponse>
    <requestId>06a7bbf2-a576-4521-bdf4-392711e31560</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheConfigGroupList>
        <cloudCacheConfigGroup>
            <configGroupNo>**9</configGroupNo>
            <configGroupName>exercise</configGroupName>
            <configGroupDescription>description</configGroupDescription>
            <configGroupStatusName>running</configGroupStatusName>
            <configGroupStatus>
                <code>RUN</code>
                <codeName>CONFIG GROUP Running State</codeName>
            </configGroupStatus>
            <cloudCacheVersion>7.2.11-simple</cloudCacheVersion>
            <cloudCacheDbmsCode>Valkey</cloudCacheDbmsCode>
            <createDate>2020-11-26T13:47:27+0900</createDate>
            <modifyDate>2020-11-26T13:47:27+0900</modifyDate>
            <cloudCacheInstanceNoList>
                <cloudCacheInstanceNo>****821</cloudCacheInstanceNo>
            </cloudCacheInstanceNoList>
        </cloudCacheConfigGroup>
    </cloudCacheConfigGroupList>
</getCloudCacheConfigGroupListResponse>
```

## getCloudRedisConfigGroupList CLI<a name="getCloudRedisConfigGroupList CLI"></a> 
getCloudRedisConfigGroupList CLI의 요청, 응답 형식을 설명합니다.

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

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

| 파라미터명                      | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                               |
|----------------------------|-------|--------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No    | String |       | - 리전 코드<br/>Cloud DB for Cache Config Group 리스트가 조회될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default: getRegionList 조회 결과의 첫 번째 리전을 선택 |
| cloudRedisInstanceNo       | No    | String |       | - 조회할 ConfigGroup이 적용된 Cloud DB for Cache 인스턴스 번호<br/>cloudRedisInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                                |
| cloudRedisServiceName      | No    | String |       | - 조회할 ConfigGroup이 적용된 Cloud DB for Cache 인스턴스 이름<br/>cloudRedisServiceName는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능                                               |
| configGroupNo              | No    | String |       | - 조회할 ConfigGroup 번호<br/>configGroupNo는 [getCloudCacheConfigGroupList](/docs/cli-vcache-getcloudcacheconfiggrouplist) 액션을 통해서 획득 가능                                                                              |
| configGroupName            | No    | String |       | - 조회할 ConfigGroup 이름<br/>configGroupName는 [getCloudCacheConfigGroupList](/docs/cli-vcache-getcloudcacheconfiggrouplist) 액션을 통해서 획득 가능                                                                            |
| cloudRedisModeCode         | No    | String |       | - Cloud DB for Cache 구성<br/> 조회할 ConfigGroup이 적용된 Cloud DB for Cache의 구성<br/>CLUSTER, SIMPLE<br/>cloudRedisModeCode는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능   |
| output                     | No    | String |       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                                                                                        |

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

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

- CloudRedisConfigGroupList 타입

| CloudRedisConfigGroupList extends CommonResponse                                         |
|------------------------------------------------------------------------------------------|
| private Integer totalRows;                                                               |
| private List&lt;CloudRedisConfigGroup&gt; cloudRedisConfigGroupList = new ArrayList<>(); |

| CloudRedisConfigGroup                                      |
|------------------------------------------------------------|
| private String configGroupNo;                              |
| private String configGroupName;                            |
| private String configGroupDescription;                     |
| private String configGroupStatusName;                      |
| private CommonCode configGroupStatus;                      |
| private String cloudRedisVersion;                          |
| private Date createDate;                                   |
| private Date modifyDate;                                   |
| private CloudRedisInstanceNoList cloudRedisInstanceNoList; |

| CloudRedisInstanceNoList                                                 |
|--------------------------------------------------------------------------|
| private List&lt;String&gt; cloudRedisInstanceNoList = new ArrayList<>(); |

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

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

```
ncloud vredis getCloudRedisConfigGroupList --regionCode KR --cloudRedisInstanceNo ****821 --cloudRedisServiceName ***test --configGroupNo ***9 --configGroupName test-****-config --cloudRedisModeCode CLUSTER
```

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

```xml


<getCloudRedisConfigGroupListResponse>
    <requestId>96bceb85-b1b8-4c6c-bacb-7207a1890af8</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisConfigGroupList>
        <cloudRedisConfigGroup>
            <configGroupNo>**9</configGroupNo>
            <configGroupName>exercise</configGroupName>
            <configGroupDescription>practice</configGroupDescription>
            <configGroupStatusName>running</configGroupStatusName>
            <configGroupStatus>
                <code>RUN</code>
                <codeName>CONFIG GROUP Running State</codeName>
            </configGroupStatus>
            <cloudRedisVersion>4.0.14-cluster</cloudRedisVersion>
            <createDate>2020-11-26T13:47:27+0900</createDate>
            <modifyDate>2020-11-26T13:47:27+0900</modifyDate>
            <cloudRedisInstanceNoList>
                <cloudRedisInstanceNo>****821</cloudRedisInstanceNo>
            </cloudRedisInstanceNoList>
        </cloudRedisConfigGroup>
    </cloudRedisConfigGroupList>
</getCloudRedisConfigGroupListResponse>
```