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.

changeCloudMysqlServerSpec

Prev Next

Cloud DB for MySQL 인스턴스의 DB 서버 스펙을 변경합니다.

구문

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

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

옵션

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

필수 옵션

changeCloudMysqlServerSpec의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--cloudMysqlInstanceNo String Required Cloud DB for MySQL 인스턴스 번호
--cloudMysqlProductCode String Required 변경할 Cloud DB for MySQL 상품 코드

선택 옵션

changeCloudMysqlServerSpec의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--isRolling Boolean Optional 롤링 업그레이드 여부
  • true | false (기본값)
    • true: 서버 인스턴스를 하나씩 순차적으로 변경하여 서비스 중단 최소화 (단, G3 스펙에서만 지원)
    • false: 전체 서버를 동시에 중단 후 변경

공통 옵션

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

예시

DB 서버 스펙 변경 요청이 성공하면 Cloud DB for MySQL 인스턴스의 구성 정보와 각 서버 인스턴스의 상세 정보가 반환됩니다.

명령

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

./ncloud vmysql changeCloudMysqlServerSpec \
    --cloudMysqlInstanceNo 12345678 \
    --cloudMysqlProductCode SVR.VDBAS.STAND.C002.M008.NET.HDD.B050.G001 \
    --regionCode FKR \
    --output json

출력

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

{
  "changeCloudMysqlServerSpec": {
    "totalRows": 1,
    "cloudMysqlInstanceList": [
      {
        "cloudMysqlInstanceNo": "12345678",
        "cloudMysqlServiceName": "test-mysql",
        "cloudMysqlInstanceStatusName": "upgrading",
        "cloudMysqlInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "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": "라이센스코드-CLOUD DATABASE(VPC)"
        },
        "cloudMysqlPort": 13306,
        "isHa": true,
        "isMultiZone": false,
        "isBackup": true,
        "backupFileRetentionPeriod": 1,
        "backupTime": "11:15",
        "generationCode": "G2",
        "createDate": "2026-06-19T11:57:42+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "cloudMysqlConfigList": [],
        "cloudMysqlServerInstanceList": [
          {
            "cloudMysqlServerInstanceNo": "34567890",
            "cloudMysqlServerName": "testmysql-001-3ogv",
            "cloudMysqlServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M008.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.6",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 8589934592,
            "uptime": "2026-06-19T12:04:29+0900",
            "createDate": "2026-06-19T11:57:42+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567891",
            "cloudMysqlServerName": "testmysql-002-3ogw",
            "cloudMysqlServerRole": {
              "code": "H",
              "codeName": "Standby Master"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M008.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.7",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 8589934592,
            "uptime": "2026-06-19T12:04:05+0900",
            "createDate": "2026-06-19T11:57:42+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567892",
            "cloudMysqlServerName": "testmysql-003-3ogx",
            "cloudMysqlServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M008.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.8",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 8589934592,
            "uptime": "2026-06-19T13:41:07+0900",
            "createDate": "2026-06-19T13:36:01+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567893",
            "cloudMysqlServerName": "testrecovery01-001-3ogy",
            "cloudMysqlServerRole": {
              "code": "R",
              "codeName": "Recovery"
            },
            "cloudMysqlServerInstanceStatusName": "settingUp",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Setup OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M008.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.9",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 8589934592,
            "uptime": "2026-06-19T14:04:40+0900",
            "createDate": "2026-06-19T13:58:42+0900"
          }
        ]
      }
    ],
    "requestId": "fcd8c57a-10c6-4560-b53f-5057ac239940",
    "returnCode": "0",
    "returnMessage": "success"
  }
}