---
title: "createCloudCacheConfigGroup"
slug: "cli-vcache-createcloudcacheconfiggroup"
tags: ["Cloud DB for Cache", "VPC"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-vcache-createcloudcacheconfiggroup"
---

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

# createCloudCacheConfigGroup

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

## 개요

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

              참고

              

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

- createCloudCacheConfigGroup CLI: Valkey, Redis DBMS 이용 가능
- createCloudRedisConfigGroup CLI: Redis DBMS 이용 가능

## createCloudCacheConfigGroup CLI

createCloudCacheConfigGroup CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String | - | - 리전 코드 Cloud DB for Cache Config Group이 생성될 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능 Default: getRegionList 조회 결과의 첫 번째 리전을 선택 |
| cloudCacheVersion | Yes | String | - 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.2.8-cluster, 7.2.8-simple, 7.2.6-cluster, 7.2.6-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 | - Cloud DB for Cache 버전 생성할 ConfigGroup의 버전과 Cloud DB for Cache의 구성 정보. 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.2.8-cluster, 7.2.8-simple, 7.2.6-cluster, 7.2.6-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이 존재합니다. ConfigGroup의 구성 정보가 생성하려는 CloudCacheModeCode와 일치해야 클러스터 생성이 가능 |
| configGroupName | Yes | String | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함 첫글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 Min: 3, Max: 15 | - 생성할 ConfigGroup의 이름 |
| configGroupDescription | No | String | Min:0, Max:255 | - ConfigGroup의 설명 최대 255자까지 가능 |
| cloudCacheDbmsCode | No | String | - | Cloud DB for Cache 인스턴스의 DBMS 코드 Options: Redis \| Valkey Default: Redis |
| output | No | String | - | - 응답 결과의 포맷 타입 Options: xml \| json Default: json |

### 응답

#### 응답 데이터 타입

- CloudCacheConfigGroupList 타입

| CloudCacheConfigGroupList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<CloudCacheConfigGroup> 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<String> cloudCacheInstanceNoList = new ArrayList<>(); |

### 예시

#### 호출

```
ncloud vcache createCloudCacheConfigGroup --regionCode KR --cloudCacheVersion 7.2.11-simple --configGroupName ***test --cloudCacheDbmsCode Valkey --configGroupDescription description
```

#### 응답

```

<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

createCloudRedisConfigGroup CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String | - | - 리전 코드 Cloud DB for Cache Config Group이 생성될 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능 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.6-cluster, 7.2.6-simple, 7.2.8-cluster, 7.2.8-simple, 7.2.11-cluster, 7.2.11-simple | - Cloud DB for Cache 버전 생성할 ConfigGroup의 버전과 Cloud DB for Cache의 구성 정보. 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.6-cluster, 7.2.6-simple, 7.2.8-cluster, 7.2.8-simple, 7.2.11-cluster, 7.2.11-simple이 존재 ConfigGroup의 구성 정보가 생성하려는 CloudRedisModeCode와 일치해야 레디스 클러스터 생성이 가능 |
| configGroupName | Yes | String | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함 첫글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 Min: 3, Max: 15 | - 생성할 ConfigGroup의 이름 |
| configGroupDescription | No | String | Min:0, Max:255 | - ConfigGroup의 설명 최대 255자까지 가능 |
| output | No | String | - | - 응답 결과의 포맷 타입 Options: xml \| json Default: json |

### 응답

#### 응답 데이터 타입

- CloudRedisConfigGroupList 타입

| CloudRedisConfigGroupList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<CloudRedisConfigGroup> 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<String> cloudRedisInstanceNoList = new ArrayList<>(); |

### 예시

#### 호출

```
ncloud vredis createCloudRedisConfigGroup --regionCode KR --cloudRedisVersion 4.0.14-cluster --configGroupName ***test --configGroupDescription description
```

#### 응답

```

<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>
```