--- title: "createCloudMssqlSlaveInstance" slug: "database-vmssql-createcloudmssqlslaveinstance" updated: 2026-09-17T09:57:51Z published: 2026-09-17T09:57:51Z canonical: "api.ncloud-docs.com/database-vmssql-createcloudmssqlslaveinstance" --- > ## 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. # createCloudMssqlSlaveInstance VPC環境で利用できます。 Cloud DB for MSSQLインスタンスに Slaveサーバインスタンスを追加します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET \| POST | /vmssql/v2/createCloudMssqlSlaveInstance | 参考 ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。 ### リクエストヘッダ Cloud DB for MSSQL (VPC) APIで共通して使用されるヘッダの詳細は、[Cloud DB for MSSQL (VPC)のリクエストヘッダ](/docs/ja/database-vmssql#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `regionCode` | String | Optional | Slaveサーバインスタンス作成対象の Cloud DB for MSSQLインスタンスのリージョンコード - [getRegionList](/docs/ja/compute-vserver-server-common-getregionlist)を参照 - `getRegionList`照会結果の最初のリージョン(デフォルト) | | `cloudMssqlInstanceNo` | String | Required | Cloud DB for MSSQLインスタンス番号 - [getCloudMssqlInstanceList](/docs/ja/database-vmssql-getcloudmssqlinstancelist)を参照 | | `privateDomainPostfix` | String | Required | Slaveサーバインスタンスの Privateドメインの Postfix - 001 ~ 999 - 3桁の数字形式で入力 | | `subnetNo` | String | Conditional | Cloud DB for MSSQLインスタンスで使用する基本ネットワークインターフェースの Subnet番号 - [getCloudMssqlTargetSubnetList](/docs/ja/database-vmssql-getcloudmssqltargetsubnetlist)を参照 - Multi Zoneの Cloud DB for MSSQLの場合、必ず入力 - Multi Zoneではない Cloud DB for MSSQLの場合、`subnetNo`の入力は受けず、既存の`subnetNo`に作成される | | `responseFormatType` | String | Optional | レスポンス結果の形式 - `xml`(デフォルト) \| `json` | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vmssql/v2/createCloudMssqlSlaveInstance ?regionNo=KR &cloudMssqlInstanceNo=2517**** &privateDomainPostfix=002 &subnetNo=139*** &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}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの詳細は、[CloudMssqlInstanceList](/docs/ja/common-vapidatatype-cloudmssqlinstancelist)をご参照ください。 ### レスポンスステータスコード Cloud DB for MSSQL (VPC) APIで共通して使用されるレスポンスステータスコードの詳細は、[Cloud DB for MSSQL (VPC)のレスポンスステータスコード](/docs/ja/database-vmssql#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 - `responseFormatType=json`の場合 ``` { "createCloudMssqlSlaveInstanceResponse": { "totalRows": 1, "cloudMssqlInstanceList": [ { "cloudMssqlInstanceNo": "2517****", "cloudMssqlServiceName": "mssql002", "cloudMssqlInstanceStatusName": "running", "cloudMssqlInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Created State" }, "cloudMssqlInstanceOperation": { "code": "NULL", "codeName": "CLOUD DATABASE(VPC) Null OP" }, "cloudMssqlImageProductCode": "SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15043553.EE.B100", "isHa": true, "isMultiZone": false, "license": { "code": "SPLA", "codeName": "Service Provider License Agreement" }, "cloudMssqlPort": 1433, "backupFileRetentionPeriod": 1, "backupTime": "02:00", "configGroupNo": "0", "configGroupName": "mssql_2019_default", "engineVersion": "MSSQL 15.0.4355.3 Enterprise Edition", "createDate": "2024-06-25T10:18:57+0900", "dbCollation": "Korean_Wansung_CI_AS", "cloudMssqlServerInstanceList": [ { "cloudMssqlServerInstanceNo": "2517****", "cloudMssqlServerName": "m-2517****-001", "cloudMssqlServerRole": { "code": "M", "codeName": "Principal" }, "cloudMssqlServerInstanceStatusName": "running", "cloudMssqlServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudMssqlServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "59***", "subnetNo": "140***", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": true, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "privateDomain": "mssql-****.vpc-cdb.ntruss.com", "createDate": "2024-06-25T10:18:57+0900", "uptime": "2024-06-25T10:48:04+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "usedDataStorageSize": 1073741824 }, { "cloudMssqlServerInstanceNo": "2517****", "cloudMssqlServerName": "m-2517****-002", "cloudMssqlServerRole": { "code": "H", "codeName": "Mirror" }, "cloudMssqlServerInstanceStatusName": "running", "cloudMssqlServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudMssqlServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "59***", "subnetNo": "140***", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": true, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "privateDomain": "mssql-****.vpc-cdb.ntruss.com", "createDate": "2024-06-25T10:18:57+0900", "uptime": "2024-06-25T11:01:26+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "usedDataStorageSize": 1073741824 }, { "cloudMssqlServerInstanceNo": "2529****", "cloudMssqlServerName": "m-2517****-005", "cloudMssqlServerRole": { "code": "S", "codeName": "Slave" }, "cloudMssqlServerInstanceStatusName": "running", "cloudMssqlServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudMssqlServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "59***", "subnetNo": "140***", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": true, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "privateDomain": "mssql-****-r001.vpc-cdb.ntruss.com", "createDate": "2024-07-01T15:50:23+0900", "uptime": "2024-07-01T16:19:57+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "usedDataStorageSize": 1073741824 }, { "cloudMssqlServerInstanceNo": "2529****", "cloudMssqlServerName": "m-2517****-006", "cloudMssqlServerRole": { "code": "S", "codeName": "Slave" }, "cloudMssqlServerInstanceStatusName": "creating", "cloudMssqlServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudMssqlServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "regionCode": "KR", "zoneCode": "KR-1", "vpcNo": "59***", "subnetNo": "140***", "dataStorageSize": 107374182400, "cpuCount": 2, "memorySize": 4294967296, "isPublicSubnet": true, "cloudMssqlProductCode": "SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002", "createDate": "2024-07-01T16:50:01+0900", "uptime": "2024-07-01T17:22:39+0900", "dataStorageType": { "code": "SSD", "codeName": "SSD" } } ], "accessControlGroupNoList": [ "184***" ] } ], "requestId": "ba3feb17-****-****-****-c326f4ca42e1", "returnCode": "0", "returnMessage": "success" } } ``` - `responseFormatType=xml`(デフォルト)の場合 ``` ba3feb17-****-****-****-c326f4ca42e1 0 success 1 2517**** mssql002 running CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15043553.EE.B100 true false SPLA Service Provider License Agreement 1433 1 02:00 0 mssql_2019_default MSSQL 15.0.4355.3 Enterprise Edition 2024-06-25T10:18:57+0900 Korean_Wansung_CI_AS 2517**** m-2517****-001 M Principal running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP KR KR-1 59*** 140*** 107374182400 2 4294967296 true SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002 mssql-****.vpc-cdb.ntruss.com 2024-06-25T10:18:57+0900 2024-06-25T10:48:04+0900 SSD SSD 1073741824 2517**** m-2517****-002 H Mirror running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP KR KR-1 59*** 140*** 107374182400 2 4294967296 true SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002 mssql-****.vpc-cdb.ntruss.com 2024-06-25T10:18:57+0900 2024-06-25T11:01:26+0900 SSD SSD 1073741824 2529**** m-2517****-005 S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP KR KR-1 59*** 140*** 107374182400 2 4294967296 true SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002 mssql-****-r001.vpc-cdb.ntruss.com 2024-07-01T15:50:23+0900 2024-07-01T16:19:57+0900 SSD SSD 1073741824 2529**** m-2517****-006 S Slave creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP KR KR-1 59*** 140*** 107374182400 2 4294967296 true SVR.VMSSL.HICPU.C002.M004.NET.HDD.B100.G002 mssql-****-r002.vpc-cdb.ntruss.com 2024-07-01T16:50:01+0900 2024-07-01T17:22:39+0900 SSD SSD 1073741824 184*** ```