--- title: "createServerInstances" slug: "compute-server-createserverinstances" updated: 2026-09-17T09:57:42Z published: 2026-09-17T09:57:42Z canonical: "api.ncloud-docs.com/compute-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 ## 概要 サーバインスタンス(VM)を作成します。 ## リクエスト ### リクエストパラメータ | パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 | | --- | --- | --- | --- | --- | | serverImageProductCode | Conditional | String | 最小: 1, 最大: 20 | - 作成するサーバイメージを決めるためのサーバイメージ商品コード サーバイメージ商品コード(serverImageProductCode)または会員サーバイメージ番号(memberServerImageNo)の2つのパラメータのうち、どちらか1つのパラメータは必須入力項目 serverImageProductCodesは getServerImageProductListアクションを通じて取得可能 | | serverProductCode | No | String | 最小: 1, 最大: 20 | - 作成するサーバスペックを決めるためのサーバスペック商品コード serverProductCodeはgetServerProductListアクションを通じて取得 デフォルト: 最小スペックが選択される。最小スペックの基準は、1. メモリ 2. CPU 3. 基本ブロックストレージ容量 4. ディスクタイプ(NET、LOCAL)順に最小スペックが選択される | | memberServerImageNo | Conditional | String | | - 会員サーバイメージ番号 直接作成したサーバイメージからサーバを作成する際に必要な値 サーバイメージ商品コード(serverImageProductCode)または会員サーバイメージ番号(memberServerImageNo)の2つのパラメータのうち、どちらか1つのパラメータは必須入力項目 memberServerImageNoは getMemberServerImageListアクションを通じて取得可能 | | serverName | No | String | 最小: 3, 最大: 30 | - 作成するサーバの名 デフォルト: NAVERクラウドプラットフォームが自動で付与 | | serverDescription | No | String | 最小: 1, 最大:1000 | 作成するサーバについての説明 | | loginKeyName | No | String | 最小: 3, 最大: 30 | - 公開鍵で暗号化するログインキー名 デフォルト: 直近で作成されたログインキー名を使用 | | isProtectServerTermination | No | Boolean | | - 返却保護するかどうか 作成時に返却保護するかどうかを設定 オプション: true \| false デフォルト: false | | serverCreateCount | No | Integer | 最小: 1, 最大: 20 | - サーバ作成数 一度に作成するサーバの作成数で、最大20台まで作成できる デフォルト: 1 | | serverCreateStartNo | No | Integer | | - サーバ作成の開始番号 一度に複数台のサーバを作成する場合、サーバ名にシリアル番号が付けられる。シリアル番号の開始番号を設定 サーバ作成数とサーバ作成開始番号の合計が1000を超えてはいけない デフォルト: サーバ作成数(serverCreateCount)が1より大きい場合で、このパラメータ値がない場合は001からスタート | | feeSystemTypeCode | No | String | 最小: 1, 最大: 5 | - 料金プラン区分コード 時間料金プラン(MTRAT)、定額料金プラン(FXSUM)が存在 オプション: MTRAT \| FXSUM デフォルト: MTRAT | | zoneNo | No | String | | - サーバが作成されるゾーンを決定 zoneNoは getZoneListアクションを通じて取得可能 デフォルト: NAVERクラウドプラットフォームで割り当て | | accessControlGroupConfigurationNoList.N | No | String | 最小: 0, 最大: 5 | - ACG設定番号リスト 作成時にユーザーが作成したアクセス制御グループを設定 accessControlGroupConfigurationNoは getAccessControlGroupListアクションを通じて取得可能 デフォルト: default ACG 例) accessControlGroupConfigurationNoList.1=39995 | | userData | No | String | 最小: 1, 最大: 21847 | - ユーザーデータ サーバの最初の起動時に実行されるデータスクリプトを設定 userDataはスクリプト文字列をパラメータで取得する userDataは、getServerInstanceListアクションを通じて特定のインスタンスを照会する場合にのみ返される userData値を入力する前に base64 Encoding、URL Encodingが必要 Base64で Encodingされた結果を再度 URL Encodingしないと、signature invalidエラーが発生 ユーザーデータ(userData)と初期化スクリプト番号(initScriptNo)の2つのパラメータを一緒に渡すと、初期化スクリプトのみ実行される | | initScriptNo | No | String | | - 初期化スクリプト番号 サーバの最初の起動時、ユーザーが設定した初期化スクリプトが実行される 初期化スクリプトの初期化スクリプト番号をパラメータで伝達する ユーザーデータ(userData)と初期化スクリプト番号(initScriptNo)の2つのパラメータを一緒に渡すと、初期化スクリプトのみ実行される initScriptNoは getInitScriptListアクションを通じて取得可能 | | raidTypeName | Conditional | String | | - RAID区分名 ベアメタルサーバを作成するには、raidTypeName値の入力が必要 raidTypeNameは getRaidListアクションを通じて取得可能 | | instanceTagList.N.tagKey | No | String | | - 作成するインスタンスのタグキーを設定 instanceTagList.1.tagKey=sugar | | instanceTagList.N.tagValue | No | String | | - 作成するインスタンスのタグ値 instanceTagList.1.tagValue=salt | | isVaccineInstall | No | Boolean | | - ワクチンをインストールするかどうかを設定できる ベアメタル Windows Server限定 デフォルト値はtrue | | blockDevicePartitionList.N.mountPoint | No | String | 「/」(root)パスで始まるマウントポイントを入力 最初のマウントポイントは必ず「/」(root)パーティション 「/」(root)の下位名称は小文字と数字のみ入力可能で、先頭文字は小文字 OSの種類によっては、/root、/bin、/devなどの特定のキーワードは使用できない | - マウントポイント Bare Metalサーバを作成する場合はパーティションを指定。 サーバスペックによってはパーティション機能がサポートされない場合がある | | blockDevicePartitionList.N.partitionSize | No | String | 最小: 50 GiB | - パーティションサイズ マウントポイントのパーティションサイズを決定 パーティションサイズの合計はサーバスペックの全体容量を超えてはいけない 最後のパーティションのサイズは残り容量が自動で割り当て | | responseFormatType | No | String | | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml | ## レスポンス ### レスポンスボディ - [serverinstancelist](/docs/ja/common-apidatatype-serverinstancelist) ## 例 ### リクエスト例 ``` GET {SERVER_API_URL}/createServerInstances ?serverImageProductCode=SPSW0LINUX000032 &serverProductCode=SPSVRSTAND000004 ``` ### レスポンス例 ``` 3c48425e-ace0-4556-a793-33e91029c06c 0 success 1 1088217 s167545541a3 2 4294967296 53687091200 LNX32 Linux 32 Bit test-key false 10.41.83.168 centos-6.3-32 INIT Server init state NULL Server NULL OP init 2018-11-27T17:42:13+0900 2018-11-27T17:42:13+0900 SPSW0LINUX000032 SPSVRSTAND000004 false 106.10.51.90 3 KR-2 KR-2 坪村ゾーン 1 1 KR Korea NET Network Storage HDD HDD STAND Standard ``` ## エラーコード 以下のエラーコードは、このアクション(Action)で発生する特徴的なエラーです。共通して発生するエラーについての詳細説明は、[NAVERクラウドプラットフォーム API](/docs/ja/common-ncpapi-index)をご参照ください。 | HTTP Response Code | リターンコード | リターンメッセージ | | --- | --- | --- | | 400 | 10300 | Instance name is already in use. please use other name. | | 400 | 10702 | You are not allowed to create server of spec with selected image. | | 400 | 10706 | The starting number or the number of servers cannot be entered because the combination makes more than 3 digits. | | 400 | 10707 | More than 20 servers are unable to be created at a time. | | 400 | 10710 | Not found login key. | | 400 | 10711 | Invalid fee system. | | 400 | 10712 | Not found product. Please check your input product. | | 400 | 10714 | Paid license software products can be purchased for a fee only server. | | 400 | 10715 | MSSQL software product not be able to create a contract of hourly rate. | | 400 | 10716 | Cannot create VDS(Virtual Dedicated Server) with specific price plan. | | 400 | 10721 | Can not use global internet line. Please contract customer service center. | | 400 | 10722 | This type of product is not available on the global internet line. | | 400 | 10724 | The server image contains additional storage so you can't create a server. Additional storage is not available for Micro Server. | | 400 | 10800 | This name is already in use. | | 400 | 23003 | Since entire return of previous server has yet to be completed, new server cannot be created. Please try again after completing returning process. | | 400 | 23006 | You cannot request for server return and creation at the same time. Please make one request at a time. | | 400 | 24110 | The input parameter server image number is invalid. | | 400 | 24111 | The input parameter zone number is invalid. | | 400 | 24124 | The input parameter ACG configuration number is invalid. | | 400 | 24300 | The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes. | | 400 | 24301 | The length constraints of the parameter userData were violated. The minimum length is 0 byte, the maximum, 21,847 bytes. | | 400 | 24302 | UserData is not base64-encoded. | | 400 | 25038 | Currently the server image is not existing normally. | | 400 | 25040 | Unable to create server since server image is being manipulated or the server is being created from. |