stopServerInstances

Available in VPC

Stop a server instance (VM) in operation.

Syntax

The stopServerInstances syntax is as follows:

./ncloud vserver stopServerInstances \
    --serverInstanceNoList <server-instance-no-list> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running stopServerInstances.

Required options

The following options are required for stopServerInstances.

Options	Type	Required	Description
`--serverInstanceNoList`	List	Required	Server instance number list You can enter multiple items separated by spaces. (e.g., `--serverInstanceNoList 1234 2345`) See getServerInstanceList.

Common options

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

Examples

If the server stop request is successful, the server's latest information is returned.

Command

The command example is as follows:

./ncloud vserver stopServerInstances \
    --serverInstanceNoList 34567890 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "stopServerInstancesResponse": {
    "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": "SHTDN",
          "codeName": "Server SHUTDOWN OP"
        },
        "serverInstanceStatusName": "shutting down",
        "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