changeCloudMysqlServerSpec

Available in VPC

Change the DB server specifications for a Cloud DB for MySQL instance.

Syntax

The changeCloudMysqlServerSpec syntax is as follows:

./ncloud vmysql changeCloudMysqlServerSpec \
    --cloudMysqlInstanceNo <instance-no> \
    --cloudMysqlProductCode <product-code> \
    [--isRolling <true|false>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeCloudMysqlServerSpec.

Required options

The following options are required for changeCloudMysqlServerSpec.

Options	Type	Required	Description
`--cloudMysqlInstanceNo`	String	Required	Cloud DB for MySQL instance number See getCloudMysqlInstanceList.
`--cloudMysqlProductCode`	String	Required	Cloud DB for MySQL image product code to change See getCloudMysqlProductList.

Optional options

These are the optional options for changeCloudMysqlServerSpec. Options that are not specified will use their default values.

Options	Type	Required	Description
`--isRolling`	Boolean	Optional	Rolling upgrade status `true` \| `false` (default) `true`: Minimize service disruption by sequentially changing server instances one by one (but only supported in G3 specifications). `false`: Change after stopping the all servers simultaneously.

Common options

For information about the options common to all vmysql subcommands, see Cloud DB for MySQL (VPC) options.

Examples

If the request to change the DB server specifications is successful, the configuration information for the Cloud DB for MySQL instance and the details for each server instance are returned.

Command

The command example is as follows:

./ncloud vmysql changeCloudMysqlServerSpec \
    --cloudMysqlInstanceNo 12345678 \
    --cloudMysqlProductCode SVR.VDBAS.HICPU.C004.M008.NET.HDD.B050.G002 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "changeCloudMysqlServerSpec": {
    "totalRows": 1,
    "cloudMysqlInstanceList": [
      {
        "cloudMysqlInstanceNo": "12345678",
        "cloudMysqlServiceName": "test-mysql",
        "cloudMysqlInstanceStatusName": "upgrading",
        "cloudMysqlInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE (VPC) Created status"
        },
        "cloudMysqlInstanceOperation": {
          "code": "UPGD",
          "codeName": "CLOUD DATABASE(VPC) Upgrade 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": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE (VPC) server Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C004.M008.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": 4,
            "memorySize": 8589934592,
            "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": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE (VPC) server Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C004.M008.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": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-04T16:57:26+0900",
            "createDate": "2026-06-04T16:50:56+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567892",
            "cloudMysqlServerName": "testmysql-003-97mu",
            "cloudMysqlServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE (VPC) server Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C004.M008.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.7",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-04T17:30:59+0900",
            "createDate": "2026-06-04T17:26:30+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567893",
            "cloudMysqlServerName": "testrecovery01-001-97mx",
            "cloudMysqlServerRole": {
              "code": "R",
              "codeName": "Recovery"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE (VPC) server Running status"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE (VPC) server Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C004.M008.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.8",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9180492799,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-04T17:46:44+0900",
            "createDate": "2026-06-04T17:40:59+0900"
          }
        ]
      }
    ],
    "requestId": "a7b8c9d0-e1f2-3456-abcd-789012345678",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index