---
title: "createCloudCacheInstance"
slug: "cli-vcache-createcloudcacheinstance"
tags: ["Cloud DB for Cache"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
canonical: "cli-fin.ncloud-docs.com/cli-vcache-createcloudcacheinstance"
---

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

# createCloudCacheInstance

## 개요<a name="개요"></a>

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

:::(info) (참고)
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
* createCloudCacheInstance CLI: Valkey, Redis DBMS 이용 가능
* createCloudRedisInstance CLI: Redis DBMS 이용 가능
:::

## createCloudCacheInstance CLI<a name="createCloudCacheInstance CLI"></a> 
createCloudCacheInstance CLI의 요청, 응답 형식을 설명합니다.

### 요청<a name="요청"></a>

#### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명                      | 필수 여부       | 타입      | 제약 사항                                                                                                 | 설명                                                                                                                                                                                                                                                                                                                                                                                                                              |
|----------------------------|-------------|---------|-------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No          | String  |                                                                                                       | - 리전 코드<br/>Cloud DB for Cache 인스턴스가 생성될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br/>Default: getRegionList 조회 결과의 첫 번째 리전을 선택                                                                                                                                                                                                                             |
| vpcNo                      | Yes         | String  |                                                                                                       | - VPC 번호<br/>Cloud DB for Cache 인스턴스가 생성될 VPC를 결정함<br/>vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능                                                                                                                                                                                                                                                                                                 |
| cloudCacheImageProductCode | No          | String  |                                                                                                       | - Cloud Cache 이미지 상품 코드<br/>cloudCacheImageProductCode는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션의 productCode로 획득 가능<br/>입력하지 않을 경우 Default값으로 생성됨                                                                                                                                                                                                                                    |
| cloudCacheProductCode      | No          | String  |                                                                                                       | - Cloud Cache 상품 코드<br/>생성할 Cloud DB for Cache 인스턴스의 서버 스펙 결정 가능<br/>cloudCacheProductCode는 [getCloudCacheProductList](/docs/cli-vcache-getcloudcacheproductlist) 액션의 productCode로 획득 가능<br/>Default:최소 사양으로 선택되며 최소 사양의 기준은<br/> 1. 메모리 2. CPU                                                                                                                                                                                 |
| shardCount                 | No          | Integer | Min:3, Max: 10                                                                                        | - 샤드 수<br/>생성할 샤드 수이며 최소 3개이며 최대 10개<br/>Master Node의 개수<br/> CloudCacheModeCode가 CLUSTER일 때에만 입력하며 CloudCacheModeCode가 SIMPLE이면 shardCount가 입력되어도 무시됨 <br/> 공공 환경에서는 이용이 불가능<br/> default: 3                                                                                                                                                                                                                                   |
| shardCopyCount             | No          | Integer | Min: 0, Max: 4                                                                                        | - 샤드 당 복제본<br/>Cache Cluster는 Master node와 Slave node로 구성되어 있음<br/>HA를 위해서는 Slave node가 필요함<br/>복제본 추가 시 모든 Master 노드에 각각 1개씩 Slave node가 할당됨<br/> (ex) 샤드 수 3, 샤드 당 복제본 1 -> Master node: 3대, Slave node: 3대 <br/> 샤드 당 복제본은 0~4까지 입력 가능 <br/>만약 샤드 당 복제본을 0으로 설정한다면 고가용성 지원이 되지 않음<br/> CloudCacheModeCode가 CLUSTER일때에만 입력함<br/> CloudCacheModeCode가 SIMPLE이면 shardCopyCount가 입력되어도 무시됨<br/> 공공 환경에서는 이용이 불가능<br/> default: 0 |
| isHa                       | No          | Boolean |                                                                                                       | - 고가용성 여부<br/>Cloud DB for Cache는 Standby 마스터를 이용한 자동 장애 복구를 지원함<br/> 고가용성 지원 시 추가 요금이 발생하며 자동으로 백업이 설정됨<br/>Default: false                                                                                                                                                                                                                                                                                                     |
| configGroupNo              | Yes         | String  |                                                                                                       | - ConfigGroup 번호<br/>Config Group을 제공하며 하나의 클러스터 군은 모두 같은 config를 사용하게 됨<br/> Config Group이 없을 시 새로 생성해야 하며 생성 후에도 온라인으로 변경 가능                                                                                                                                                                                                                                                                                                  |
| isBackup                   | No          | Boolean |                                                                                                       | - 백업 여부<br/>고가용성 여부(isHa)가 True이면 백업 설정 여부도 True로 고정됨 <br/> default : false                                                                                                                                                                                                                                                                                                                                                     |
| backupFileRetentionPeriod  | No          | Integer | Min: 1, Max: 7                                                                                        | - 백업 파일 보관 기간<br/>백업은 매일 수행되며, 백업 파일은 별도의 백업 스토리지에 저장됨 요금은 사용하는 공간만큼 과금됨<br/>Default: 1(1일)                                                                                                                                                                                                                                                                                                                                     |
| backupTime                 | Conditional | String  |                                                                                                       | - 백업 시간<br/>백업이 수행되는 시간을 설정함<br/>백업 여부(isBackup)가 True이고, 자동 백업 여부(isAutomaticBackup)가 False이면 반드시 입력함<br/>예제<br/>01:15                                                                                                                                                                                                                                                                                                         |
| isAutomaticBackup          | No          | Boolean |                                                                                                       | - 백업 시간 자동 여부<br/>자동으로 백업 시간을 설정할지에 대한 여부를 선택함<br/>자동 백업 여부(isAutomaticBackup)가 True이면 backupTime이 입력되어도 무시되고 자동 설정됨                                                                                                                                                                                                                                                                                                            |
| cloudCacheServiceName      | Yes         | String  | 영어, 숫자, -의 특수문자, 한글만 입력 가능<br/>Min: 3, Max: 15                                                        | - Cloud Cache 서비스 이름<br/> Cache Server의 그룹명 입력 (예: 네이버-HOME) <br/> 최소 3자, 최대 15자까지 입력 가능<br/>Cache 서비스 이름은 중복으로 사용할 수 없음                                                                                                                                                                                                                                                                                                        |
| cloudCacheServerNamePrefix | Yes         | String  | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함<br/>첫 글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 <br/>Min: 3, Max: 15         | - Cloud DB 서버 이름<br/>Cache Server의 이름 Prefix를 입력함<br/> 최소 3자리에서 최대 15자리까지 입력 가능 <br/> Cache Server 이름에 3자리 숫자가 자동으로 채번되어 생성됨<br/> Cache Server이름은 중복으로 사용할 수 없음                                                                                                                                                                                                                                                              |
| cloudCachePort             | No          | Integer | 6379<br/>or<br/>Min: 10000, Max: 20000                                                                | - Cloud Cache 포트<br/>Cache 접근을 위한 TCP 포트 번호 입력 바람<br/>Default: 6379                                                                                                                                                                                                                                                                                                                                                             |
| subnetNo                   | Yes         | String  |                                                                                                       | - Subnet 번호<br/>생성할 Cloud Cache 인스턴스의 Subnet을 결정함<br/>subnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해 획득 가능<br/>Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청 가능<br/>Cloud DB for Cache 인스턴스 생성 이후에 Subnet 이전은 불가능                                                                                                                                                                               |
| engineVersionCode          | No          | String  |                                                                                                       | - Engine Version<br/> getCloudCacheImageProductList는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션을 통해서 획득 가능<br/> 입력하지 않을 경우 현재 제공 중인 최신 버전으로 생성                                                                                                                                                                             |
| cloudCacheModeCode         | Yes         | String  |                                                                                                       | - Cloud DB for Cache 구성 <br/> Cloud DB for Cache의 구성을 결정함<br/>CLUSTER 설정 사용시, isHa 설정을 무시함 <br/> Options: SIMPLE \| CLUSTER |                                                                                                                                                                                                                                                                                                |
| cloudCacheDbmsCode | No | String | | Cloud DB for Cache 인스턴스의 DBMS 코드 <br/> Options: Redis \| Valkey <br/> Default: Redis |
| output                     | No          | String  |                                                                                                       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                                                                                                                                                                                                                                                                                                       |

### 응답<a name="응답"></a>

#### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudCacheInstanceList 타입

| CloudCacheInstanceList extends CommonResponse                                      |
|------------------------------------------------------------------------------------|
| private Integer totalRows;                                                         |
| private List&lt;CloudCacheInstance&gt; cloudCacheInstanceList = new ArrayList<>(); |

| CloudCacheInstance                                                   |
|----------------------------------------------------------------------|
| private String cloudCacheInstanceNo;                                 |
| private String cloudCacheDbmsCode; |
| private String cloudCacheServiceName;                                |
| private String cloudCacheInstanceStatusName;                         |
| private CommonCode cloudCacheInstanceStatus;                         |
| private CommonCode cloudCacheInstanceOperation;                      |
| private String cloudCacheImageProductCode;                           |
| private String engineVersion;                                        |
| private CommonCode licence;                                          |
| private Integer cloudCachePort;                                      |
| private Boolean isHa;                                                |
| private String cloudCacheServerPrefix;                               |
| private Boolean isBackup;                                            |
| private Integer backupFileRetentionPeriod;                           |
| private String backupTime;                                           |
| private String backupSchedule;                                       |
| private String generationCode;                                       |
| private Date createDate;                                             |
| private Integer shardCount;                                          |
| private Integer shardCopyCount;                                      |
| private AccessControlGroupNoList accessControlGroupNoList;           |
| private String configGroupNo;                                        |
| private String configGroupName;                                      |
| private CommonCode role;                                             |
| private List&lt;CloudCacheInstance&gt; cloudCacheServerInstanceList; |

| AccessControlGroupNoList                                                 |
|--------------------------------------------------------------------------|
| private List&lt;String&gt; accessControlGroupNoList = new ArrayList<>(); |

| CloudCacheServerInstance                              |
|-------------------------------------------------------|
| private String cloudCacheServerInstanceNo;            |
| private String cloudCacheServerName;                  |
| private CommonCode cloudCacheServerRole;              |
| private String cloudCacheServerInstanceStatusName;    |
| private CommonCode cloudCacheServerInstanceStatus;    |
| private CommonCode cloudCacheServerInstanceOperation; |
| private String cloudCacheProductCode;                 |
| private String regionCode;                            |
| private String zoneCode;                              |
| private String vpcNo;                                 |
| private String subnetNo;                              |
| private String privateDomain;                         |
| private Integer cpuCount;                             |
| private Long memorySize;                              |
| private Long osMemorySize;                            |
| private Date uptime;                                  |
| private Date createDate;                              |
| private String slotName;                              |

### 예시<a name="예시"></a>

#### 호출<a name="호출"></a>

```
ncloud vcache createCloudCacheInstance --regionCode FKR --vpcNo ****83 --cloudCacheImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050 --cloudCacheProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001 --isHa true --configGroupNo **9 --isBackup true --backupFileRetentionPeriod 7 --backupTime 00:15 --isAutomaticBackup true --cloudCacheServiceName test-**** --cloudCacheServerNamePrefix test-**** --cloudCachePort 6379 --subnetNo ****91 --cloudCacheModeCode SIMPLE --cloudCacheDbmsCode Valkey --engineVersionCode 7.2.11
```

#### 응답<a name="응답"></a>

```xml

<createCloudCacheInstanceResponse>
    <requestId>74429b9f-2ed5-4dc8-8bfa-4e958fcd7d16</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheInstanceList>
        <cloudCacheInstance>
            <cloudCacheInstanceNo>182****</cloudCacheInstanceNo>
            <cloudCacheDbmsCode>Valkey</cloudCacheDbmsCode>
            <cloudCacheServiceName>test-****</cloudCacheServiceName>
            <cloudCacheInstanceStatusName>creating</cloudCacheInstanceStatusName>
            <cloudCacheInstanceStatus>
                <code>INIT</code>
                <codeName>CLOUD DATABASE(VPC) Init State</codeName>
            </cloudCacheInstanceStatus>
            <cloudCacheInstanceOperation>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
            </cloudCacheInstanceOperation>
            <cloudCacheImageProductCode>SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050</cloudCacheImageProductCode>
            <engineVersion>VALKEY 7.2.11</engineVersion>
            <licence>
                <code>BSD</code>
                <codeName>Berkeley Software Distribution</codeName>
            </licence>
            <cloudCachePort>6379</cloudCachePort>
            <isHa>false</isHa>
            <cloudCacheServerPrefix>test-****</cloudCacheServerPrefix>
            <role>
                <code>SIMPLE</code>
                <codeName>CLOUD CACHE(VPC) Cluster Role</codeName>
            </role>
            <createDate>2021-08-04T16:57:54+0900</createDate>
            <accessControlGroupNoList/>
            <masterNodeCount>1</masterNodeCount>
            <slaveNodeCount>1</slaveNodeCount>
            <configGroupNo>3**</configGroupNo>
            <configGroupName>sd***</configGroupName>
            <generationCode>G2</generationCode>
            <cloudCacheServerInstanceList>
                <cloudCacheServerInstance>
                    <cloudCacheServerName>test-fdkxcz-001-j4a</cloudCacheServerName>
                    <cloudCacheServerRole>
                        <code>A</code>
                        <codeName>Stand Alone</codeName>
                    </cloudCacheServerRole>
                    <cloudCacheServerInstanceStatusName>creating</cloudCacheServerInstanceStatusName>
                    <cloudCacheServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudCacheServerInstanceStatus>
                    <cloudCacheServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudCacheServerInstanceOperation>
                    <cloudCacheProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudCacheProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>1665</vpcNo>
                    <subnetNo>1792</subnetNo>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-08-04T16:57:54+0900</createDate>
                </cloudCacheServerInstance>
                <cloudCacheServerInstance>
                    <cloudCacheServerName>test-fdkxcz-002-j4a</cloudCacheServerName>
                    <cloudCacheServerRole>
                        <code>H</code>
                        <codeName>Hidden Master</codeName>
                    </cloudCacheServerRole>
                    <cloudCacheServerInstanceStatusName>creating</cloudCacheServerInstanceStatusName>
                    <cloudCacheServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudCacheServerInstanceStatus>
                    <cloudCacheServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudCacheServerInstanceOperation>
                    <cloudCacheProductCode>SVR.VRDS.AMD.STAND.C004.M001.NET.SSD.B050</cloudCacheProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>1665</vpcNo>
                    <subnetNo>1792</subnetNo>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-08-04T16:57:54+0900</createDate>
                </cloudCacheServerInstance>
            </cloudCacheServerInstanceList>
        </cloudCacheInstance>
    </cloudCacheInstanceList>
</createCloudCacheInstanceResponse>
```

## createCloudRedisInstance CLI<a name="createCloudRedisInstance CLI"></a> 
createCloudRedisInstance CLI의 요청, 응답 형식을 설명합니다.

### 요청<a name="요청"></a>

#### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명                      | 필수 여부       | 타입      | 제약 사항                                                                                        | 설명                                                                                                                                                                                                                                                                                                                                                                                                           |
|----------------------------|-------------|---------|----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No          | String  |                                                                                              | - 리전 코드<br>Cloud DB for Cache 인스턴스가 생성될 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br>Default: getRegionList 조회 결과의 첫 번째 리전을 선택                                                                                                                                                                                                         |
| vpcNo                      | Yes         | String  |                                                                                              | - VPC 번호<br>Cloud DB for Cache 인스턴스가 생성될 VPC 결정.<br>vpcNo는 [getCloudRedisTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 액션을 통해서 획득 가능                                                                                                                                                                                                                                                         |
| cloudRedisImageProductCode | No          | String  |                                                                                              | - Cloud Cache 이미지 상품 코드<br>cloudRedisImageProductCode는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션을 통해서 획득 가능<br>입력하지 않을 경우 Default값으로 생성됨.                                                                                                                                                                                                                         |
| cloudRedisProductCode      | No          | String  |                                                                                              | - Cloud Cache 상품 코드<br>생성할 Cloud DB for Cache 인스턴스의 서버 스펙을 결정 가능<br>cloudRedisProductCode는 [getCloudCacheProductList](/docs/cli-vcache-getcloudcacheproductlist) 액션을 통해서 획득 가능<br>Default:최소 사양으로 선택됨. 최소 사양의 기준은 1. 메모리 2. CPU                                                                                                                                                                           |
| shardCount                 | No          | Integer | Min:3, Max: 10                                                                               | - 샤드 수<br>생성할 샤드 수<br>최소 3개이며 최대 10개<br>Master Node의 개수<br> CloudRedisModeCode가 CLUSTER일 때에만 입력<br> CloudRedisModeCode가 SIMPLE이면 shardCount가 입력되어도 무시됨 <br> Default: 3                                                                                                                                                                                                                                 |
| shardCopyCount             | No          | Integer | Min: 0, Max: 4                                                                               | - 샤드 당 복제본<br>Cluster는 Master node와 Slave node로 구성되어 있음<br>HA를 위해서는 Slave node가 필요함<br>복제본 추가 시 모든 Master 노드에 각각 1개씩 Slave node가 할당됨<br> (ex) 샤드 수 3, 샤드 당 복제본 1 -> Master node: 3대, Slave node: 3대 <br> 샤드 당 복제본은 0~4까지 입력 가능 <br>만약 샤드 당 복제본을 0으로 설정한다면 고가용성 지원이 되지 않음.<br> CloudRedisModeCode가 CLUSTER일때에만 입력 <br> CloudRedisModeCode가 SIMPLE이면 shardCopyCount가 입력되어도 무시됨. <br> Default: 0 |
| isHa                       | No          | Boolean |                                                                                              | - 고가용성 여부<br>Cloud DB for Cache 상품은 Standby 마스터를 이용한 자동 장애 복구를 지원<br> 고가용성 지원 시 추가 요금이 발생하며 자동으로 백업이 설정. <br>Default: false                                                                                                                                                                                                                                                                               |
| configGroupNo              | Yes         | String  |                                                                                              | - ConfigGroup 번호<br>Config Group을 제공하며 하나의 클러스터 군은 모두 같은 config를 사용하게 됨. <br> Config Group이 없을 시 새로 생성해야 하며 생성 후에도 온라인으로 변경 가능                                                                                                                                                                                                                                                                             |
| isBackup                   | No          | Boolean |                                                                                              | - 백업 여부<br>고가용성 여부(isHa)가 True이면 백업 설정 여부도 True로 고정됨. <br> Default : false                                                                                                                                                                                                                                                                                                                                 |
| backupFileRetentionPeriod  | No          | Integer | Min: 1, Max: 7                                                                               | - 백업 파일 보관 기간<br>백업은 매일 수행되며, 백업 파일은 별도의 백업 스토리지에 저장됨. 요금은 사용하는 공간만큼 과금됨.<br>Default: 1(1일)                                                                                                                                                                                                                                                                                                                |
| backupTime                 | Conditional | String  |                                                                                              | - 백업 시간<br>백업이 수행되는 시간을 설정<br> 백업 여부(isBackup)가 True이고, 자동 백업 여부(isAutomaticBackup)가 False이면 반드시 입력<br>예제<br>01:15                                                                                                                                                                                                                                                                                       |
| isAutomaticBackup          | No          | Boolean |                                                                                              | - 백업 시간 자동 여부<br>자동으로 백업 시간을 설정할지에 대한 여부를 선택. 자동 백업 여부(isAutomaticBackup)가 True이면 backupTime이 입력되어도 무시되고 자동 설정됨.<br> Default true                                                                                                                                                                                                                                                                          |
| cloudRedisServiceName      | Yes         | String  | 영어, 숫자, -의 특수문자, 한글만 입력 가능<br>Min: 3, Max:15                                                | - Cloud DB 서비스 이름<br> DB Server의 그룹명을 입력(예: 네이버-HOME) <br> 최소 3자, 최대 15자까지 입력 가능<br>DB 서비스 이름은 중복으로 사용 불가                                                                                                                                                                                                                                                                                        |
| cloudRedisServerNamePrefix | Yes         | String  | 영문자(소문자), 숫자, 하이픈(-)으로만 구성되어야 함<br>첫 글자는 영문자여야 하고 마지막 글자는 영문자 또는 숫자여야 함 <br>Min: 3, Max:15 | - Cloud DB 서버 이름<br>DB Server의 이름 Prefix를 입력<br> 최소 3자리에서 최대 15자리까지 입력 가능 <br> DB Server 이름에 3자리 숫자가 자동으로 채번되어 생성됨. DB Server이름은 중복으로 사용 불가                                                                                                                                                                                                                                                   |
| cloudRedisPort             | No          | Integer | 6379<br>or<br>Min: 10000, Max: 20000                                                       | - Cloud Cache 포트<br>DB 접근을 위한 TCP 포트 번호 입력 필요<br>Default: 6379                                                                                                                                                                                                                                                                                                                                          |
| subnetNo                   | Yes         | String  |                                                                                              | - Subnet 번호<br>생성할 Cloud DB 인스턴스의 Subnet을 결정<br>subnetNo는 [getCloudCacheTargetSubnetList](/docs/cli-vcache-getcloudcachetargetsubnetlist) 액션을 통해서 획득 가능<br>Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청이 가능<br>Cloud DB for Cache 인스턴스 생성 이후에 Subnet 이전은 불가능                                                                                                                                         |
| engineVersionCode          | No          | String  |                                                                                              | - Engine Version<br> getCloudRedisImageProductList는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션을 통해서 획득 가능<br>입력하지 않을 경우 현재 제공 중인 최신 버전으로 생성                                                                                                                                                          |
| cloudRedisModeCode         | Yes         | String  |                                                                                              | - Cloud DB for Cache 구성 <br> Cloud DB for Cache의 구성을 결정 <br>CLUSTER 설정 사용시, isHa 설정을 무시. <br> Options: CLUSTER, SIMPLE                                                                                                                                                                                                                                                                                    |
| output                     | No          | String  |                                                                                              | - 응답 결과의 포맷 타입<br>Options: xml \| json<br>Default: json                                                                                                                                                                                                                                                                                                                                                    |

### 응답<a name="응답"></a>

#### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudRedisInstanceList 타입

| CloudRedisInstanceList extends CommonResponse                                      |
|------------------------------------------------------------------------------------|
| private Integer totalRows;                                                         |
| private List&lt;CloudRedisInstance&gt; cloudRedisInstanceList = new ArrayList<>(); |

| CloudRedisInstance                                                   |
|----------------------------------------------------------------------|
| private String cloudRedisInstanceNo;                                 |
| private String cloudRedisServiceName;                                |
| private String cloudRedisInstanceStatusName;                         |
| private CommonCode cloudRedisInstanceStatus;                         |
| private CommonCode cloudRedisInstanceOperation;                      |
| private String cloudRedisImageProductCode;                           |
| private String engineVersion;                                        |
| private CommonCode licence;                                          |
| private Integer cloudRedisPort;                                      |
| private Boolean isHa;                                                |
| private String cloudRedisServerPrefix;                               |
| private Boolean isBackup;                                            |
| private Integer backupFileRetentionPeriod;                           |
| private String backupTime;                                           |
| private String backupSchedule;                                       |
| private String generationCode;                                       |
| private Date createDate;                                             |
| private Integer shardCount;                                          |
| private Integer shardCopyCount;                                      |
| private AccessControlGroupNoList accessControlGroupNoList;           |
| private String configGroupNo;                                        |
| private String configGroupName;                                      |
| private CommonCode role;                                             |
| private List&lt;CloudRedisInstance&gt; cloudRedisServerInstanceList; |

| AccessControlGroupNoList                                                 |
|--------------------------------------------------------------------------|
| private List&lt;String&gt; accessControlGroupNoList = new ArrayList<>(); |

| CloudRedisServerInstance                              |
|-------------------------------------------------------|
| private String cloudRedisServerInstanceNo;            |
| private String cloudRedisServerName;                  |
| private CommonCode cloudRedisServerRole;              |
| private String cloudRedisServerInstanceStatusName;    |
| private CommonCode cloudRedisServerInstanceStatus;    |
| private CommonCode cloudRedisServerInstanceOperation; |
| private String cloudRedisProductCode;                 |
| private String regionCode;                            |
| private String zoneCode;                              |
| private String vpcNo;                                 |
| private String subnetNo;                              |
| private String privateDomain;                         |
| private Integer cpuCount;                             |
| private Long memorySize;                              |
| private Long osMemorySize;                            |
| private Date uptime;                                  |
| private Date createDate;                              |
| private String slotName;                              |

### 예시<a name="예시"></a>

#### 호출<a name="호출"></a>

```
ncloud vredis createCloudRedisInstance --regionCode FKR --vpcNo ****83 --cloudRedisImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050 --cloudRedisProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001 --shardCount 3 --shardCopyCount 1 --isHa true --configGroupNo **9 --isBackup true --backupFileRetentionPeriod 7 --backupTime 00:15 --isAutomaticBackup true --cloudRedisServiceName test-**** --cloudRedisServerNamePrefix test-**** --cloudRedisPort 6379 --subnetNo ****91 --cloudRedisModeCode SIMPLE
```

#### 응답<a name="응답"></a>

```xml

<createCloudRedisInstanceResponse>
    <requestId>0a3318fc-7176-4e2d-8c55-925209e53115</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisInstanceList>
        <cloudRedisInstance>
            <cloudRedisInstanceNo>****511</cloudRedisInstanceNo>
            <cloudRedisServiceName>test-*****</cloudRedisServiceName>
            <cloudRedisInstanceStatus>
                <code>INIT</code>
                <codeName>CLOUD DATABASE(VPC) Init State</codeName>
            </cloudRedisInstanceStatus>
            <cloudRedisInstanceOperation>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
            </cloudRedisInstanceOperation>
            <cloudRedisImageProductCode>SW.VDBAS.VRDS.LNX64.CNTOS.0703.REDIS.4014.B050</cloudRedisImageProductCode>
            <engineVersion>REDIS 4.0.14</engineVersion>
            <licence>
                <code>BSD</code>
                <codeName>Berkeley Software Distribution</codeName>
            </licence>
            <cloudRedisPort>6379</cloudRedisPort>
            <isHa>false</isHa>
            <cloudRedisServerPrefix>test-****</cloudRedisServerPrefix>
            <role>
                <code>CLUSTER</code>
                <codeName>CLOUD REDIS(VPC) Cluster Role</codeName>
            </role>
            <createDate>2021-04-21T15:05:31+0900</createDate>
            <masterNodeCount>3</masterNodeCount>
            <slaveNodeCount>3</slaveNodeCount>
            <configGroupNo>**9</configGroupNo>
            <configGroupName>test-****-config</configGroupName>
            <generationCode>G2</generationCode>
            <cloudRedisServerInstanceList>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-001-001-ehd</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-002-001-ehe</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-003-001-ehf</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-001-002-ehg</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>S</code>
                        <codeName>Slave</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-002-002-ehh</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>S</code>
                        <codeName>Slave</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerName>test-****-003-002-ehi</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>S</code>
                        <codeName>Slave</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>creating</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>****83</vpcNo>
                    <subnetNo>****91</subnetNo>
                    <privateDomain>redisc-*****-fkr.cdb.fin-ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <createDate>2021-04-21T15:05:31+0900</createDate>
                </cloudRedisServerInstance>
            </cloudRedisServerInstanceList>
        </cloudRedisInstance>
    </cloudRedisInstanceList>
</createCloudRedisInstanceResponse>
```