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 <config-group-name> \
--cloudCacheVersion <cache-version> \
[--configGroupDescription <config-group-description>] \
[--cloudCacheDbmsCode <Redis|Valkey>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudCacheConfigGroup 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudCacheConfigGroup의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--configGroupName |
String | Required | Config Group 서비스 이름
|
--cloudCacheVersion |
String | Required | Config Group의 버전과 Cloud DB for Cache의 구성 정보
|
선택 옵션
createCloudCacheConfigGroup의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--configGroupDescription |
String | Optional | Config Group에 대한 설명
|
--cloudCacheDbmsCode |
String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드
|
공통 옵션
vcache 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
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 <config-group-name> \
--cloudRedisVersion <redis-version> \
[--configGroupDescription <config-group-description>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudRedisConfigGroup 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudRedisConfigGroup의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--configGroupName |
String | Required | Config Group 서비스 이름
|
--cloudRedisVersion |
String | Required | Cloud DB for Cache 버전
|
선택 옵션
createCloudRedisConfigGroup의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--configGroupDescription |
String | Optional | Config Group에 대한 설명
|
공통 옵션
vredis 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
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"
}
}