---
title: "createCloudMysqlSlaveInstance"
slug: "cli-vmysql-createcloudmysqlslaveinstance"
updated: 2026-09-17T10:08:39Z
published: 2026-09-17T10:08:39Z
canonical: "cli.ncloud-docs.com/cli-vmysql-createcloudmysqlslaveinstance"
---

> ## 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.

# createCloudMysqlSlaveInstance

Available in VPC

Add a slave server instance to a Cloud DB for MySQL instance.

## Syntax

The `createCloudMysqlSlaveInstance` syntax is as follows:

```
./ncloud vmysql createCloudMysqlSlaveInstance \
    --cloudMysqlInstanceNo <instance-no> \
    [--subnetNo <subnet-no>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## Options

This section describes the options available when running `createCloudMysqlSlaveInstance`.

### Required options

The following options are required for `createCloudMysqlSlaveInstance`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQL instance number - See [getCloudMysqlInstanceList](/docs/en/cli-vmysql-getcloudmysqlinstancelist). |
| `--subnetNo` | String | Conditional | Subnet number of the default network interface to be used in the Cloud DB for MySQL instance - Required for a multi-zone Cloud DB for MySQL. - If not multi-zone, the `subnetNo` entry is ignored and it is created in the existing subnet. - Subscription to public domains can only be done in a DB server created in public subnet. - Subnet migrations are not available after creating the Cloud DB for MySQL instance. - See [getCloudMysqlTargetSubnetList](/docs/en/cli-vmysql-getcloudmysqltargetsubnetlist). |

### Common options

For information about the options common to all `vmysql` subcommands, see [Cloud DB for MySQL (VPC) options](/docs/en/cli-vmysql#%EC%98%B5%EC%85%98).

## Examples

If the request to add a slave server instance is successful, the server configuration of the Cloud DB for MySQL instance and the creation status of the added slave server are returned.

### Command

The command example is as follows:

```
./ncloud vmysql createCloudMysqlSlaveInstance \
    --cloudMysqlInstanceNo 12345678 \
    --subnetNo 23456789 \
    --regionCode KR \
    --output json
```

### Output

The output example is as follows:

```
{
  "createCloudMysqlSlaveInstanceResponse": {
    "totalRows": 1,
    "cloudMysqlInstanceList": [
      {
        "cloudMysqlInstanceNo": "12345678",
        "cloudMysqlServiceName": "test-mysql",
        "cloudMysqlInstanceStatusName": "creating",
        "cloudMysqlInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE (VPC) Created status"
        },
        "cloudMysqlInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null OP"
        },
        "cloudMysqlImageProductCode": "SW.VMYSL.OS.LNX64.ROCKY.0810.MYSQL.B050",
        "engineVersion": "MYSQL8.0.36",
        "license": {
          "code": "GPL",
          "codeName": "License code - CLOUD DATABASE (VPC)"
        },
        "cloudMysqlPort": 13306,
        "isHa": true,
        "isMultiZone": true,
        "isBackup": true,
        "backupFileRetentionPeriod": 1,
        "backupTime": "10:30",
        "generationCode": "G2",
        "createDate": "2026-06-04T16:50:56+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "cloudMysqlConfigList": [],
        "cloudMysqlServerInstanceList": [
          {
            "cloudMysqlServerInstanceNo": "34567890",
            "cloudMysqlServerName": "testmysql-001-97mj",
            "cloudMysqlServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudMysqlServerInstanceStatusName": "running",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server null OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C002.M004.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c.vpc-cdb.ntruss.com",
            "privateIp": "10.0.0.6",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-04T16:57:14+0900",
            "createDate": "2026-06-04T16:50:56+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567891",
            "cloudMysqlServerName": "testmysql-002-97mk",
            "cloudMysqlServerRole": {
              "code": "H",
              "codeName": "Standby Master"
            },
            "cloudMysqlServerInstanceStatusName": "running",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE (VPC) server null OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C002.M004.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "98765432",
            "subnetNo": "23456790",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c.vpc-cdb.ntruss.com",
            "privateIp": "10.0.1.6",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-04T16:57:26+0900",
            "createDate": "2026-06-04T16:50:56+0900"
          },
          {
            "cloudMysqlServerName": "testmysql-003-97mu",
            "cloudMysqlServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudMysqlServerInstanceStatusName": "creating",
            "cloudMysqlServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE (VPC) server Pending status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE (VPC) server Create OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C002.M004.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "createDate": "2026-06-04T17:26:30+0900"
          }
        ]
      }
    ],
    "requestId": "d4e5f6a7-b8c9-0123-defa-456789012345",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```