---
title: "changeServerInstanceName"
slug: "changeserverinstancename"
updated: 2026-09-17T10:08:33Z
published: 2026-09-17T10:08:33Z
canonical: "cli.ncloud-docs.com/changeserverinstancename"
---

> ## 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.

# 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](/docs/en/cli-vserver-server-getserverinstancelist). |
| `--serverName` | String | Required | Name of server to change to - Enter 3 to 40 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](/docs/en/cli-vserver#%EC%98%B5%EC%85%98).

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