--- title: "createCloudCacheConfigGroup" slug: "cli-vcache-createcloudcacheconfiggroup" tags: ["Cloud DB for Cache", "Config Group"] updated: 2026-09-17T09:10:32Z published: 2026-09-17T09:10:32Z 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 Cloud DB for Cache Config Group을 생성합니다. Config Group에서는 생성한 Cache Server를 그룹핑하여 그룹에 속한 서버들에 동일한 설정값을 지정하여 효율적으로 관리할 수 있습니다. 참고 Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다. - createCloudCacheConfigGroup CLI: Valkey, Redis DBMS 이용 가능 - createCloudRedisConfigGroup CLI: Redis DBMS 이용 가능 ## createCloudCacheConfigGroup CLI createCloudCacheConfigGroup CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다. ### 구문 `createCloudCacheConfigGroup` 구문은 다음과 같습니다. ``` ./ncloud vcache createCloudCacheConfigGroup \ --configGroupName \ --cloudCacheVersion \ [--configGroupDescription ] \ [--cloudCacheDbmsCode ] \ [--regionCode ] \ [--output ] ``` ### 옵션 `createCloudCacheConfigGroup` 실행 시 지정할 수 있는 옵션을 설명합니다. #### 필수 옵션 `createCloudCacheConfigGroup`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--configGroupName` | String | Required | Config Group 서비스 이름 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~15자 이내로 입력 - 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성 | | `--cloudCacheVersion` | String | Required | Config Group의 버전과 Cloud DB for Cache의 구성 정보 - `7.2.11-cluster` \| `7.2.11-simple` - Config Group의 구성 정보와 DB Server의 타입(Cluster/Simple)이 일치해야 Cache 클러스터 생성 가능 - [getCloudCacheConfigGroupVersionList](/docs/cli-vcache-getcloudcacheconfiggroupversionlist) 참조 | #### 선택 옵션 `createCloudCacheConfigGroup`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--configGroupDescription` | String | Optional | Config Group에 대한 설명 - 0~255자 이내로 입력 | | `--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 createCloudCacheConfigGroup \ --configGroupName test-cfg-01 \ --cloudCacheVersion 7.2.11-cluster \ --configGroupDescription "Test cluster config group" \ --cloudCacheDbmsCode Valkey \ --regionCode FKR \ --output json ``` #### 출력 출력 예시는 다음과 같습니다. ``` { "createCloudCacheConfigGroupResponse": { "totalRows": 1, "cloudCacheConfigGroupList": [ { "configGroupNo": "12345", "configGroupName": "test-cfg-01", "configGroupDescription": "Test cluster config group", "configGroupStatusName": "settingUp", "configGroupStatus": { "code": "SETUP", "codeName": "CONFIG GROUP Setup 상태" }, "cloudCacheVersion": "7.2.11-cluster", "cloudCacheDbmsCode": "Valkey", "createDate": "2026-06-22T14:00:32+0900", "modifyDate": "2026-06-22T14:00:32+0900" } ], "requestId": "2e297067-c3da-4438-bdeb-fe11f3fe4992", "returnCode": "0", "returnMessage": "success" } } ``` ## createCloudRedisConfigGroup CLI createCloudRedisConfigGroup CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다. ### 구문 `createCloudRedisConfigGroup` 구문은 다음과 같습니다. ``` ./ncloud vredis createCloudRedisConfigGroup \ --configGroupName \ --cloudRedisVersion \ [--configGroupDescription ] \ [--regionCode ] \ [--output ] ``` ### 옵션 `createCloudRedisConfigGroup` 실행 시 지정할 수 있는 옵션을 설명합니다. #### 필수 옵션 `createCloudRedisConfigGroup`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--configGroupName` | String | Required | Config Group 서비스 이름 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~15자 이내로 입력 - 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성 | | `--cloudRedisVersion` | String | Required | Cloud DB for Cache 버전 - `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` - Config Group의 구성 정보와 DB Server의 타입(Cluster/Simple)이 일치해야 레디스 클러스터 생성 가능 - [getCloudCacheConfigGroupVersionList](/docs/cli-vcache-getcloudcacheconfiggroupversionlist) 참조 | #### 선택 옵션 `createCloudRedisConfigGroup`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--configGroupDescription` | String | Optional | Config Group에 대한 설명 - 0~255자 이내로 입력 | #### 공통 옵션 `vredis` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오. ### 예시 Config Group 생성 요청이 성공하면 Config Group의 구성 정보와 생성 상태가 반환됩니다. #### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vredis createCloudRedisConfigGroup \ --configGroupName test-cfg-01 \ --cloudRedisVersion 7.2.11-cluster \ --configGroupDescription "Test cluster config group" \ --regionCode FKR \ --output json ``` #### 출력 출력 예시는 다음과 같습니다. ``` { "createCloudRedisConfigGroupResponse": { "totalRows": 1, "cloudRedisConfigGroupList": [ { "configGroupNo": "34567890", "configGroupName": "test-cfg-01", "configGroupDescription": "Test cluster config group", "configGroupStatusName": "settingUp", "configGroupStatus": { "code": "SETUP", "codeName": "CONFIG GROUP Setup 상태" }, "cloudRedisVersion": "7.2.11-cluster", "createDate": "2026-06-25T16:23:54+0900", "modifyDate": "2026-06-25T16:23:54+0900" } ], "requestId": "a22f6411-11ba-4e1b-9944-3f237548edd9", "returnCode": "0", "returnMessage": "success" } } ```