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.

getCloudCacheInstanceDetail

Prev Next

VPC環境で利用できます。

Cloud DB for Cacheインスタンスの詳細情報を照会します。

参考

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

  • getCloudCacheInstanceDetail CLI: Valkey、Redis DBMSを利用可能
  • getCloudRedisInstanceDetail CLI: Redis DBMSを利用可能

getCloudCacheInstanceDetail CLI

getCloudCacheInstanceDetail CLIのコマンド構文とオプション、コマンドと出力の例について説明します。

構文

getCloudCacheInstanceDetail構文は次の通りです。

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

オプション

getCloudCacheInstanceDetailの実行時に指定できるオプションについて説明します。

必須オプション

getCloudCacheInstanceDetailの必須オプションです。

オプション タイプ 必須の有無 説明
--cloudCacheInstanceNo String Required Cloud DB for Cacheインスタンス番号

共通オプション

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

Cloud DB for Cacheインスタンスの詳細照会リクエストが成功すると、インスタンスの構成情報と各サーバインスタンスの詳細情報が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vcache getCloudCacheInstanceDetail \
    --cloudCacheInstanceNo 34567890 \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "getCloudCacheInstanceDetailResponse": {
    "totalRows": 1,
    "cloudCacheInstanceList": [
      {
        "cloudCacheInstanceNo": "34567890",
        "cloudCacheServiceName": "test-cache-01",
        "cloudCacheInstanceStatusName": "running",
        "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": "45678902",
            "cloudCacheServerName": "testcache-002-001-98g6",
            "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-a1b2c2.vpc-cdb.ntruss.com",
            "cpuCount": 4,
            "memorySize": 1610612736,
            "osMemorySize": 2147483648,
            "uptime": "2026-06-10T14:51:32+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": "45678905",
            "cloudCacheServerName": "testcache-002-002-98g9",
            "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-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": "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": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

getCloudRedisInstanceDetail CLI

getCloudRedisInstanceDetail CLIのコマンド構文とオプション、コマンドと出力の例について説明します。

構文

getCloudRedisInstanceDetail構文は次の通りです。

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

オプション

getCloudRedisInstanceDetailの実行時に指定できるオプションについて説明します。

必須オプション

getCloudRedisInstanceDetailの必須オプションです。

オプション タイプ 必須の有無 説明
--cloudRedisInstanceNo String Required Cloud DB for Cacheインスタンス番号

共通オプション

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

Cloud DB for Cacheインスタンスの詳細照会リクエストが成功すると、インスタンスの構成情報と各サーバインスタンスの詳細情報が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vredis getCloudRedisInstanceDetail \
    --cloudRedisInstanceNo 34567890 \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "getCloudRedisInstanceDetailResponse": {
    "totalRows": 1,
    "cloudRedisInstanceList": [
      {
        "cloudRedisInstanceNo": "34567890",
        "cloudRedisServiceName": "test-redis-01",
        "cloudRedisInstanceStatusName": "running",
        "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": "running",
            "cloudRedisServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC)サーバ Running状態"
            },
            "cloudRedisServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC)サーバ Null 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-01T13:26:30+0900",
            "createDate": "2026-07-01T11:43:48+0900"
          }
        ]
      }
    ],
    "requestId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "returnCode": "0",
    "returnMessage": "success"
  }
}