---
title: "rebootCloudCacheServerInstance"
slug: "cli-vcache-rebootcloudcacheserverinstance"
tags: ["Cloud DB for Cache", "VPC"]
updated: 2026-04-23T09:04:55Z
published: 2026-04-23T09:07:31Z
---

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

# rebootCloudCacheServerInstance

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

Cloud DB for Cache 서버 인스턴스를 재시작합니다.

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

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

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

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

| 파라미터명                      | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                                                                                                                              |
|----------------------------|-------|--------|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No    | String |       | - 리전 코드<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택                                                                                                                                                             |
| cloudCacheServerInstanceNo | Yes   | String |       | - 재시작할 Cloud DB for Cache 서버 인스턴스 번호<br/>재시작으로 인한 Data 손실이 발생할 수 있으며, StandAlone 의 경우 모든 Data가 삭제됨.<br/>Cache Cluster 상품에서 Master를 재시작할 경우 failover 후 진행하므로(HA 지원할 경우) 재시작 후 Role 이 변경 됨.<br/>cloudCacheServerInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능 |
| 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 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 rebootCloudCacheServerInstance --regionCode FKR --cloudCacheServerInstanceNo ***821
```

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

```xml

<rebootCloudCacheServerInstanceResponse>
    <requestId>f88759fb-fced-43fa-8d2d-ae415250adb6</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheInstanceList>
        <cloudCacheInstance>
            <cloudCacheInstanceNo>2192***</cloudCacheInstanceNo>
            <cloudCacheServiceName>dsd***</cloudCacheServiceName>
            <cloudCacheInstanceStatusName>shuttingDown</cloudCacheInstanceStatusName>
            <cloudCacheInstanceStatus>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Created State</codeName>
            </cloudCacheInstanceStatus>
            <cloudCacheInstanceOperation>
                <code>NULL</code>
                <codeName>CLOUD DATABASE(VPC) Null OP</codeName>
            </cloudCacheInstanceOperation>
            <cloudCacheImageProductCode>SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050</cloudCacheImageProductCode>
            <engineVersion>CACHE 4.0.14</engineVersion>
            <licence>
                <code>BSD</code>
                <codeName>Berkeley Software Distribution</codeName>
            </licence>
            <cloudCachePort>6379</cloudCachePort>
            <isHa>false</isHa>
            <isBackup>false</isBackup>
            <backupTime>01:00</backupTime>
            <backupFileRetentionPeriod>1</backupFileRetentionPeriod>
            <backupSchedule>AUTO</backupSchedule>
            <cloudCacheServerPrefix>dsaj****</cloudCacheServerPrefix>
            <role>
                <code>CLUSTER</code>
                <codeName>CLOUD CACHE(VPC) Cluster Role</codeName>
            </role>
            <createDate>2022-02-21T14:58:44+0900</createDate>
            <accessControlGroupNoList>
                <accessControlGroupNo>14704</accessControlGroupNo>
            </accessControlGroupNoList>
            <masterNodeCount>3</masterNodeCount>
            <slaveNodeCount>0</slaveNodeCount>
            <configGroupNo>4**</configGroupNo>
            <configGroupName>ffsd***</configGroupName>
            <generationCode>G2</generationCode>
            <cloudCacheServerInstanceList>
                <cloudCacheServerInstance>
                    <cloudCacheServerInstanceNo>2192***</cloudCacheServerInstanceNo>
                    <cloudCacheServerName>dsajc***-001-001-rm1</cloudCacheServerName>
                    <cloudCacheServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudCacheServerRole>
                    <cloudCacheServerInstanceStatusName>shuttingDown</cloudCacheServerInstanceStatusName>
                    <cloudCacheServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudCacheServerInstanceStatus>
                    <cloudCacheServerInstanceOperation>
                        <code>STOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Stop OP</codeName>
                    </cloudCacheServerInstanceOperation>
                    <cloudCacheProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudCacheProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>cachec-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>0-5460</slotName>
                </cloudCacheServerInstance>
                <cloudCacheServerInstance>
                    <cloudCacheServerInstanceNo>2192***</cloudCacheServerInstanceNo>
                    <cloudCacheServerName>dsajc***-002-001-rm2</cloudCacheServerName>
                    <cloudCacheServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudCacheServerRole>
                    <cloudCacheServerInstanceStatusName>running</cloudCacheServerInstanceStatusName>
                    <cloudCacheServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudCacheServerInstanceStatus>
                    <cloudCacheServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudCacheServerInstanceOperation>
                    <cloudCacheProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudCacheProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>cachec-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>5461-10922</slotName>
                </cloudCacheServerInstance>
                <cloudCacheServerInstance>
                    <cloudCacheServerInstanceNo>2192***</cloudCacheServerInstanceNo>
                    <cloudCacheServerName>dsaj***-003-001-rm3</cloudCacheServerName>
                    <cloudCacheServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudCacheServerRole>
                    <cloudCacheServerInstanceStatusName>running</cloudCacheServerInstanceStatusName>
                    <cloudCacheServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudCacheServerInstanceStatus>
                    <cloudCacheServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudCacheServerInstanceOperation>
                    <cloudCacheProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudCacheProductCode>
                    <regionCode>FKR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>cachec-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>10923-16383</slotName>
                </cloudCacheServerInstance>
            </cloudCacheServerInstanceList>
        </cloudCacheInstance>
    </cloudCacheInstanceList>
</rebootCloudCacheServerInstanceResponse>
```

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


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

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

| 파라미터명                      | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                                                                                                                           |
|----------------------------|-------|--------|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No    | String |       | - 리전 코드<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택                                                                                                                                                          |
| cloudRedisServerInstanceNo | Yes   | String |       | - 재시작할 Cloud DB for Cache 서버 인스턴스 번호<br>재시작으로 인한 Data 손실이 발생할 수 있으며, StandAlone 의 경우 모든 Data가 삭제됨<br>Cluster 상품에서 Master를 재시작할 경우 failover 후 진행하므로(HA 지원할 경우) 재시작 후 Role 이 변경됨<br>cloudRedisServerInstanceNo는 [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 액션을 통해서 획득 가능 |
| 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 rebootCloudRedisServerInstance --regionCode FKR --cloudRedisServerInstanceNo ***821
```

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

```xml

<rebootCloudRedisServerInstanceResponse>
    <requestId>f88759fb-fced-43fa-8d2d-ae415250adb6</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisInstanceList>
        <cloudRedisInstance>
            <cloudRedisInstanceNo>2192***</cloudRedisInstanceNo>
            <cloudRedisServiceName>dsd***</cloudRedisServiceName>
            <cloudRedisInstanceStatusName>shuttingDown</cloudRedisInstanceStatusName>
            <cloudRedisInstanceStatus>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Created State</codeName>
            </cloudRedisInstanceStatus>
            <cloudRedisInstanceOperation>
                <code>NULL</code>
                <codeName>CLOUD DATABASE(VPC) Null 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>
            <isBackup>false</isBackup>
            <backupTime>01:00</backupTime>
            <backupFileRetentionPeriod>1</backupFileRetentionPeriod>
            <backupSchedule>AUTO</backupSchedule>
            <cloudRedisServerPrefix>dsaj****</cloudRedisServerPrefix>
            <role>
                <code>CLUSTER</code>
                <codeName>CLOUD REDIS(VPC) Cluster Role</codeName>
            </role>
            <createDate>2022-02-21T14:58:44+0900</createDate>
            <accessControlGroupNoList>
                <accessControlGroupNo>14704</accessControlGroupNo>
            </accessControlGroupNoList>
            <masterNodeCount>3</masterNodeCount>
            <slaveNodeCount>0</slaveNodeCount>
            <configGroupNo>4**</configGroupNo>
            <configGroupName>ffsd***</configGroupName>
            <generationCode>G2</generationCode>
            <cloudRedisServerInstanceList>
                <cloudRedisServerInstance>
                    <cloudRedisServerInstanceNo>2192***</cloudRedisServerInstanceNo>
                    <cloudRedisServerName>dsajc***-001-001-rm1</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>shuttingDown</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>STOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Stop OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>KR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>redisc-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>0-5460</slotName>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerInstanceNo>2192***</cloudRedisServerInstanceNo>
                    <cloudRedisServerName>dsajc***-002-001-rm2</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>KR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>redisc-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>5461-10922</slotName>
                </cloudRedisServerInstance>
                <cloudRedisServerInstance>
                    <cloudRedisServerInstanceNo>2192***</cloudRedisServerInstanceNo>
                    <cloudRedisServerName>dsaj***-003-001-rm3</cloudRedisServerName>
                    <cloudRedisServerRole>
                        <code>M</code>
                        <codeName>Master</codeName>
                    </cloudRedisServerRole>
                    <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                    <cloudRedisServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudRedisServerInstanceStatus>
                    <cloudRedisServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudRedisServerInstanceOperation>
                    <cloudRedisProductCode>SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002</cloudRedisProductCode>
                    <regionCode>KR</regionCode>
                    <vpcNo>16**</vpcNo>
                    <subnetNo>55**</subnetNo>
                    <privateDomain>redisc-****.vpc-cdb.ntruss.com</privateDomain>
                    <cpuCount>4</cpuCount>
                    <memorySize>1610612736</memorySize>
                    <osMemorySize>2147483648</osMemorySize>
                    <uptime>2022-02-21T15:11:52+0900</uptime>
                    <createDate>2022-02-21T14:58:44+0900</createDate>
                    <slotName>10923-16383</slotName>
                </cloudRedisServerInstance>
            </cloudRedisServerInstanceList>
        </cloudRedisInstance>
    </cloudRedisInstanceList>
</rebootCloudRedisServerInstanceResponse>
```