---
title: "createCloudCacheConfigGroup"
slug: "cli-vcache-createcloudcacheconfiggroup"
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-createcloudcacheconfiggroup"
---

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

# createCloudCacheConfigGroup

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

Cloud DB for Cache Config Group을 생성합니다.

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

## createCloudCacheConfigGroup CLI<a name="createCloudCacheConfigGroup CLI"></a> 
createCloudCacheConfigGroup 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 조회 결과의 첫 번째 리전을 선택|
| cloudCacheVersion      | Yes   | String | <ul><li>Valkey: 8.1.6-cluster, 8.1.6-simple,7.2.11-cluster, 7.2.11-simple</li><li>Redis: 7.2.11-cluster, 7.2.11-simple, 7.0.15-cluster, 7.0.15-simple, 7.0.13-cluster, 7.0.13-simple, 5.0.14-cluster, 5.0.14-simple, 4.0.14-cluster, 4.0.14-simple</li></ul>          | - Cloud DB for Cache 버전<br> 생성할 ConfigGroup의 버전과 Cloud DB for Cache의 구성 정보. <br>Valkey: 8.1.6-cluster, 8.1.6-simple,7.2.11-cluster, 7.2.11-simple / Redis: 7.2.11-cluster, 7.2.11-simple, 7.0.15-cluster, 7.0.15-simple, 7.0.13-cluster, 7.0.13-simple, 5.0.14-cluster, 5.0.14-simple, 4.0.14-cluster, 4.0.14-simple이 존재합니다. <br> ConfigGroup의 구성 정보가 생성하려는 CloudCacheModeCode와 일치해야 클러스터 생성이 가능 | 
| configGroupName        | Yes   | String | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함<br>첫글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 <br>Min: 3, Max: 15 | - 생성할 ConfigGroup의 이름 |
| configGroupDescription | No    | String | Min:0, Max:255  | - ConfigGroup의 설명<br> 최대 255자까지 가능 |
| cloudCacheDbmsCode | No | String | | Cloud DB for Cache 인스턴스의 DBMS 코드 <br/> Options: Redis \| Valkey <br/> Default: Redis |
| 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 createCloudCacheConfigGroup --regionCode FKR --cloudCacheVersion 7.2.11-simple --configGroupName ***test --cloudCacheDbmsCode Valkey --configGroupDescription description
```

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

```xml

<createCloudCacheConfigGroup>
    <requestId>3c47b66a-222d-4ab1-a995-48097920fa92</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheConfigGroupList>
        <cloudCacheConfigGroup>
            <configGroupNo>**9</configGroupNo>
            <configGroupName>***test</configGroupName>
            <configGroupDescription>description</configGroupDescription>
            <configGroupStatusName>settingUp</configGroupStatusName>
            <configGroupStatus>
                <code>SETUP</code>
                <codeName>CONFIG GROUP Setup State</codeName>
            </configGroupStatus>
            <cloudCacheVersion>7.2.11-simple</cloudCacheVersion>
            <cloudCacheDbmsCode>Valkey</cloudCacheDbmsCode>
            <createDate>2025-05-12T22:44:56+0900</createDate>
            <modifyDate>2025-05-12T22:44:56+0900</modifyDate>
        </cloudCacheConfigGroup>
    </cloudCacheConfigGroupList>
</createCloudCacheConfigGroup>
```

## createCloudRedisConfigGroup CLI<a name="createCloudRedisConfigGroup CLI"></a> 
createCloudRedisConfigGroup 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 조회 결과의 첫 번째 리전을 선택                |
| cloudRedisVersion      | Yes   | String | 4.0.14-cluster, 4.0.14-simple, 5.0.14-cluster, 5.0.14-simple, 7.0.13-cluster, 7.0.13-simple, 7.0.15-cluster, 7.0.15-simple, 7.2.11-cluster, 7.2.11-simple                                | - Cloud DB for Cache 버전<br> 생성할 ConfigGroup의 버전과 Cloud DB for Cache의 구성 정보. <br>4.0.14-cluster, 4.0.14-simple, 5.0.14-cluster, 5.0.14-simple, 7.0.13-cluster, 7.0.13-simple, 7.0.15-cluster, 7.0.15-simple, 7.2.11-cluster, 7.2.11-simple이 존재 <br> ConfigGroup의 구성 정보가 생성하려는 CloudRedisModeCode와 일치해야 레디스 클러스터 생성이 가능 | 
| configGroupName        | Yes   | String | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함<br>첫글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 <br>Min: 3, Max:15 | - 생성할 ConfigGroup의 이름                                                                                                                                                                                                       |
| configGroupDescription | No    | String | Min:0, Max:255                                                                              | - ConfigGroup의 설명<br> 최대 255자까지 가능                                                                                                                                                                                         |
| 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 createCloudRedisConfigGroup --regionCode FKR --cloudRedisVersion 4.0.14-cluster --configGroupName ***test --configGroupDescription description
```

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

```xml

<createCloudRedisConfigGroup>
    <requestId>3c47b66a-222d-4ab1-a995-48097920fa92</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisConfigGroupList>
        <cloudRedisConfigGroup>
            <configGroupNo>**9</configGroupNo>
            <configGroupName>***test</configGroupName>
            <configGroupDescription>description</configGroupDescription>
            <configGroupStatusName>settingUp</configGroupStatusName>
            <configGroupStatus>
                <code>SETUP</code>
                <codeName>CONFIG GROUP Setup State</codeName>
            </configGroupStatus>
            <createDate>2021-05-12T22:44:56+0900</createDate>
            <modifyDate>2021-05-12T22:44:56+0900</modifyDate>
        </cloudRedisConfigGroup>
    </cloudRedisConfigGroupList>
</createCloudRedisConfigGroup>
```