createServerInstances

VPC環境で利用できます。

サーバインスタンス(VM)を作成します。

構文

createServerInstances構文は次の通りです。

./ncloud vserver createServerInstances \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --networkInterfaceList <network-interface-config> \
    --memberServerImageInstanceNo <member-image-no> | --serverImageNo <image-no> | --serverImageProductCode <image-product-code> \
    [--serverSpecCode <server-spec-code>] \
    [--serverProductCode <server-product-code>] \
    [--raidTypeName <raid-type-name>] \
    [--blockDevicePartitionList <block-device-partition-config>] \
    [--blockStorageMappingList <block-storage-mapping-config>] \
    [--isEncryptedBaseBlockStorageVolume <true|false>] \
    [--feeSystemTypeCode <MTRAT|FXSUM>] \
    [--serverCreateCount <count>] \
    [--serverCreateStartNo <start-no>] \
    [--serverName <server-name>] \
    [--placementGroupNo <placement-group-no>] \
    [--isProtectServerTermination <true|false>] \
    [--serverDescription <description>] \
    [--initScriptNo <init-script-no>] \
    [--loginKeyName <login-key-name>] \
    [--associateWithPublicIp <true|false>] \
    [--fabricClusterPoolNo <fabric-cluster-pool-no>] \
    [--isPreInstallGpuDriver <true|false>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

createServerInstancesの実行時に指定できるオプションについて説明します。

必須オプション

createServerInstancesの必須オプションです。

任意オプション

createServerInstancesの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

共通オプション

vserverコマンドで共通して使用するオプションについては、Server (VPC)のオプションをご参照ください。

例

サーバインスタンスの作成リクエストが成功すると、サーバインスタンスの識別情報と初期状態が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vserver createServerInstances \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --networkInterfaceList "networkInterfaceOrder='0', accessControlGroupNoList=['67890123']" \
    --serverImageProductCode SW.VSVR.OS.LNX64.ROCKY.0810.B050 \
    --serverProductCode SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002 \
    --serverName test-server-01 \
    --loginKeyName test-server-instance-key-01 \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "createServerInstancesResponse": {
    "totalRows": 1,
    "serverInstanceList": [
      {
        "serverInstanceNo": "34567890",
        "serverName": "test-server-01",
        "cpuCount": 2,
        "memorySize": 4294967296,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "test-server-instance-key-01",
        "serverInstanceStatus": {
          "code": "INIT",
          "codeName": "サーバ INIT状態"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "サーバ NULL OP"
        },
        "serverInstanceStatusName": "init",
        "createDate": "2026-05-14T17:29:35+0900",
        "uptime": "2026-05-14T17:29:35+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": "null",
        "networkInterfaceNoList": [],
        "serverInstanceType": {
          "code": "HICPU",
          "codeName": "High-CPU"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "ネットワークストレージ"
        },
        "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"
  }
}