---
title: "getCloudCacheConfigGroupList"
slug: "cli-vcache-getcloudcacheconfiggrouplist"
tags: ["Cloud DB for Cache"]
updated: 2026-10-22T09:07:19Z
published: 2026-10-22T09:07:19Z
canonical: "cli-gov.ncloud-docs.com/cli-vcache-getcloudcacheconfiggrouplist"
---

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

# getCloudCacheConfigGroupList

VPC 환경에서 이용 가능합니다.

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>] \
    [--cloudCacheDbmsCode <Redis|Valkey>] \
    [--regionCode <KR|KRS>] \
    [--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` - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |
| `--cloudCacheDbmsCode` | String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드 - `Redis` \| `Valkey` |

#### 공통 옵션

`vcache` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/database-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 SIMPLE \
    --cloudCacheDbmsCode Valkey \
    --regionCode KR \
    --output json
```

#### 출력

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

```
{
  "getCloudCacheConfigGroupListResponse": {
    "totalRows": 1,
    "cloudCacheConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "configGroupDescription": "Test simple config group",
        "configGroupStatusName": "running",
        "configGroupStatus": {
          "code": "RUN",
          "codeName": "CONFIG GROUP Running 상태"
        },
        "cloudCacheVersion": "8.1.6-simple",
        "cloudCacheDbmsCode": "Valkey",
        "createDate": "2026-06-30T15:34:29+0900",
        "modifyDate": "2026-06-30T15:34:31+0900",
        "cloudCacheInstanceNoList": [
          "34567890"
        ]
      }
    ],
    "requestId": "f2ff1c78-c72b-4401-8609-faf233706e76",
    "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>] \
    [--regionCode <KR|KRS>] \
    [--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` - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |

#### 공통 옵션

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

### 예시

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

#### 명령

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

```
./ncloud vredis getCloudRedisConfigGroupList \
    --cloudRedisInstanceNo 34567890 \
    --cloudRedisServiceName test-redis-01 \
    --configGroupNo 11099 \
    --configGroupName test-cfg-01 \
    --cloudRedisModeCode SIMPLE \
    --regionCode KR \
    --output json
```

#### 출력

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

```
{
  "getCloudRedisConfigGroupListResponse": {
    "totalRows": 1,
    "cloudRedisConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "configGroupDescription": "Test simple config group",
        "configGroupStatusName": "running",
        "configGroupStatus": {
          "code": "RUN",
          "codeName": "CONFIG GROUP Running 상태"
        },
        "cloudRedisVersion": "7.2.11-simple",
        "createDate": "2026-06-30T15:20:38+0900",
        "modifyDate": "2026-06-30T15:20:40+0900",
        "cloudRedisInstanceNoList": [
          "34567890"
        ]
      }
    ],
    "requestId": "54a2d2dc-f78a-4921-9998-8379c1058cec",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```