createCloudCacheConfigGroup

Prev Next

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

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 <KR|KRS>] \
    [--output <json|xml>]

옵션

createCloudCacheConfigGroup 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudCacheConfigGroup의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--configGroupName String Required Config Group 서비스 이름
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성
--cloudCacheVersion String Required Config Group의 버전과 Cloud DB for Cache의 구성 정보

선택 옵션

createCloudCacheConfigGroup의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--configGroupDescription String Optional Config Group에 대한 설명
  • 0~255자 이내로 입력
--cloudCacheDbmsCode String Optional Cloud DB for Cache 인스턴스의 DBMS 코드
  • Redis (기본값) | Valkey

공통 옵션

vcache 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.

예시

Config Group 생성 요청이 성공하면 Config Group의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vcache createCloudCacheConfigGroup \
    --configGroupName test-cfg-01 \
    --cloudCacheVersion 7.2.11-simple \
    --configGroupDescription "Test simple config group" \
    --cloudCacheDbmsCode Valkey \
    --regionCode KR \
    --output json

출력

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

{
  "createCloudCacheConfigGroupResponse": {
    "totalRows": 1,
    "cloudCacheConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "configGroupDescription": "Test simple config group",
        "configGroupStatusName": "settingUp",
        "configGroupStatus": {
          "code": "SETUP",
          "codeName": "CONFIG GROUP Setup 상태"
        },
        "cloudCacheVersion": "7.2.11-simple",
        "cloudCacheDbmsCode": "Valkey",
        "createDate": "2026-06-30T15:18:25+0900",
        "modifyDate": "2026-06-30T15:18:25+0900"
      }
    ],
    "requestId": "a91e506b-8234-476a-831f-fb20f113272a",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

createCloudRedisConfigGroup CLI

createCloudRedisConfigGroup CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.

구문

createCloudRedisConfigGroup 구문은 다음과 같습니다.

./ncloud vredis createCloudRedisConfigGroup \
    --configGroupName <config-group-name> \
    --cloudRedisVersion <redis-version> \
    [--configGroupDescription <config-group-description>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

createCloudRedisConfigGroup 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudRedisConfigGroup의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--configGroupName String Required Config Group 서비스 이름
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성
--cloudRedisVersion String Required Cloud DB for Cache 버전

선택 옵션

createCloudRedisConfigGroup의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--configGroupDescription String Optional Config Group에 대한 설명
  • 0~255자 이내로 입력

공통 옵션

vredis 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.

예시

Config Group 생성 요청이 성공하면 Config Group의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vredis createCloudRedisConfigGroup \
    --configGroupName test-cfg-02 \
    --cloudRedisVersion 7.2.11-simple \
    --configGroupDescription "Test simple config group" \
    --regionCode KR \
    --output json

출력

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

{
  "createCloudRedisConfigGroupResponse": {
    "totalRows": 1,
    "cloudRedisConfigGroupList": [
      {
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-02",
        "configGroupDescription": "Test simple config group",
        "configGroupStatusName": "settingUp",
        "configGroupStatus": {
          "code": "SETUP",
          "codeName": "CONFIG GROUP Setup 상태"
        },
        "cloudRedisVersion": "7.2.11-simple",
        "createDate": "2026-06-30T15:20:38+0900",
        "modifyDate": "2026-06-30T15:20:38+0900"
      }
    ],
    "requestId": "d7da4530-24e8-4eba-b1e2-f2f4b525bd7c",
    "returnCode": "0",
    "returnMessage": "success"
  }
}