addPlacementGroupServerInstance

Available in VPC

Add a server instance to a physical deployment group.

Syntax

The addPlacementGroupServerInstance syntax is as follows:

./ncloud vserver addPlacementGroupServerInstance \
    --placementGroupNo <placement-group-no> \
    --serverInstanceNo <server-instance-no> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running addPlacementGroupServerInstance.

Required options

The following options are required for addPlacementGroupServerInstance.

Common options

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

Examples

If the request to add a server instance to a physical deployment group is successful, the identification and configuration information for the added server instance is returned.

Command

The command example is as follows:

./ncloud vserver addPlacementGroupServerInstance \
    --placementGroupNo 91234567 \
    --serverInstanceNo 34567890 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "addPlacementGroupServerInstanceResponse": {
    "totalRows": 1,
    "serverInstanceList": [
      {
        "serverInstanceNo": "34567890",
        "serverName": "test-server-01",
        "cpuCount": 2,
        "memorySize": 8589934592,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "test-login-key-01",
        "serverInstanceStatus": {
          "code": "RUN",
          "codeName": "Server RUN status"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "Server NULL OP"
        },
        "serverInstanceStatusName": "running",
        "createDate": "2026-04-28T13:01:30+0900",
        "uptime": "2026-04-28T13:03:43+0900",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003",
        "serverProductCode": "SVR.VSVR.AMD.STAND.C002.M008.G003",
        "isProtectServerTermination": false,
        "zoneCode": "KR-1",
        "regionCode": "KR",
        "vpcNo": "12345678",
        "subnetNo": "23456789",
        "networkInterfaceNoList": [
          "56789012"
        ],
        "serverInstanceType": {
          "code": "STAND",
          "codeName": "Standard"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "Network storage"
        },
        "baseBlockStorageDiskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "placementGroupNo": "91234567",
        "placementGroupName": "test-pg-01",
        "hypervisorType": {
          "code": "KVM",
          "codeName": "KVM"
        },
        "serverImageNo": "45678901",
        "serverSpecCode": "s2-g3a",
        "eventList": [],
        "isPreInstallGpuDriver": false
      }
    ],
    "requestId": "d4e5f6a7-b8c9-0123-def0-456789012345",
    "returnCode": "0",
    "returnMessage": "success"
  }
}