--- title: "createServerInstances" slug: "cli-vserver-server-createserverinstances" tags: ["Server", "VPC"] updated: 2026-09-17T10:11:00Z published: 2026-09-17T10:11:00Z canonical: "cli.ncloud-docs.com/cli-vserver-server-createserverinstances" --- > ## 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. # createServerInstances VPC環境で利用できます。 サーバインスタンス(VM)を作成します。 ## 構文 `createServerInstances`構文は次の通りです。 ``` ./ncloud vserver createServerInstances \ --vpcNo \ --subnetNo \ --networkInterfaceList \ --memberServerImageInstanceNo | --serverImageNo | --serverImageProductCode \ [--serverSpecCode ] \ [--serverProductCode ] \ [--raidTypeName ] \ [--blockDevicePartitionList ] \ [--blockStorageMappingList ] \ [--isEncryptedBaseBlockStorageVolume ] \ [--feeSystemTypeCode ] \ [--serverCreateCount ] \ [--serverCreateStartNo ] \ [--serverName ] \ [--placementGroupNo ] \ [--isProtectServerTermination ] \ [--serverDescription ] \ [--initScriptNo ] \ [--loginKeyName ] \ [--associateWithPublicIp ] \ [--fabricClusterPoolNo ] \ [--isPreInstallGpuDriver ] \ [--regionCode ] \ [--output ] ``` ## オプション `createServerInstances`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createServerInstances`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | VPC番号 - サーバインスタンスを作成する VPCを設定 - [getVpcList](/docs/ja/cli-vpc-vpcmanagement-getvpclist)を参照 | | `--subnetNo` | String | Required | Subnet番号 - 基本ネットワークインターフェースの Subnet設定 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--networkInterfaceList` | List | Required | ネットワークインターフェースリスト - 各ネットワークインターフェースは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `networkInterfaceOrder` (必須): ネットワークインターフェースの順番。`0`~`2` (基本ネットワークインターフェース: `0`). 最大3個まで入力可能。デバイスの命名基準として使用 (例: 順番が`2`の場合、デバイス名は`eth2`) - `networkInterfaceNo` (条件付き): ネットワークインターフェース番号。ユーザーが直接作成したネットワークインターフェースの追加時、必ず入力。[getNetworkInterfaceList](/docs/ja/cli-vserver-networkinterface-getnetworkinterfacelist)を参照 - `subnetNo` (条件付き): ネットワークインターフェースの Subnet番号。ネットワークインターフェースの新規作成、または`networkInterfaceNo`入力時、必ず入力。基本ネットワークインターフェースの場合、自動割り当て。[getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 - `ip` (任意): ネットワークインターフェースの IPアドレス。未入力時、条件を満たす値を順次自動的に割り当て。ネットワークインターフェースの新規作成時、直接設定可能。ネットワークインターフェースが作成される Subnetの IPアドレス範囲内で入力 (Subnetの0~5番目、最後の IPアドレスは使用不可、Subnetの範囲内で IPアドレスは重複不可) - `accessControlGroupNoList` (条件付き): ネットワークインターフェースの ACG番号リスト。ネットワークインターフェースの新規作成時、必ず入力。最大3個まで入力可能。[getAccessControlGroupList](/docs/ja/cli-vserver-acg-getaccesscontrolgrouplist)を参照 | | `--memberServerImageInstanceNo` | String | Conditional | サーバイメージインスタンス番号 - ユーザーが作成したサーバイメージでサーバ作成時、入力 - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getMemberServerImageInstanceList](/docs/ja/cli-vserver-serverimage-getmemberserverimageinstancelist)を参照 | | `--serverImageNo` | String | Conditional | サーバイメージ番号 - 新規サーバイメージでサーバ作成時、入力 (KVM、RHV、XEN) - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getServerImageList](/docs/ja/cli-vserver-serverimage-getserverimagelist)を参照 | | `--serverImageProductCode` | String | Conditional | サーバイメージ商品コード - 新規サーバイメージでサーバ作成時、入力 (RHV、XEN) - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getServerImageProductList](/docs/ja/cli-vserver-server-common-getserverimageproductlist)を参照 | | `--serverSpecCode` | String | Conditional | サーバスペックコード - `serverImageNo`使用時、サーバスペックを設定 - デフォルト: 最小スペック(メモリ、CPU、基本ブロックストレージ容量、ディスクタイプ(`NET`)の順) - `serverProductCode`とは同時使用不可。 - [getServerSpecList](/docs/ja/cli-vserver-server-common-getserverspeclist)を参照 | | `--raidTypeName` | String | Conditional | RAIDタイプ名 - ベアメタルサーバ作成時、必ず入力 - [getRaidList](/docs/ja/cli-vserver-server-common-getraidlist)を参照 | ### 任意オプション `createServerInstances`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--serverProductCode` | String | Optional | サーバ商品コード - `serverImageProductCode`使用時、サーバスペックを設定 - デフォルト: 最小スペック(メモリ、CPU、基本ブロックストレージ容量、ディスクタイプ(`NET`)の順) `serverSpecCode`とは同時使用不可。[getServerProductList](/docs/ja/cli-vserver-server-common-getserverproductlist)を参照 | | `--blockDevicePartitionList` | List | Optional | ブロックデバイスのパーティションリスト - ベアメタルサーバに適用され、サーバのスペックによってはパーティション機能がサポートされない場合がある - 各パーティションは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `mountPoint` (任意): マウントポイント。`/`(root)パスで始める (最初のマウントポイントは必ず`/`(root)で入力)。`/`配下のパスは、英字の小文字と数字のみ使用可能で、先頭文字には英字の小文字のみ使用。OSごとのシステムディレクトリとして使用されているパス名は入力不可 (例: `/root`、`/bin`、`/dev`) - `partitionSize` (任意): パーティション容量。50GB以上 | | `--blockStorageMappingList` | List | Optional | ブロックストレージマッピングリスト - 各ストレージは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `order` (必須): ストレージの順番。`0`~`20`. 基本ストレージ(`order=0`)は必ず1個割り当てる必要があり、最大20個まで追加可能 (基本ストレージを含めて最大21個)。KVMのみ使用可能。 - `snapshotInstanceNo` (任意): ストレージスナップショットインスタンス番号。スナップショットで作成時に入力。KVMのみ使用可能。 - `blockStorageSize` (任意): ストレージ容量。KVMのみ使用可能 - `blockStorageName` (任意): ストレージ名。KVMのみ使用可能 - `blockStorageVolumeTypeCode` (任意): ストレージボリュームタイプコード。KVMのみ使用可能。[getBlockStorageVolumeTypeList](/docs/ja/cli-vserver-storage-getblockstoragevolumetypelist)を参照 - `noBlockStorage` (条件付き): ストレージを除外するか。`true` (除外) \| `false` (除外しない、`snapshotInstanceNo`は必ず入力)。基本ストレージとして使用不可 - `emptyBlockStorage` (条件付き): 新規ストレージを作成するか。`true` (作成) \| `false` (作成しない、`snapshotInstanceNo`は必ず入力)。基本ストレージとして使用不可 | | `--isEncryptedBaseBlockStorageVolume` | Boolean | Optional | 基本ブロックストレージボリュームを暗号化するか - `true` \| `false` (デフォルト) - `true`: 暗号化 - `false`: 暗号化しない - RHVサーバイメージでのみ設定可能 | | `--feeSystemTypeCode` | String | Optional | 料金プランのタイプコード - `MTRAT` (デフォルト) \| `FXSUM` - `MTRAT`: 時間制料金プラン (従量制) - `FXSUM`: 月額料金プラン (定額制) | | `--serverCreateCount` | Integer | Optional | サーバ作成数 - `1`~`100` (デフォルト: `1`) | | `--serverCreateStartNo` | Integer | Optional | サーバ作成開始番号 - `0`~`999` (デフォルト: `1`) - 2台以上のサーバを作成する際、サーバ名に付与されるシリアル番号の開始番号を決定 - `serverCreateStartNo`と`serverCreateCount`の合計は1,000以下 | | `--serverName` | String | Optional | サーバ名 - 未入力時、自動作成 - 文字列の先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - 英字の小文字、数字、記号の`-`を組み合わせて3~40文字以内で入力 (Windows Serverの場合は3~15文字) | | `--placementGroupNo` | String | Optional | 物理配置グループ番号 - サーバが属する物理配置グループを設定 - [getPlacementGroupList](/docs/ja/cli-vserver-server-placementgroup-getplacementgrouplist)を参照 | | `--isProtectServerTermination` | Boolean | Optional | 返却保護にするか - 誤って返却する事故を防止 - `true` \| `false` (デフォルト) - `true`: 保護 - `false`: 保護しない | | `--serverDescription` | String | Optional | サーバの説明(Byte) - 0~1,000 | | `--initScriptNo` | String | Optional | 初期化スクリプト番号 - 最初の起動時、ユーザーが設定した初期化スクリプトを実行 - [getInitScriptList](/docs/ja/cli-vserver-initscript-getinitscriptlist)を参照 | | `--loginKeyName` | String | Optional | 認証キー名 - 最近作成の認証キー - [getLoginKeyList](/docs/ja/cli-vserver-server-loginkey-getloginkeylist)を参照 | | `--associateWithPublicIp` | Boolean | Optional | パブリック IPアドレスの新規作成・割り当て - `true` \| `false` (デフォルト) - `true`: 割り当て - `false`: 割り当てしない - サーバの作成後に運用中状態に変更時、割り当て完了 - Public Subnetの場合、使用可能 - `serverCreateCount`が1の場合、使用可能 | | `--fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool番号 - [getFabricClusterPoolList](/docs/ja/cli-vserver-fabriccluster-getfabricclusterpoollist)を参照 | | `--isPreInstallGpuDriver` | Boolean | Optional | GPU Driverを事前にインストールするか - `true` \| `false` (デフォルト) - `true`: インストール - `false`: インストールしない | ### 共通オプション `vserver`コマンドで共通して使用するオプションについては、[Server (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)を参照してください。 ## 例 サーバインスタンスの作成リクエストが成功すると、サーバインスタンスの識別情報と初期状態が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./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" } } ```