---
title: "CloudMysqlInstance"
slug: "common-vapidatatype-cloudmysqlinstance"
tags: ["Cloud DB for MySQL", "VPC"]
updated: 2026-04-23T08:54:59Z
published: 2026-04-23T09:02:00Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudMysqlInstance

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

Cloud DB for MySQL 인스턴스입니다.

## 구문

구문은 다음과 같습니다.

```
private String cloudMysqlInstanceNo;
private String cloudMysqlServiceName;
private String cloudMysqlInstanceStatusName;
private CommonCode cloudMysqlInstanceStatus;
private CommonCode cloudMysqlInstanceOperation;
private String cloudMysqlImageProductCode;
private String engineVersion;
private CommonCode license;
private Integer cloudMysqlPort;
private Boolean isHa;
private Boolean isMultiZone;
private Boolean isBackup;
private Integer backupFileRetentionPeriod;
private String backupTime;
private String generationCode;
private Date createDate;
private List<String> accessControlGroupNoList;
private List<String> cloudMysqlConfigList;
private List<CloudMysqlServerInstance> cloudMysqlServerInstanceList;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQL 인스턴스 번호 |
| `cloudMysqlServiceName` | String | Required | Cloud DB for MySQL 서비스 이름 |
| `cloudMysqlInstanceStatusName` | String | Required | Cloud DB for MySQL 인스턴스 상태명 - `creating` \| `deleted` \| `deleting` \| `pending` \| `recovering` \| `reinstalling` \| `restarting` \| `running` \| `settingup` \| `shuttingdown` \| `stopped` \| `upgrading` \| `downgrading` |
| `cloudMysqlInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for MySQL 인스턴스 상태 - `INIT` \| `CREAT` \| `DEL` - `INIT`: Initiated - `CREAT`: Created - `DEL`: Deleted |
| `cloudMysqlInstanceOperation` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for MySQL 인스턴스 운영 상태 - `CREAT` \| `DEL` \| `FO` \| `NULL` \| `SETUP` \| `UPGD` \| `DWGD` \| `BKP` - `CREAT`: Create - `DEL`: Delete - `FO`: Failover - `NULL`: No Operation - `SETUP`: Setup - `UPGD`: Upgrade - `DWGD`: Downgrade - `BKP`: Backup |
| `cloudMysqlImageProductCode` | String | Optional | Cloud DB for MySQL 이미지 상품 코드 |
| `engineVersion` | String | Optional | Cloud DB for MySQL 엔진 버전 |
| `license` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | Cloud DB for MySQL 라이선스 |
| `cloudMysqlPort` | Integer | Optional | Cloud DB for MySQL 포트 |
| `isHa` | Boolean | Required | 고가용성 여부 - `true` \| `false` |
| `isMultiZone` | Boolean | Required | 멀티존 여부 - `true` \| `false` |
| `isBackup` | Boolean | Optional | 백업 여부 - `true` \| `false` |
| `backupFileRetentionPeriod` | Integer | Optional | 백업 파일 보관 기간 |
| `backupTime` | String | Optional | 백업 시간 |
| `generationCode` | String | Required | 서버 세대 코드 |
| `createDate` | Date | Required | 생성 일시 |
| `accessControlGroupNoList` | List<String> | Optional | ACG 번호 목록 |
| `cloudMysqlConfigList` | List<String> | Optional | Cloud DB for MySQL Config 목록 |
| `cloudMysqlServerInstanceList` | List<[CloudMysqlServerInstance](/docs/common-vapidatatype-cloudmysqlserverinstance)> | Required | Cloud DB for MySQL 서버 인스턴스 목록 |