Press CTRL+K to open search

createCloudCacheInstance

Prev Next

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

Cloud DB for Cache 인스턴스를 생성합니다.

참고

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

  • createCloudCacheInstance CLI: Valkey, Redis DBMS 이용 가능
  • createCloudRedisInstance CLI: Redis DBMS 이용 가능

createCloudCacheInstance CLI

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

구문

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

./ncloud vcache createCloudCacheInstance \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --cloudCacheServiceName <service-name> \
    --cloudCacheServerNamePrefix <server-name-prefix> \
    --cloudCacheUserName <user-name> \
    --cloudCacheUserPassword <password> \
    --configGroupNo <config-group-no> \
    --cloudCacheModeCode <SIMPLE> \
    [--cloudCacheImageProductCode <image-product-code>] \
    [--cloudCacheProductCode <product-code>] \
    [--engineVersionCode <engine-version-code>] \
    [--isHa <true|false>] \
    [--isBackup <true|false>] \
    [--isAutomaticBackup <true|false>] \
    [--backupTime <hh:mm>] \
    [--backupFileRetentionPeriod <retention-days>] \
    [--cloudCachePort <port>] \
    [--cloudCacheDbmsCode <Redis|Valkey>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createCloudCacheInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--vpcNo String Required Cloud DB for Cache 인스턴스를 생성할 VPC 번호
--subnetNo String Required Cloud DB for Cache 인스턴스의 Subnet 번호
--cloudCacheServiceName String Required Cloud DB for Cache 서비스 이름
  • 영문자, 한글, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • DB 서비스 이름은 중복으로 사용 불가
--cloudCacheServerNamePrefix String Required Cloud DB for Cache 서버 이름 접두사
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성
  • 접두사 뒤에 3자리 숫자가 자동으로 생성됨
  • DB 서버 이름은 중복으로 사용 불가
--cloudCacheUserName String Required DB User 계정 ID
  • 영문자, 숫자, 특수문자 _ -를 조합하여 4~16자 이내로 입력
  • 문자열은 영문자로 시작
--cloudCacheUserPassword String Required DB User 계정 비밀번호
  • 영문자, 숫자, 특수문자를 각 1자 이상씩 포함하여 9~20자 이내로 입력
  • 특수문자 ` & + \ " ' / ^ > 및 공백 사용 불가
--configGroupNo String Required Config Group 번호
  • DB Server 설정을 효율적으로 관리하기 위한 Config Group을 제공하며, 하나의 클러스터군은 모두 같은 config를 사용함
  • Config Group이 없는 경우, 새로 생성해야 하며, 생성 후에도 온라인으로 변경 가능
  • DB 서버의 타입(Simple) 및 Cache 엔진 버전 정보와 일치하는 Config Group 번호 입력
    • 예시: DB Server 타입이 Simple이고 엔진 버전이 8.1.6인 경우, cacheVersion이 8.1.6-simple에 해당하는 configGroupNo 입력
  • getCloudCacheConfigGroupList 참조
--cloudCacheModeCode String Required Cloud DB for Cache 모드
  • SIMPLE
    • SIMPLE: Master, Standby-Master 방식을 사용하는 기본 Cache
--backupTime String Conditional 백업 시점 설정 (HH:MM)
  • isBackup=true이고 isAutomaticBackup=false인 경우, 필수 입력
  • 예시: 01:15 (선택한 시간 + 15분 사이에 백업 시작)

선택 옵션

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

옵션 타입 필수 여부 설명
--cloudCacheImageProductCode String Optional Cloud DB for Cache 이미지 상품 코드
--cloudCacheProductCode String Optional Cloud DB for Cache 상품 코드
  • Cloud DB for Cache 인스턴스의 서버 스펙 결정
  • 기본값: 최소 사양 (메모리, CPU 순)
  • getCloudCacheProductList 참조
--engineVersionCode String Optional DB 엔진 버전
--isHa Boolean Optional 고가용성 여부
  • true | false (기본값)
  • 고가용성 선택 시 Standby Master 서버를 이용한 자동 장애 복구를 지원하며, 추가 요금 발생 및 자동으로 백업이 설정됨
--isBackup Boolean Optional DB Server의 백업 설정 여부
  • true | false (기본값)
  • isHa=true인 경우, true로 고정됨
--isAutomaticBackup Boolean Optional 백업 시점 자동 설정 여부
  • true (기본값) | false
  • true인 경우, backupTime이 입력되어도 무시하고 자동으로 설정됨
--backupFileRetentionPeriod Integer Optional 백업 파일 보관 기간 (일)
  • 1~7 (기본값: 1)
  • 백업은 매일 수행되며, 백업 파일은 별도의 백업 스토리지에 저장
  • 요금은 사용하는 공간만큼만 과금
--cloudCachePort Integer Optional Cloud DB for Cache 인스턴스에 접근하기 위한 TCP 포트 번호
  • 10000~20000 (기본값: 6379)
--cloudCacheDbmsCode String Optional Cloud DB for Cache 인스턴스의 DBMS 코드
  • Redis (기본값) | Valkey

공통 옵션

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

예시

Cloud DB for Cache 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vcache createCloudCacheInstance \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --cloudCacheServiceName test-cache-01 \
    --cloudCacheServerNamePrefix testcache \
    --cloudCacheUserName testuser \
    --cloudCacheUserPassword Examplepw123! \
    --configGroupNo 11099 \
    --cloudCacheModeCode SIMPLE \
    --cloudCacheImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050 \
    --cloudCacheProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 \
    --isBackup true \
    --isAutomaticBackup true \
    --backupFileRetentionPeriod 1 \
    --cloudCachePort 13306 \
    --cloudCacheDbmsCode Valkey \
    --regionCode KR \
    --output json

출력

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

{
  "createCloudCacheInstanceResponse": {
    "totalRows": 1,
    "cloudCacheInstanceList": [
      {
        "cloudCacheInstanceNo": "34567890",
        "cloudCacheServiceName": "test-cache-01",
        "cloudCacheInstanceStatusName": "creating",
        "cloudCacheInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init 상태"
        },
        "cloudCacheInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudCacheImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050",
        "engineVersion": "VALKEY 8.1.6",
        "license": {
          "code": "BSD",
          "codeName": "라이센스코드-CLOUD DATABASE(VPC)"
        },
        "cloudCachePort": 13306,
        "isHa": false,
        "cloudCacheServerPrefix": "testcache",
        "generationCode": "G2",
        "role": {
          "code": "SIMPLE",
          "codeName": "Cluster Role-CLOUD Cache(VPC)"
        },
        "createDate": "2026-06-30T15:58:04+0900",
        "accessControlGroupNoList": [],
        "masterNodeCount": 1,
        "slaveNodeCount": 0,
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "cloudCacheServerInstanceList": [
          {
            "cloudCacheServerName": "testcache-001-4r98",
            "cloudCacheServerRole": {
              "code": "A",
              "codeName": "Stand Alone"
            },
            "cloudCacheServerInstanceStatusName": "creating",
            "cloudCacheServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "createDate": "2026-06-30T15:58:04+0900"
          }
        ]
      }
    ],
    "requestId": "58faf5eb-a9ec-48e0-b000-6e68fc7c6ac2",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

createCloudRedisInstance CLI

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

구문

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

./ncloud vredis createCloudRedisInstance \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --cloudRedisServiceName <service-name> \
    --cloudRedisServerNamePrefix <server-name-prefix> \
    --cloudRedisUserName <user-name> \
    --cloudRedisUserPassword <password> \
    --configGroupNo <config-group-no> \
    --cloudRedisModeCode <SIMPLE> \
    [--cloudRedisImageProductCode <image-product-code>] \
    [--cloudRedisProductCode <product-code>] \
    [--engineVersionCode <engine-version-code>] \
    [--isHa <true|false>] \
    [--isBackup <true|false>] \
    [--isAutomaticBackup <true|false>] \
    [--backupTime <hh:mm>] \
    [--backupFileRetentionPeriod <retention-days>] \
    [--cloudRedisPort <port>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createCloudRedisInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--vpcNo String Required Cloud DB for Cache 인스턴스를 생성할 VPC 번호
--subnetNo String Required Cloud DB for Cache 인스턴스의 Subnet 번호
--cloudRedisServiceName String Required Cloud DB for Cache 서비스 이름
  • 영문자, 한글, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • DB 서비스 이름은 중복으로 사용 불가
--cloudRedisServerNamePrefix String Required Cloud DB for Cache 서버 이름 접두사
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성
  • 접두사 뒤에 3자리 숫자가 자동으로 생성됨
  • DB 서버 이름은 중복으로 사용 불가
--cloudRedisUserName String Required DB User 계정 ID
  • 영문자, 숫자, 특수문자 _ -를 조합하여 4~16자 이내로 입력
  • 문자열은 영문자로 시작
--cloudRedisUserPassword String Required DB User 계정 비밀번호
  • 영문자, 숫자, 특수문자를 각 1자 이상씩 포함하여 9~20자 이내로 입력
  • 특수문자 ` & + \ " ' / ^ > 및 공백 사용 불가
--configGroupNo String Required Config Group 번호
  • DB Server 설정을 효율적으로 관리하기 위한 Config Group을 제공하며, 하나의 클러스터군은 모두 같은 config를 사용함
  • Config Group이 없는 경우, 새로 생성해야 하며, 생성 후에도 온라인으로 변경 가능
  • DB 서버의 타입(Simple) 및 Cache 엔진 버전 정보와 일치하는 Config Group 번호 입력
    • 예시: DB Server 타입이 Simple이고 엔진 버전이 7.2.11인 경우, redisVersion이 7.2.11-simple에 해당하는 configGroupNo 입력
  • getCloudCacheConfigGroupList 참조
--cloudRedisModeCode String Required Cloud DB for Cache 모드
  • SIMPLE
    • SIMPLE: Master, Standby-Master 방식을 사용하는 기본 Cache
--backupTime String Conditional 백업 시점 설정 (HH:MM)
  • isBackup=true이고 isAutomaticBackup=false인 경우, 필수 입력
  • 예시: 01:15 (선택한 시간 + 15분 사이에 백업 시작)

선택 옵션

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

옵션 타입 필수 여부 설명
--cloudRedisImageProductCode String Optional Cloud DB for Cache 이미지 상품 코드
--cloudRedisProductCode String Optional Cloud DB for Cache 상품 코드
  • Cloud DB for Cache 인스턴스의 서버 스펙 결정
  • 기본값: 최소 사양 (메모리, CPU 순)
  • getCloudCacheProductList 참조
--engineVersionCode String Optional DB 엔진 버전
--isHa Boolean Optional 고가용성 여부
  • true | false (기본값)
  • 고가용성 선택 시 Standby Master 서버를 이용한 자동 장애 복구를 지원하며, 추가 요금 발생 및 자동으로 백업이 설정됨
  • false: 단일 DB Server로 생성되며 고가용성 미지원. 생성 이후에 고가용성으로 변경 가능
--isBackup Boolean Optional DB Server의 백업 설정 여부
  • true | false (기본값)
  • isHa=true인 경우, true로 고정됨
--isAutomaticBackup Boolean Optional 백업 시점 자동 설정 여부
  • true (기본값) | false
  • true인 경우, backupTime이 입력되어도 무시하고 자동으로 설정됨
--backupFileRetentionPeriod Integer Optional 백업 파일 보관 기간 (일)
  • 1~7 (기본값: 1)
  • 백업은 매일 수행되며, 백업 파일은 별도의 백업 스토리지에 저장
  • 요금은 사용하는 공간만큼만 과금
--cloudRedisPort Integer Optional Cloud DB for Cache 인스턴스에 접근하기 위한 TCP 포트 번호
  • 10000~20000 (기본값: 6379)

공통 옵션

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

예시

Cloud DB for Cache 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vredis createCloudRedisInstance \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --cloudRedisServiceName test-redis-01 \
    --cloudRedisServerNamePrefix testredis \
    --cloudRedisUserName testuser \
    --cloudRedisUserPassword Examplepw123! \
    --configGroupNo 11099 \
    --cloudRedisModeCode SIMPLE \
    --cloudRedisImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050 \
    --cloudRedisProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 \
    --isBackup true \
    --isAutomaticBackup true \
    --backupFileRetentionPeriod 1 \
    --cloudRedisPort 13306 \
    --regionCode KR \
    --output json

출력

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

{
  "createCloudRedisInstanceResponse": {
    "totalRows": 1,
    "cloudRedisInstanceList": [
      {
        "cloudRedisInstanceNo": "34567890",
        "cloudRedisServiceName": "test-redis-01",
        "cloudRedisInstanceStatusName": "creating",
        "cloudRedisInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init 상태"
        },
        "cloudRedisInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudRedisImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050",
        "engineVersion": "REDIS 7.2.11",
        "license": {
          "code": "BSD",
          "codeName": "라이센스코드-CLOUD DATABASE(VPC)"
        },
        "cloudRedisPort": 13306,
        "isHa": false,
        "cloudRedisServerPrefix": "testredis",
        "generationCode": "G2",
        "role": {
          "code": "SIMPLE",
          "codeName": "Cluster Role-CLOUD Cache(VPC)"
        },
        "createDate": "2026-06-30T17:33:22+0900",
        "accessControlGroupNoList": [],
        "masterNodeCount": 1,
        "slaveNodeCount": 0,
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "cloudRedisServerInstanceList": [
          {
            "cloudRedisServerName": "testredis-001-4r9j",
            "cloudRedisServerRole": {
              "code": "A",
              "codeName": "Stand Alone"
            },
            "cloudRedisServerInstanceStatusName": "creating",
            "cloudRedisServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudRedisServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "createDate": "2026-06-30T17:33:22+0900"
          }
        ]
      }
    ],
    "requestId": "dac47c94-ea2e-480c-a7a3-96abbb983cb4",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
사업자등록번호: 129-86-31394 통신판매업신고번호:제2009-경기성남-0510호
대표이사: 김유원 주소: 경기도 성남시 분당구 불정로 6 네이버 그린팩토리 17~26층, 13561 고객지원 대표전화: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.