--- title: "createServerInstances" slug: "compute-vserver-server-createserverinstances" updated: 2026-09-17T09:57:39Z published: 2026-09-17T09:57:39Z canonical: "api.ncloud-docs.com/compute-vserver-server-createserverinstances" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createServerInstances VPC環境で利用できます。 サーバインスタンス(VM)を作成します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET \| POST | /vserver/v2/createServerInstances | 参考 ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。 ### リクエストヘッダ Server APIで共通して使用されるヘッダの詳細は、[Serverのリクエストヘッダ](/docs/ja/compute-vserver#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `regionCode` | String | Optional | リージョンコード - [getRegionList](/docs/ja/compute-vserver-server-common-getregionlist)を参照 - 照会結果の最初のリージョン(デフォルト) | | `memberServerImageInstanceNo` | String | Conditional | サーバイメージインスタンス番号 - ユーザーが作成したサーバイメージでサーバ作成時、入力 - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getMemberServerImageInstanceList](/docs/ja/compute-vserver-serverimage-getmemberserverimageinstancelist)を参照 | | `serverImageNo` | String | Conditional | サーバイメージ番号 - 新規サーバイメージでサーバ作成時、入力 (KVM、RHV、XEN) - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getServerImageList](/docs/ja/compute-vserver-serverimage-getServerImageList)を参照 | | `serverImageProductCode` | String | Conditional | サーバイメージ商品コード - 新規サーバイメージでサーバ作成時、入力 (RHV、XEN) - `memberServerImageInstanceNo`、`serverImageNo`、`serverImageProductCode`のうち、いずれか1つは必ず入力 - [getServerImageProductList](/docs/ja/compute-vserver-server-common-getserverimageproductlist)を参照 | | `serverSpecCode` | String | Conditional | サーバスペックコード - `serverImageNo`使用時、サーバスペックを設定 - デフォルト: 最小スペック(メモリ、CPU、基本ブロックストレージ容量、ディスクタイプ(NET)の順) - [getServerSpecList](/docs/ja/compute-vserver-server-common-getserverspeclist)を参照 | | `serverProductCode` | String | Optional | サーバ商品コード - `serverImageProductCode`使用時、サーバスペックを設定 - デフォルト: 最小スペック(メモリ、CPU、基本ブロックストレージ容量、ディスクタイプ(NET)の順) - [getServerProductList](/docs/ja/compute-vserver-server-common-getserverproductlist)を参照 | | `vpcNo` | String | Required | VPC番号 - サーバインスタンスを作成する VPCを設定 - [getVpcList](/docs/ja/networking-vpc-vpcmanagement-getvpclist)を参照 | | `subnetNo` | String | Required | Subnet番号 - デフォルトのネットワークインターフェースの Subnet設定 - [getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 | | `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`の合計は1000以内 | | `serverName` | String | Optional | サーバ名 - 英字の小文字、数字、記号の「-」を組み合わせて3~40文字以内で入力 (Windows Serverの場合、3~15文字) - 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - 未入力時、自動作成 (デフォルト) | | `networkInterfaceList.N.networkInterfaceOrder` | Integer | Required | ネットワークインターフェースの順序 - 0~2 - デフォルトのネットワークインターフェース: 0 - 最大3個まで入力可能 - デバイス命名規則の基準として使用 - 例) 順序が2の場合、デバイス名は eth2 | | `networkInterfaceList.N.networkInterfaceNo` | String | Conditional | ネットワークインターフェース番号 - ユーザーが直接作成したネットワークインターフェース追加時、必ず入力 - [getNetworkInterfaceList](/docs/ja/compute-vserver-networkinterface-getnetworkinterfacelist)を参照 | | `networkInterfaceList.N.subnetNo` | String | Conditional | ネットワークインターフェースの Subnet番号 - 新規ネットワークインターフェースの作成または`networkInterfaceNo`入力時、必ず入力 - デフォルトのネットワークインターフェースの場合、自動割り当て - [getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 | | `networkInterfaceList.N.ip` | String | Optional | ネットワークインターフェースの IPアドレス - 新規ネットワークインターフェース作成時、直接設定可能 - ネットワークインターフェースが作成される Subnetの IPアドレス範囲内で入力 - Subnetの0~5番目、最後の IPアドレスは使用不可 - Subnet範囲内で IPアドレスは重複不可 - 入力しないと条件を満たす値を順次自動割り当て (デフォルト) | | `networkInterfaceList.N.accessControlGroupNoList.N` | Array | Conditional | ネットワークインターフェースの ACG番号リスト - 新規ネットワークインターフェース作成時、必ず入力 - 最大3個まで入力可能 - 例) `accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345` - [getAccessControlGroupList](/docs/ja/compute-vserver-acg-getaccesscontrolgrouplist)を参照 | | `placementGroupNo` | String | Optional | 物理配置グループ番号 - サーバが属する物理配置グループを設定 - [getPlacementGroupList](/docs/ja/compute-vserver-server-placementgroup-getplacementgrouplist)を参照 | | `isProtectServerTermination` | Boolean | Optional | 返却保護にするか - 誤って返却する事故を防止 - `true` \| `false` (デフォルト) - `true`: 保護 - `false`: 保護しない | | `serverDescription` | String | Optional | サーバの説明(Byte) - 0~1000 | | `initScriptNo` | String | Optional | 初期化スクリプト番号 - 最初の起動時、ユーザーが設定した初期化スクリプトを実行 - [getInitScriptList](/docs/ja/compute-vserver-initscript-getinitscriptlist)を参照 | | `loginKeyName` | String | Optional | 認証キー名 - [getLoginKeyList](/docs/ja/compute-vserver-server-loginkey-getloginkeylist)を参照 - デフォルト: 最近作成した認証キー | | `associateWithPublicIp` | Boolean | Optional | 新規パブリック IPアドレスの作成・割り当て - `true` \| `false` (デフォルト) - `true`: 割り当て - `false`: 割り当てしない - Public Subnetの場合、使用可能 - `serverCreateCount`が1の場合、使用可能 - サーバの作成後に運用中状態に変更時、割り当て完了 | | `raidTypeName` | String | Conditional | RAIDタイプ名 - ベアメタルサーバ作成時、必ず入力 - [getRaidList](/docs/ja/compute-vserver-server-common-getraidlist)を参照 | | `blockDevicePartitionList.N.mountPoint` | String | Optional | マウントポイント - `/(root)`パスで始まるマウントポイントを入力 - 最初のマウントポイントは、必ず`/(root)`を入力 - `/`配下パスは英小文字、数にのみ使用可能で、先頭文字は英小文字のみ使用 - OSごとにシステムディレクトリとして使用中のパス名は入力不可 - 例) /root、/bin、/dev | | `blockDevicePartitionList.N.partitionSize` | String | Optional | パーティション容量 - 50GB以上 | | `blockStorageMappingList.N.order` | Integer | Required | 作成ストレージの順序 - KVMのみ使用可能 - 基本ストレージは必ず1個割り当て - 基本ストレージ: 0 - 追加ストレージ: 1~20 - 基本ストレージを含めて最大21個まで割り当て可能 | | `blockStorageMappingList.N.snapshotInstanceNo` | String | Optional | 作成ストレージスナップショット番号 - スナップショットで作成時、入力 - KVMのみ使用可能 | | `blockStorageMappingList.N.blockStorageSize` | String | Optional | 作成ストレージの容量 - KVMのみ使用可能 | | `blockStorageMappingList.N.blockStorageName` | String | Optional | 作成ストレージ名 - KVMのみ使用可能 | | `blockStorageMappingList.N.blockStorageVolumeTypeCode` | String | Optional | 作成ストレージボリュームタイプコード - KVMのみ使用可能 - [getBlockStorageVolumeTypeList](/docs/ja/compute-vserver-storage-getblockstoragevolumetypelist)を参照 | | `blockStorageMappingList.N.noBlockStorage` | Boolean | Conditional | ストレージを除外するか - `true` \| `false` - `true`: 除外 - `false`: 除外しない (`snapshotInstanceNo`は必ず入力) - 基本ストレージとして使用不可 | | `blockStorageMappingList.N.emptyBlockStorage` | Boolean | Conditional | 新規ストレージを作成するか - `true` \| `false` - `true`: 作成 - `false`: 作成しない (`snapshotInstanceNo`は必ず入力) - 基本ストレージとして使用不可 | | `fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool番号 - [getFabricClusterPoolList](/docs/ja/compute-vserver-fabriccluster-getfabricclusterpoollist)を参照 | | `isPreInstallGpuDriver` | Boolean | Optional | GPU Driverを事前にインストールするか - `true` \| `false` (デフォルト) | | `responseFormatType` | String | Optional | レスポンスデータの形式 - `xml`(デフォルト) \| `json` | 参考 リクエストクエリパラメータの入力時、下記の内容をご確認ください。 - 新規サーバイメージでサーバを作成する場合、作成するサーバのハイパーバイザタイプによって使用可能なフィールドが次のように異なります。 - KVM: `serverImageNo`と`serverSpecCode`を使用 - XEN: `serverImageNo`と`serverSpecCode`または`serverImageProductCode`と`serverProductCode`を使用 - RHV: `serverImageNo`と`serverSpecCode`または`serverImageProductCode`と`serverProductCode`を使用 - `associateWithPublicIp`: パブリック IPアドレスの割り当て後は料金が発生しますので、使用しない場合は返却してください。 - `blockDevicePartitionList.N.mountPoint`: 作成するサーバスペックによってはパーティションをサポートしていない場合があります。 ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vserver/v2/createServerInstances ?regionCode=KR &serverImageProductCode=SW.VSVR.OS.LNX64.UBNTU.SVR2004.B050 &vpcNo=***75 &subnetNo=***36 &serverProductCode=SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002 &feeSystemTypeCode=MTRAT &serverCreateCount=1 &serverName=test-*** &networkInterfaceList.1.networkInterfaceOrder=0 &networkInterfaceList.1.accessControlGroupNoList.1=***43 &isProtectServerTermination=false &loginKeyName=test-*** &associateWithPublicIp=true &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `createServerInstancesResponse` | Object | - | レスポンス結果 - [ServerInstanceList](/docs/ja/common-vapidatatype-serverinstancelist)を参照 | | `createServerInstancesResponse.requestId` | String | - | リクエスト ID - UUID形式 | | `createServerInstancesResponse.returnCode` | String | - | レスポンスコード | | `createServerInstancesResponse.returnMessage` | String | - | レスポンスメッセージ | ### レスポンスステータスコード Server APIで共通して使用されるレスポンスステータスコードの詳細は、[Serverのレスポンスステータスコード](/docs/ja/compute-vserver#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "createServerInstancesResponse": { "totalRows": 1, "serverInstanceList": [ { "serverInstanceNo": "*****9212", "serverName": "test-***", "serverDescription": "", "cpuCount": 2, "memorySize": 8589934592, "platformType": { "code": "UBS64", "codeName": "Ubuntu Server 64 Bit" }, "loginKeyName": "test-***", "publicIpInstanceNo": "", "publicIp": "", "serverInstanceStatus": { "code": "INIT", "codeName": "サーバ INIT状態" }, "serverInstanceOperation": { "code": "NULL", "codeName": "サーバ NULL OP" }, "serverInstanceStatusName": "init", "createDate": "2025-06-13T17:01:34+0900", "uptime": "2025-06-13T17:01:33+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.UBNTU.SVR2004.B050", "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "", "subnetNo": "", "networkInterfaceNoList": [], "initScriptNo": "", "serverInstanceType": { "code": "STAND", "codeName": "Standard" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "ネットワークストレージ" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "placementGroupNo": "", "placementGroupName": "", "memberServerImageInstanceNo": "", "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "16187005", "serverSpecCode": "s2-g2-s50", "eventList": [] } ], "requestId": "e4a3ca5e-9b81-4b3b-8011-ad0f0e2bf71a", "returnCode": "0", "returnMessage": "success" } } ```