---
title: "rebootCloudCacheServerInstance"
slug: "cli-vcache-rebootcloudcacheserverinstance"
tags: ["Cloud DB for Cache", "VPC"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-vcache-rebootcloudcacheserverinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# rebootCloudCacheServerInstance

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

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

참고

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

- rebootCloudCacheServerInstance CLI: Valkey, Redis DBMS 이용 가능
- rebootCloudRedisServerInstance CLI: Redis DBMS 이용 가능

## rebootCloudCacheServerInstance CLI

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

### 구문

`rebootCloudCacheServerInstance` 구문은 다음과 같습니다.

```
./ncloud vcache rebootCloudCacheServerInstance \
    --cloudCacheServerInstanceNo <server-instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### 옵션

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

#### 필수 옵션

`rebootCloudCacheServerInstance`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudCacheServerInstanceNo` | String | Required | Cloud DB for Cache 서버 인스턴스 번호 - 재시작으로 인해 데이터 손실이 발생할 수 있으며, 고가용성 기능을 사용하지 않은 단독(Standalone) 서버의 경우, 모든 데이터가 삭제됨 - 고가용성(HA)을 지원하는 Cache Cluster 상품에서 Master를 재시작할 경우, 페일오버 후 진행되므로 재시작 후 역할이 변경됨 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |

#### 공통 옵션

`vcache` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache (VPC) 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

Cloud DB for Cache 서버 인스턴스 재시작 요청이 성공하면 Cloud DB for Cache 인스턴스의 구성 정보와 각 서버 인스턴스의 상세 정보가 반환됩니다.

#### 명령

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

```
./ncloud vcache rebootCloudCacheServerInstance \
    --cloudCacheServerInstanceNo 45678902 \
    --regionCode KR \
    --output json
```

#### 출력

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

```
{
  "rebootCloudCacheServerInstanceResponse": {
    "totalRows": 1,
    "cloudCacheInstanceList": [
      {
        "cloudCacheInstanceNo": "34567890",
        "cloudCacheServiceName": "test-cache-01",
        "cloudCacheInstanceStatusName": "shuttingDown",
        "cloudCacheInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "cloudCacheInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null OP"
        },
        "cloudCacheImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050",
        "engineVersion": "VALKEY 7.2.11",
        "license": {
          "code": "BSD",
          "codeName": "라이센스코드-CLOUD DATABASE(VPC)"
        },
        "cloudCachePort": 13306,
        "isHa": true,
        "isBackup": true,
        "backupTime": "01:45",
        "backupFileRetentionPeriod": 1,
        "backupSchedule": "AUTO",
        "cloudCacheServerPrefix": "testcache",
        "generationCode": "G2",
        "role": {
          "code": "CLUSTER",
          "codeName": "Cluster Role-CLOUD Cache(VPC)"
        },
        "createDate": "2026-06-10T14:46:18+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "masterNodeCount": 3,
        "slaveNodeCount": 3,
        "configGroupNo": "11099",
        "configGroupName": "test-cfg-01",
        "cloudCacheServerInstanceList": [
          {
            "cloudCacheServerInstanceNo": "45678901",
            "cloudCacheServerName": "testcache-001-001-98g5",
            "cloudCacheServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudCacheServerInstanceStatusName": "running",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c1.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:52:02+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "0-5460"
          },
          {
            "cloudCacheServerInstanceNo": "45678905",
            "cloudCacheServerName": "testcache-002-002-98g9",
            "cloudCacheServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudCacheServerInstanceStatusName": "running",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c5.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:51:46+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "5461-10922"
          },
          {
            "cloudCacheServerInstanceNo": "45678903",
            "cloudCacheServerName": "testcache-003-001-98g7",
            "cloudCacheServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudCacheServerInstanceStatusName": "running",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c3.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:51:57+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "10923-16383"
          },
          {
            "cloudCacheServerInstanceNo": "45678904",
            "cloudCacheServerName": "testcache-001-002-98g8",
            "cloudCacheServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudCacheServerInstanceStatusName": "running",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c4.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:52:22+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "0-5460"
          },
          {
            "cloudCacheServerInstanceNo": "45678902",
            "cloudCacheServerName": "testcache-002-001-98g6",
            "cloudCacheServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudCacheServerInstanceStatusName": "shuttingDown",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "STOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Stop OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c2.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T15:24:47+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "5461-10922"
          },
          {
            "cloudCacheServerInstanceNo": "45678906",
            "cloudCacheServerName": "testcache-003-002-98ga",
            "cloudCacheServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudCacheServerInstanceStatusName": "running",
            "cloudCacheServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-a1b2c6.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:52:12+0900",
            "createDate": "2026-06-10T14:46:18+0900",
            "slotName": "10923-16383"
          }
        ]
      }
    ],
    "requestId": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

## rebootCloudRedisServerInstance CLI

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

### 구문

`rebootCloudRedisServerInstance` 구문은 다음과 같습니다.

```
./ncloud vredis rebootCloudRedisServerInstance \
    --cloudRedisServerInstanceNo <server-instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

### 옵션

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

#### 필수 옵션

`rebootCloudRedisServerInstance`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudRedisServerInstanceNo` | String | Required | Cloud DB for Cache 서버 인스턴스 번호 - 재시작으로 인해 데이터 손실이 발생할 수 있으며, 고가용성 기능을 사용하지 않은 단독(Standalone) 서버의 경우, 모든 데이터가 삭제됨 - 고가용성(HA)을 지원하는 Cache Cluster 상품에서 Master를 재시작할 경우, 페일오버 후 진행되므로 재시작 후 역할이 변경됨 - [getCloudCacheInstanceList](/docs/cli-vcache-getcloudcacheinstancelist) 참조 |

#### 공통 옵션

`vredis` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for Cache (VPC) 옵션](/docs/cli-vcache#%EC%98%B5%EC%85%98)을 참조해 주십시오.

### 예시

Cloud DB for Cache 서버 인스턴스 재시작 요청이 성공하면 Cloud DB for Cache 인스턴스의 구성 정보와 각 서버 인스턴스의 상세 정보가 반환됩니다.

#### 명령

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

```
./ncloud vredis rebootCloudRedisServerInstance \
    --cloudRedisServerInstanceNo 34567891 \
    --regionCode KR \
    --output json
```

#### 출력

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

```
{
  "rebootCloudRedisServerInstanceResponse": {
    "totalRows": 1,
    "cloudRedisInstanceList": [
      {
        "cloudRedisInstanceNo": "34567890",
        "cloudRedisServiceName": "test-redis-01",
        "cloudRedisInstanceStatusName": "shuttingDown",
        "cloudRedisInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "cloudRedisInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null OP"
        },
        "cloudRedisImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050",
        "engineVersion": "REDIS 7.2.11",
        "license": {
          "code": "BSD",
          "codeName": "라이센스코드-CLOUD DATABASE(VPC)"
        },
        "cloudRedisPort": 6379,
        "isHa": false,
        "isBackup": false,
        "backupTime": "00:00",
        "backupFileRetentionPeriod": 1,
        "backupSchedule": "AUTO",
        "cloudRedisServerPrefix": "testredis",
        "generationCode": "G2",
        "role": {
          "code": "SIMPLE",
          "codeName": "Cluster Role-CLOUD Cache(VPC)"
        },
        "createDate": "2026-07-01T11:43:48+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "masterNodeCount": 1,
        "slaveNodeCount": 0,
        "configGroupNo": "10001",
        "configGroupName": "test-redis-cfg",
        "cloudRedisServerInstanceList": [
          {
            "cloudRedisServerInstanceNo": "34567891",
            "cloudRedisServerName": "testredis-001-9c4s",
            "cloudRedisServerRole": {
              "code": "A",
              "codeName": "Stand Alone"
            },
            "cloudRedisServerInstanceStatusName": "shuttingDown",
            "cloudRedisServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudRedisServerInstanceOperation": {
              "code": "STOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Stop OP"
            },
            "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002",
            "regionCode": "KR",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "privateDomain": "cache-47vd5e.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-07-01T11:49:03+0900",
            "createDate": "2026-07-01T11:43:48+0900"
          }
        ]
      }
    ],
    "requestId": "e5f6a7b8-c9d0-1234-efab-567890123456",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```