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

VPC環境で利用できます。

Cloud DB for Cacheサーバインスタンスを再起動します。

参考

Cloud DB for Cache CLIは、対応する DBMSの範囲に応じて2つのバージョンを提供しています。

  • 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を参照

共通オプション

vcacheコマンドで共通して使用するオプションについては、Cloud DB for Cache (VPC)のオプションを参照してください。

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を参照

共通オプション

vredisコマンドで共通して使用するオプションについては、Cloud DB for Cache (VPC)のオプションを参照してください。

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"
  }
}