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

Prev Next

Available in VPC

Restart a Cloud DB for Cache server instance.

Note

Cloud DB for Cache CLI offers two versions based on the supported DBMS range.

  • rebootCloudCacheServerInstance CLI: Support for Valkey and Redis DBMS
  • rebootCloudRedisServerInstance CLI: Support for Redis DBMS

rebootCloudCacheServerInstance CLI

This section describes the command syntax, options, commands, and output examples for the rebootCloudCacheServerInstance CLI.

Syntax

The rebootCloudCacheServerInstance syntax is as follows:

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

Options

This section describes the options available when running rebootCloudCacheServerInstance.

Required options

The following options are required for rebootCloudCacheServerInstance.

Options Type Required Description
--cloudCacheServerInstanceNo String Required Cloud DB for Cache server instance number
  • Restarts can cause data loss, and for standalone servers without the high availability feature enabled, all data is deleted.
  • On Cache Cluster products with high availability (HA) enabled, restarting the master occurs after a failover, so the role changes after the restart.
  • See getCloudCacheInstanceList.

Common options

For information about the options common to all vcache subcommands, see Cloud DB for Cache (VPC) options.

Examples

If the request to restart a Cloud DB for Cache server instance is successful, the configuration information for the Cloud DB for Cache instance and the details for each server instance are returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "rebootCloudCacheServerInstanceResponse": {
    "totalRows": 1,
    "cloudCacheInstanceList": [
      {
        "cloudCacheInstanceNo": "34567890",
        "cloudCacheServiceName": "test-cache-01",
        "cloudCacheInstanceStatusName": "shuttingDown",
        "cloudCacheInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE (VPC) Created status"
        },
        "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": "License code - 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "STOP",
              "codeName": "CLOUD DATABASE (VPC) server 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) server Running status"
            },
            "cloudCacheServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server 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

This section describes the command syntax, options, commands, and output examples for the rebootCloudRedisServerInstance CLI.

Syntax

The rebootCloudRedisServerInstance syntax is as follows:

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

Options

This section describes the options available when running rebootCloudRedisServerInstance.

Required options

The following options are required for rebootCloudRedisServerInstance.

Options Type Required Description
--cloudRedisServerInstanceNo String Required Cloud DB for Cache server instance number
  • Restarts can cause data loss, and for standalone servers without the high availability feature enabled, all data is deleted.
  • On Cache Cluster products with high availability (HA) enabled, restarting the master occurs after a failover, so the role changes after the restart.
  • See getCloudCacheInstanceList.

Common options

For information about the options common to all vredis subcommands, see Cloud DB for Cache (VPC) options.

Examples

If the request to restart a Cloud DB for Cache server instance is successful, the configuration information for the Cloud DB for Cache instance and the details for each server instance are returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "rebootCloudRedisServerInstanceResponse": {
    "totalRows": 1,
    "cloudRedisInstanceList": [
      {
        "cloudRedisInstanceNo": "34567890",
        "cloudRedisServiceName": "test-redis-01",
        "cloudRedisInstanceStatusName": "shuttingDown",
        "cloudRedisInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE (VPC) Created status"
        },
        "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": "License code - 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) server Running status"
            },
            "cloudRedisServerInstanceOperation": {
              "code": "STOP",
              "codeName": "CLOUD DATABASE (VPC) server 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"
  }
}