---
title: "getCloudCacheConfigGroupList"
slug: "cli-vcache-getcloudcacheconfiggrouplist"
tags: ["Cloud DB for Cache", "Config Group"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
canonical: "cli-fin.ncloud-docs.com/cli-vcache-getcloudcacheconfiggrouplist"
---

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

# getCloudCacheConfigGroupList

## 개요<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 FKR --cloudCacheInstanceNo ****821 --cloudCacheServiceName ***test --configGroupNo ***9 --configGroupName test-****-config --cloudCacheModeCode SIMPLE --cloudCacheDbmsCode Valkey
```

#### 응답<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 FKR --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>
```