changeCloudMysqlServerSpec

Prev Next

VPC 환경에서 이용 가능합니다.

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

구문

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

./ncloud vmysql changeCloudMysqlServerSpec \
    --cloudMysqlInstanceNo <instance-no> \
    --cloudMysqlProductCode <product-code> \
    [--isRolling <true|false>] \
    [--regionCode <KR|KRS>] \
    [--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 (VPC) 옵션을 참조해 주십시오.

예시

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

명령

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

./ncloud vmysql changeCloudMysqlServerSpec \
    --cloudMysqlInstanceNo 12345678 \
    --cloudMysqlProductCode SVR.VDBAS.HICPU.C004.M008.NET.HDD.B050.G002 \
    --regionCode KR \
    --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": "06:45",
        "generationCode": "G2",
        "createDate": "2026-06-29T15:58:29+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "cloudMysqlConfigList": [],
        "cloudMysqlServerInstanceList": [
          {
            "cloudMysqlServerInstanceNo": "34567890",
            "cloudMysqlServerName": "testmysql-001-4r3r",
            "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.HICPU.C004.M008.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-kr1.vpc-cdb.gov-ntruss.com",
            "privateIp": "192.168.1.6",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-29T16:04:48+0900",
            "createDate": "2026-06-29T15:58:29+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567891",
            "cloudMysqlServerName": "testmysql-002-4r3s",
            "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.HICPU.C004.M008.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-kr1.vpc-cdb.gov-ntruss.com",
            "privateIp": "192.168.1.7",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-29T16:04:37+0900",
            "createDate": "2026-06-29T15:58:29+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567892",
            "cloudMysqlServerName": "testmysql-003-4r3z",
            "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.HICPU.C004.M008.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-kr1.vpc-cdb.gov-ntruss.com",
            "privateIp": "192.168.1.8",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-29T16:56:24+0900",
            "createDate": "2026-06-29T16:51:10+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567893",
            "cloudMysqlServerName": "testrecovery01-001-4r43",
            "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.HICPU.C004.M008.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-kr1.vpc-cdb.gov-ntruss.com",
            "privateIp": "192.168.1.9",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 4,
            "memorySize": 8589934592,
            "uptime": "2026-06-29T17:15:56+0900",
            "createDate": "2026-06-29T17:11:13+0900"
          }
        ]
      }
    ],
    "requestId": "4739e449-aac9-40f1-9fae-2186eb423374",
    "returnCode": "0",
    "returnMessage": "success"
  }
}