---
title: "getCloudCacheConfigGroupList"
slug: "cli-vcache-getcloudcacheconfiggrouplist"
tags: ["Config Group", "Cloud DB for Cache"]
updated: 2026-09-17T09:10:32Z
published: 2026-09-17T09:10:32Z
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

Cloud DB for Cache Config Group 목록을 조회합니다.

              참고

              

Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.

- getCloudCacheConfigGroupList CLI: Valkey, Redis DBMS 이용 가능
- getCloudRedisConfigGroupList CLI: Redis DBMS 이용 가능

## getCloudCacheConfigGroupList CLI

getCloudCacheConfigGroupList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문

`getCloudCacheConfigGroupList` 구문은 다음과 같습니다.

```
./ncloud vcache getCloudCacheConfigGroupList \
    [--cloudCacheInstanceNo <instance-no>] \
    [--cloudCacheServiceName <service-name>] \
    [--configGroupNo <config-group-no>] \
    [--configGroupName <config-group-name>] \
    [--cloudCacheModeCode <SIMPLE|CLUSTER>] \
    [--cloudCacheDbmsCode <Redis|Valkey>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

### 옵션

`getCloudCacheConfigGroupList` 실행 시 지정할 수 있는 옵션을 설명합니다.

#### 선택 옵션

`getCloudCacheConfigGroupList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudCacheInstanceNo` | String | Optional | Cloud DB for Cache 인스턴스 번호 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--cloudCacheServiceName` | String | Optional | Cloud DB for Cache 인스턴스 이름 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--configGroupNo` | String | Optional | Config Group 번호 |
| `--configGroupName` | String | Optional | Config Group 이름 |
| `--cloudCacheModeCode` | String | Optional | Cloud DB for Cache 구성 - `SIMPLE` \| `CLUSTER` - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--cloudCacheDbmsCode` | String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드 - `Redis` \| `Valkey` |

#### 공통 옵션

`vcache` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

Config Group 목록 조회 요청이 성공하면 각 Config Group의 구성 정보가 반환됩니다.

#### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vcache getCloudCacheConfigGroupList \
    --cloudCacheInstanceNo 34567890 \
    --cloudCacheServiceName test-cache-01 \
    --configGroupNo 11099 \
    --configGroupName test-cfg-01 \
    --cloudCacheModeCode CLUSTER \
    --cloudCacheDbmsCode Valkey \
    --regionCode FKR \
    --output json
```

#### 출력

출력 예시는 다음과 같습니다.

```
{
  "getCloudCacheConfigGroupListResponse": {
    "totalRows": 1,
    "cloudCacheConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "configGroupDescription": "Test cluster config group",
        "configGroupStatusName": "running",
        "configGroupStatus": {
          "code": "RUN",
          "codeName": "CONFIG GROUP Running 상태"
        },
        "cloudCacheVersion": "7.2.11-cluster",
        "cloudCacheDbmsCode": "Valkey",
        "createDate": "2026-06-22T14:00:32+0900",
        "modifyDate": "2026-06-22T14:00:35+0900",
        "cloudCacheInstanceNoList": [
          "141673651"
        ]
      }
    ],
    "requestId": "cca79bd4-1b4a-4956-a525-310333a76e8c",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

## getCloudRedisConfigGroupList CLI

getCloudRedisConfigGroupList CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

### 구문

`getCloudRedisConfigGroupList` 구문은 다음과 같습니다.

```
./ncloud vredis getCloudRedisConfigGroupList \
    [--cloudRedisInstanceNo <instance-no>] \
    [--cloudRedisServiceName <service-name>] \
    [--configGroupNo <config-group-no>] \
    [--configGroupName <config-group-name>] \
    [--cloudRedisModeCode <SIMPLE|CLUSTER>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

### 옵션

`getCloudRedisConfigGroupList` 실행 시 지정할 수 있는 옵션을 설명합니다.

#### 선택 옵션

`getCloudRedisConfigGroupList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudRedisInstanceNo` | String | Optional | Cloud DB for Cache 인스턴스 번호 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--cloudRedisServiceName` | String | Optional | Cloud DB for Cache 인스턴스 이름 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--configGroupNo` | String | Optional | Config Group 번호 |
| `--configGroupName` | String | Optional | Config Group 이름 |
| `--cloudRedisModeCode` | String | Optional | Cloud DB for Cache 구성 - `SIMPLE` \| `CLUSTER` - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |

#### 공통 옵션

`vredis` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

Config Group 목록 조회 요청이 성공하면 각 Config Group의 구성 정보가 반환됩니다.

#### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vredis getCloudRedisConfigGroupList \
    --cloudRedisInstanceNo 34567890 \
    --cloudRedisServiceName test-cache-01 \
    --configGroupNo 11099 \
    --configGroupName test-cfg-01 \
    --cloudRedisModeCode CLUSTER \
    --regionCode FKR \
    --output json
```

#### 출력

출력 예시는 다음과 같습니다.

```
{
  "getCloudRedisConfigGroupListResponse": {
    "totalRows": 1,
    "cloudRedisConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "configGroupDescription": "Test cluster config group",
        "configGroupStatusName": "running",
        "configGroupStatus": {
          "code": "RUN",
          "codeName": "CONFIG GROUP Running 상태"
        },
        "cloudRedisVersion": "4.0.14-cluster",
        "createDate": "2026-06-10T14:45:32+0900",
        "modifyDate": "2026-06-10T14:45:35+0900",
        "cloudRedisInstanceNoList": [
          "34567890"
        ]
      }
    ],
    "requestId": "96bceb85-b1b8-4c6c-bacb-7207a1890af8",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```