changeServerInstanceName

Available in VPC

Change the name of a server instance (VM). The host name won't be changed.

Syntax

The changeServerInstanceName syntax is as follows:

./ncloud vserver changeServerInstanceName \
    --serverInstanceNo <server-instance-no> \
    --serverName <server-name> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeServerInstanceName.

Required options

The following options are required for changeServerInstanceName.

Options	Type	Required	Description
`--serverInstanceNo`	String	Required	Server instance number See getServerInstanceList.
`--serverName`	String	Required	Name of server to change to Enter 3 to 30 characters using a combination of lowercase English letters, numbers, and the special character `-` (3-15 characters for a Windows Server). The string must start with a lowercase English letter and end with a lowercase English letter or a number.

Common options

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

Examples

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

Command

The command example is as follows:

./ncloud vserver changeServerInstanceName \
    --serverInstanceNo 34567890 \
    --serverName test-server-renamed-01 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "changeServerInstanceNameResponse": {
    "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": "RUN",
          "codeName": "Server RUN status"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "Server NULL OP"
        },
        "serverInstanceStatusName": "running",
        "createDate": "2026-05-14T17:29:35+0900",
        "uptime": "2026-05-14T17:34:00+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