---
title: "createCloudMssqlSlaveInstance"
slug: "cli-vmssql-createcloudmssqlslaveinstance"
tags: ["Cloud DB for MSSQL", "VPC"]
updated: 2026-07-23T08:59:34Z
published: 2026-07-23T08:59:34Z
canonical: "cli.ncloud-docs.com/cli-vmssql-createcloudmssqlslaveinstance"
---
> ## 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.
# createCloudMssqlSlaveInstance
VPC 환경에서 이용 가능합니다.
Cloud DB for MSSQL 인스턴스에 Slave 서버 인스턴스를 추가합니다.
## 구문
`createCloudMssqlSlaveInstance` 구문은 다음과 같습니다.
```shell
./ncloud vmssql createCloudMssqlSlaveInstance \
--cloudMssqlInstanceNo \
--privateDomainPostfix \
[--subnetNo ] \
[--regionCode ] \
[--output ]
```
## 옵션
`createCloudMssqlSlaveInstance` 실행 시 지정할 수 있는 옵션을 설명합니다.
### 필수 옵션
`createCloudMssqlSlaveInstance`의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudMssqlInstanceNo` | String | Required | Cloud DB for MSSQL 인스턴스 번호- [getCloudMssqlInstanceList](/docs/cli-vmssql-getcloudmssqlinstancelist) 참조
|
| `--privateDomainPostfix` | String | Required | Slave 서버 인스턴스의 Private 도메인 접미사- `001`~`999` 범위의 세 자리 숫자 형식으로 입력
|
| `--subnetNo` | String | Conditional | Cloud DB for MSSQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호- Cloud DB for MSSQL이 멀티존인 경우, 필수 입력
- 멀티존이 아닌 경우, `subnetNo`의 입력은 받지 않으며 기존 Subnet에 생성됨
- [getCloudMssqlTargetSubnetList](/docs/cli-vmssql-getcloudmssqltargetsubnetlist) 참조
|
### 공통 옵션
`vmssql` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for MSSQL (VPC) 옵션](/docs/cli-vmssql#옵션)을 참조해 주십시오.
## 예시
Slave 서버 인스턴스 추가 요청이 성공하면 Cloud DB for MSSQL 인스턴스의 서버 구성과 추가된 Slave 서버의 생성 상태가 반환됩니다.
### 명령
명령 예시는 다음과 같습니다.
```shell
./ncloud vmssql createCloudMssqlSlaveInstance \
--cloudMssqlInstanceNo 25280088 \
--privateDomainPostfix 003 \
--regionCode KR \
--output json
```
### 출력
출력 예시는 다음과 같습니다.
```json
{
"createCloudMssqlSlaveInstanceResponse": {
"totalRows": 1,
"cloudMssqlInstanceList": [
{
"cloudMssqlInstanceNo": "25280088",
"cloudMssqlServiceName": "test-mssql-01",
"cloudMssqlInstanceStatusName": "running",
"cloudMssqlInstanceStatus": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Created 상태"
},
"cloudMssqlInstanceOperation": {
"code": "NULL",
"codeName": "CLOUD DATABASE(VPC) Null 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": [
{
"cloudMssqlServerInstanceNo": "25280089",
"cloudMssqlServerName": "m-25280088-001",
"cloudMssqlServerRole": {
"code": "M",
"codeName": "Principal"
},
"cloudMssqlServerInstanceStatusName": "running",
"cloudMssqlServerInstanceStatus": {
"code": "RUN",
"codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
},
"cloudMssqlServerInstanceOperation": {
"code": "NOOP",
"codeName": "CLOUD DATABASE(VPC) 서버 Null 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",
"privateDomain": "mssql-1a2b3c.vpc-cdb.ntruss.com",
"createDate": "2026-06-09T19:47:07+0900",
"uptime": "2026-06-09T20:16:13+0900",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"usedDataStorageSize": 1073741824
},
{
"cloudMssqlServerInstanceNo": "25280090",
"cloudMssqlServerName": "m-25280088-002",
"cloudMssqlServerRole": {
"code": "H",
"codeName": "Mirror"
},
"cloudMssqlServerInstanceStatusName": "running",
"cloudMssqlServerInstanceStatus": {
"code": "RUN",
"codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
},
"cloudMssqlServerInstanceOperation": {
"code": "NOOP",
"codeName": "CLOUD DATABASE(VPC) 서버 Null 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",
"privateDomain": "mssql-1a2b3c.vpc-cdb.ntruss.com",
"createDate": "2026-06-09T19:47:07+0900",
"uptime": "2026-06-09T20:26:04+0900",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
},
{
"cloudMssqlServerName": "m-25280088-003",
"cloudMssqlServerRole": {
"code": "S",
"codeName": "Slave"
},
"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-09T20:29:20+0900",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
}
}
],
"accessControlGroupNoList": [
"67890123"
]
}
],
"requestId": "d4e5f6a7-b8c9-0123-defa-456789012345",
"returnCode": "0",
"returnMessage": "success"
}
}
```