--- title: "createCloudMssqlInstance" slug: "cli-vmssql-createcloudmssqlinstance" tags: ["Cloud DB for MSSQL", "VPC"] updated: 2026-09-17T10:11:08Z published: 2026-09-17T10:11:08Z canonical: "cli.ncloud-docs.com/cli-vmssql-createcloudmssqlinstance" --- > ## 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. # createCloudMssqlInstance VPC環境で利用できます。 Cloud DB for MSSQLインスタンスを作成します。 ## 構文 `createCloudMssqlInstance`構文は次の通りです。 ``` ./ncloud vmssql createCloudMssqlInstance \ --vpcNo \ --subnetNo \ --cloudMssqlServiceName \ --cloudMssqlUserName \ --cloudMssqlUserPassword \ --isHa \ [--isMultiZone ] \ [--mirrorSubnetNo ] \ [--configGroupNo ] \ [--cloudMssqlImageProductCode ] \ [--cloudMssqlProductCode ] \ [--engineVersionCode ] \ [--dataStorageTypeCode ] \ [--characterSetName ] \ [--isAutomaticBackup ] \ [--backupTime ] \ [--backupFileRetentionPeriod ] \ [--cloudMssqlPort ] \ [--regionCode ] \ [--output ] ``` ## オプション `createCloudMssqlInstance`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createCloudMssqlInstance`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | Cloud DB for MSSQLインスタンス作成対象の VPC番号 - [getCloudMssqlTargetVpcList](/docs/ja/cli-vmssql-getcloudmssqltargetvpclist)を参照 | | `--subnetNo` | String | Required | Cloud DB for MSSQLインスタンスで使用する基本ネットワークインターフェースの Subnet番号 - Publicドメインは、Public Subnetに作成された DBサーバでのみ申し込み可能 - Cloud DB for MSSQLインスタンス作成後に Subnetの移転はできない - [getCloudMssqlTargetSubnetList](/docs/ja/cli-vmssql-getcloudmssqltargetsubnetlist)を参照 | | `--cloudMssqlServiceName` | String | Required | Cloud DB for MSSQLサービス名 - 英字、ハングル、数字、記号の`-`を組み合わせて3~15文字以内で入力 | | `--cloudMssqlUserName` | String | Required | DB User ID - 英数字、記号の`_`を組み合わせて4~16文字以内で入力 - 先頭文字は英字のみ使用 | | `--cloudMssqlUserPassword` | String | Required | DB Userのパスワード - 英字、記号、数字をそれぞれ1文字以上含めて8~20文字以内で入力 - 記号の``` `&` `\` `"` `'` `/`とスペースは使用不可 | | `--isHa` | Boolean | Required | 高可用性の有無 - `true` (デフォルト) \| `false` - `true`: Mirrorサーバを含めて2台のサーバが作成され、追加料金が発生 - `false`: `isMultiZone`、`mirrorSubnetNo`は使用不可 | | `--mirrorSubnetNo` | String | Conditional | Mirrorサーバの Subnet番号 - Cloud DB for MSSQLがマルチゾーンの場合、必ず入力 - Principalサーバの Subnetとはゾーンが異なるように、Publicまたは Privateは同じようにする - [getCloudMssqlTargetSubnetList](/docs/ja/cli-vmssql-getcloudmssqltargetsubnetlist)を参照 | | `--backupTime` | String | Conditional | バックアップ時点を設定(HH:MM) - `isAutomaticBackup`=`false`の場合、必ず入力 - 15分単位で入力可能 - 例: `01:15` | ### 任意オプション `createCloudMssqlInstance`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--isMultiZone` | Boolean | Optional | マルチゾーンかどうか - `true` \| `false` (デフォルト) - `true`: Principalサーバと Mirrorを異なるゾーンに作成してより高い可用性を提供 - `false`: マルチゾーンを使用しない - `isHa`=`true`の場合にのみ使用可能 | | `--configGroupNo` | String | Optional | Cloud DB for MSSQL Config Group番号 - デフォルト: `0` - 事前に作成しておいた Config Groupをサーバ作成時に適用可能 - 別途 Config Groupがない場合、デフォルトで提供される Config Groupの中から選択可能 - [getCloudMssqlConfigGroupList](/docs/ja/cli-vmssql-getcloudmssqlconfiggrouplist)を参照 | | `--cloudMssqlImageProductCode` | String | Optional | Cloud DB for MSSQLイメージ商品コード - NAVERクラウドプラットフォームで自動作成 - [getCloudMssqlImageProductList](/docs/ja/cli-vmssql-getcloudmssqlimageproductlist)を参照 | | `--cloudMssqlProductCode` | String | Optional | Cloud DB for MSSQL商品コード - Cloud DB for MSSQLインスタンスのサーバスペックを決める - デフォルト: 最小スペック(メモリ、CPUの順) - [getCloudMssqlProductList](/docs/ja/cli-vmssql-getcloudmssqlproductlist)を参照 | | `--engineVersionCode` | String | Optional | DBエンジンのバージョン - 入力しない場合、現在提供中の最新バージョンで作成 - [getCloudMssqlImageProductList](/docs/ja/cli-vmssql-getcloudmssqlimageproductlist)を参照 | | `--dataStorageTypeCode` | String | Optional | データストレージタイプコード - `cloudMssqlImageProductCode`の`generationCode`に応じて有効な値が異なる - G2: `SSD` (デフォルト) \| `HDD` - G3: `CB2` (デフォルト) - インストール後、データストレージタイプは変更不可 | | `--characterSetName` | String | Optional | DBキャラクターセット - `Korean_Wansung_CI_AS` (デフォルト) \| `SQL_Latin1_General_CP1_CI_AS` - [getCloudMssqlCharacterSetList](/docs/ja/cli-vmssql-getcloudmssqlcharactersetlist)を参照 | | `--isAutomaticBackup` | Boolean | Optional | バックアップ時点を自動設定するか - `true` (デフォルト) \| `false` - `true`の場合、`backupTime`は入力不可 | | `--backupFileRetentionPeriod` | Integer | Optional | バックアップファイルの保管期間(日) - `1`~`30` (デフォルト: `1`) - バックアップは毎日行われ、バックアップファイルは別途ストレージに保存 - 料金は使用する容量だけ課金 | | `--cloudMssqlPort` | Integer | Optional | Cloud DB for MSSQLインスタンスアクセス用 TCPポート番号 - `10000`~`20000` (デフォルト: `1433`) | ### 共通オプション `vmssql`コマンドで共通して使用するオプションについては、[Cloud DB for MSSQL (VPC)のオプション](/docs/ja/cli-vmssql#%EC%98%B5%EC%85%98)を参照してください。 ## 例 Cloud DB for MSSQLインスタンスの作成リクエストが成功すると、インスタンスの構成情報と作成状態が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./ncloud vmssql createCloudMssqlInstance \ --vpcNo 12345678 \ --subnetNo 23456789 \ --cloudMssqlServiceName test-mssql-01 \ --cloudMssqlUserName testuser \ --cloudMssqlUserPassword Examplepw123! \ --isHa true \ --cloudMssqlImageProductCode SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15044401.SE.B100 \ --cloudMssqlProductCode SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002 \ --regionCode KR \ --output json ``` ### 出力 出力の例は次の通りです。 ``` { "createCloudMssqlInstanceResponse": { "totalRows": 1, "cloudMssqlInstanceList": [ { "cloudMssqlInstanceNo": "25280088", "cloudMssqlServiceName": "test-mssql-01", "cloudMssqlInstanceStatusName": "creating", "cloudMssqlInstanceStatus": { "code": "INIT", "codeName": "CLOUD DATABASE(VPC) Init状態" }, "cloudMssqlInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Creat OP" }, "generationCode": "G2", "cloudMssqlImageProductCode": "SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15044401.SE.B100", "isHa": true, "isMultiZone": false, "license": { "code": "SPLA", "codeName": "ライセンスコード-CLOUD DATABASE(VPC)" }, "cloudMssqlPort": 1433, "backupFileRetentionPeriod": 1, "backupTime": "09:00", "configGroupNo": "0", "configGroupName": "mssql_2019_default", "engineVersion": "MSSQL 15.0.4440.1 Standard Edition", "createDate": "2026-06-09T19:47:07+0900", "dbCollation": "Korean_Wansung_CI_AS", "cloudMssqlServerInstanceList": [ { "cloudMssqlServerName": "m-25280088-001", "cloudMssqlServerRole": { "code": "M", "codeName": "Principal" }, "cloudMssqlServerInstanceStatusName": "creating", "cloudMssqlServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudMssqlServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "12345678", "subnetNo": "23456789", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": false, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "createDate": "2026-06-09T19:47:07+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" } }, { "cloudMssqlServerName": "m-25280088-002", "cloudMssqlServerRole": { "code": "H", "codeName": "Mirror" }, "cloudMssqlServerInstanceStatusName": "creating", "cloudMssqlServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudMssqlServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "12345678", "subnetNo": "23456789", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": false, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "createDate": "2026-06-09T19:47:07+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" } } ] } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```