changeServerInstanceSpec

Available in VPC

Change the specifications of a stopped server instance (VM).

Syntax

The changeServerInstanceSpec syntax is as follows:

./ncloud vserver changeServerInstanceSpec \
    --serverInstanceNo <server-instance-no> \
    --serverSpecCode <server-spec-code> | --serverProductCode <server-product-code> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeServerInstanceSpec.

Required options

The following options are required for changeServerInstanceSpec.

Options	Type	Required	Description
`--serverInstanceNo`	String	Required	Server instance number See getServerInstanceList.
`--serverSpecCode`	String	Conditional	Server spec code (KVM, RHV, XEN) Can only be changed within the same product type (`productType`) and detailed disk type (`diskDetailType[HDD, SSD]`). Can't be used ad the same time with `serverProductCode`. See getServerSpecList.
`--serverProductCode`	String	Conditional	Server product code (KVM, RHV, XEN) Can only be changed within the same product type (`productType`) and detailed disk type (`diskDetailType[HDD, SSD]`). Can't be used at the same time with `serverSpecCode`. See getServerProductList.

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the request to change the server specifications is successful, the latest information about the server is returned.

Command

The command example is as follows:

./ncloud vserver changeServerInstanceSpec \
    --serverInstanceNo 34567890 \
    --serverProductCode SVR.VSVR.HICPU.C004.M008.NET.SSD.B050.G002 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "changeServerInstanceSpecResponse": {
    "totalRows": 1,
    "serverInstanceList": [
      {
        "serverInstanceNo": "34567890",
        "serverName": "test-server-renamed-01",
        "cpuCount": 2,
        "memorySize": 4294967296,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "test-server-instance-key-01",
        "serverInstanceStatus": {
          "code": "NSTOP",
          "codeName": "Server NORMAL STOPPED status"
        },
        "serverInstanceOperation": {
          "code": "CHNG",
          "codeName": "Server SPEC CHANGE OP"
        },
        "serverInstanceStatusName": "changingSpec",
        "createDate": "2026-05-14T17:29:35+0900",
        "uptime": "2026-05-14T17:40:21+0900",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
        "serverProductCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002",
        "isProtectServerTermination": false,
        "zoneCode": "KR-1",
        "regionCode": "KR",
        "vpcNo": "12345678",
        "subnetNo": "23456789",
        "networkInterfaceNoList": [
          "56789012"
        ],
        "serverInstanceType": {
          "code": "HICPU",
          "codeName": "High-CPU"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "Network storage"
        },
        "baseBlockStorageDiskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "hypervisorType": {
          "code": "XEN",
          "codeName": "XEN"
        },
        "serverImageNo": "45678901",
        "serverSpecCode": "c2-g2-s50",
        "eventList": [],
        "isPreInstallGpuDriver": false
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index