Documentation Index

Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

createCloudMssqlSlaveInstance

Prev Next

Cloud DB for MSSQL 인스턴스에 Slave 서버 인스턴스를 추가합니다.

구문

createCloudMssqlSlaveInstance 구문은 다음과 같습니다.

./ncloud vmssql createCloudMssqlSlaveInstance \
    --cloudMssqlInstanceNo <instance-no> \
    --privateDomainPostfix <private-domain-postfix> \
    [--subnetNo <subnet-no>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

createCloudMssqlSlaveInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudMssqlSlaveInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--cloudMssqlInstanceNo String Required Cloud DB for MSSQL 인스턴스 번호
--privateDomainPostfix String Required Slave 서버 인스턴스의 Private 도메인 접미사
  • 001~999 범위의 세 자리 숫자 형식으로 입력
--subnetNo String Conditional Cloud DB for MSSQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호
  • Cloud DB for MSSQL이 멀티존인 경우, 필수 입력
  • 멀티존이 아닌 경우, subnetNo의 입력은 받지 않으며 기존 Subnet에 생성됨
  • getCloudMssqlTargetSubnetList 참조

공통 옵션

vmssql 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for MSSQL 옵션을 참조해 주십시오.

예시

Slave 서버 인스턴스 추가 요청이 성공하면 Cloud DB for MSSQL 인스턴스의 서버 구성과 추가된 Slave 서버의 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vmssql createCloudMssqlSlaveInstance \
    --cloudMssqlInstanceNo 141402185 \
    --privateDomainPostfix 003 \
    --regionCode FKR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createCloudMssqlSlaveInstanceResponse": {
    "totalRows": 1,
    "cloudMssqlInstanceList": [
      {
        "cloudMssqlInstanceNo": "141402185",
        "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": "02:30",
        "configGroupNo": "0",
        "configGroupName": "mssql_2019_default",
        "engineVersion": "MSSQL 15.0.4440.1 Standard Edition",
        "createDate": "2026-06-18T13:12:54+0900",
        "dbCollation": "Korean_Wansung_CI_AS",
        "cloudMssqlServerInstanceList": [
          {
            "cloudMssqlServerInstanceNo": "141402194",
            "cloudMssqlServerName": "m-141402185-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": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "123456789",
            "subnetNo": "234567890",
            "dataStorageSize": 107374182400,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "isPublicSubnet": false,
            "cloudMssqlProductCode": "SVR.VMSSL.STAND.C002.M004.NET.HDD.B100.G001",
            "privateDomain": "mssql-1a2b3c-fkr.cdb.fin-ntruss.com",
            "createDate": "2026-06-18T13:12:54+0900",
            "uptime": "2026-06-18T13:37:40+0900",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "usedDataStorageSize": 1073741824
          },
          {
            "cloudMssqlServerInstanceNo": "141402197",
            "cloudMssqlServerName": "m-141402185-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": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "123456789",
            "subnetNo": "234567890",
            "dataStorageSize": 107374182400,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "isPublicSubnet": false,
            "cloudMssqlProductCode": "SVR.VMSSL.STAND.C002.M004.NET.HDD.B100.G001",
            "privateDomain": "mssql-1a2b3c-fkr.cdb.fin-ntruss.com",
            "createDate": "2026-06-18T13:12:54+0900",
            "uptime": "2026-06-18T13:52:25+0900",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "usedDataStorageSize": 1073741824
          },
          {
            "cloudMssqlServerName": "m-141402185-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": "FKR",
            "vpcNo": "123456789",
            "subnetNo": "234567890",
            "dataStorageSize": 107374182400,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "isPublicSubnet": false,
            "cloudMssqlProductCode": "SVR.VMSSL.STAND.C002.M004.NET.HDD.B100.G001",
            "createDate": "2026-06-18T14:12:34+0900",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            }
          }
        ],
        "accessControlGroupNoList": [
          "68790123"
        ]
      }
    ],
    "requestId": "265b59e2-9a81-42db-af99-bb1b8671956c",
    "returnCode": "0",
    "returnMessage": "success"
  }
}