--- title: "createCloudMysqlInstance" slug: "cli-vmysql-createcloudmysqlinstance" tags: ["Cloud DB for MySQL", "VPC"] updated: 2026-09-17T09:16:03Z published: 2026-09-17T09:16:03Z canonical: "cli.ncloud-docs.com/cli-vmysql-createcloudmysqlinstance" --- > ## 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. # createCloudMysqlInstance VPC 환경에서 이용 가능합니다. Cloud DB for MySQL 인스턴스를 생성합니다. ## 구문 `createCloudMysqlInstance` 구문은 다음과 같습니다. ```shell ./ncloud vmysql createCloudMysqlInstance \ --vpcNo \ --subnetNo \ --cloudMysqlServiceName \ --cloudMysqlServerNamePrefix \ --cloudMysqlDatabaseName \ --cloudMysqlUserName \ --cloudMysqlUserPassword \ --hostIp \ [--cloudMysqlImageProductCode ] \ [--cloudMysqlProductCode ] \ [--engineVersionCode ] \ [--dataStorageTypeCode ] \ [--isStorageEncryption ] \ [--isHa ] \ [--isMultiZone ] \ [--standbyMasterSubnetNo ] \ [--isBackup ] \ [--isAutomaticBackup ] \ [--backupTime ] \ [--backupFileRetentionPeriod ] \ [--cloudMysqlPort ] \ [--isPrivateSubDomain ] \ [--privateSubDomainPrefix ] \ [--isDeleteProtection ] \ [--regionCode ] \ [--output ] ``` ## 옵션 `createCloudMysqlInstance` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `createCloudMysqlInstance`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | Cloud DB for MySQL 인스턴스를 생성할 VPC 번호 - [getCloudMysqlTargetVpcList](/docs/cli-vmysql-getcloudmysqltargetvpclist) 참조 | | `--subnetNo` | String | Required | Cloud DB for MySQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호 - Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청 가능 - Cloud DB for MySQL 인스턴스 생성 이후 Subnet 이전 불가 - [getCloudMysqlTargetSubnetList](/docs/cli-vmysql-getcloudmysqltargetsubnetlist) 참조 | | `--cloudMysqlServiceName` | String | Required | Cloud DB for MySQL 서비스 이름 - 영문자, 한글, 숫자, 특수문자 `-`를 조합하여 3~30자 이내로 입력 | | `--cloudMysqlServerNamePrefix` | String | Required | Cloud DB for MySQL 서버 이름 접두사 - 영어 소문자, 숫자, 특수문자 `-`를 조합하여 3~20자 이내로 입력 - 문자열의 시작은 영어 소문자, 마지막은 영어 소문자 또는 숫자로 구성 - 접두사 뒤에 3자리 숫자가 자동으로 생성되고, 호스트명 중복 방지를 위해 임의의 텍스트가 추가로 포함되어 생성됨 - 예시: 접두사가 `test-123`인 경우, `test-123-001-4y1v` | | `--cloudMysqlDatabaseName` | String | Required | Cloud DB for MySQL 인스턴스에 기본으로 생성할 DB 이름 - 영문자, 숫자, 특수문자 `_` `-`를 조합하여 1~30자 이내로 입력 - 문자열은 영문자로 시작 | | `--cloudMysqlUserName` | String | Required | DB User 계정 ID - 영문자, 숫자, 특수문자 `-` `_`를 조합하여 3~16자 이내로 입력 - 문자열은 영문자로 시작 | | `--cloudMysqlUserPassword` | String | Required | DB User 계정 비밀번호 - 영어/특수문자/숫자 3개 항목에 대해 1자 이상 포함하여 8~20자 이내로 입력 - 특수문자 ``` `&` `+` `\` `"` `'` `/` 및 공백 사용 불가 - Password plugin이 활성화된 상태에서는 plugin으로 설정한 정책도 만족해야 함 | | `--hostIp` | String | Required | MySQL 서버에 접속을 허용할 호스트 IP 주소 - 전체 허용: `%` - 특정 IP: `1.1.1.1` - IP 대역: `1.1.1.%` - CIDR: `1.1.1.0/24` | | `--isMultiZone` | Boolean | Conditional | 멀티존 여부 - `true` \| `false` (기본값) - `true`: Master 서버와 Standby Master 서버를 서로 다른 존에 생성하여 더욱 높은 가용성 제공 - `false`: 멀티존 사용 안 함 - `isHa`=`true`인 경우, 필수 입력 | | `--standbyMasterSubnetNo` | String | Conditional | Standby Master 서버의 Subnet 번호 - Cloud DB for MySQL이 멀티존인 경우, 필수 입력 - Master 서버의 Subnet과 존이 다르고, Public 또는 Private는 같아야 함 - [getCloudMysqlTargetSubnetList](/docs/cli-vmysql-getcloudmysqltargetsubnetlist) 참조 | | `--backupTime` | String | Conditional | 백업 시점 설정 (HH:MM) - `isBackup`=`true`이고 `isAutomaticBackup`=`false`인 경우, 필수 입력 - 예시: `01:15` (선택한 시간 + 15분 사이에 백업 시작) | | `--privateSubDomainPrefix` | String | Conditional | Private 도메인에 추가할 Sub 도메인 입력 - 영문자, 숫자, 특수문자 `-` 를 조합하여 3~15자 이내로 입력 - 문자열의 시작은 영문자, 마지막은 영문자 또는 숫자로 구성 - `isPrivateSubDomain`=`true`인 경우, 필수 입력 - Slave, Recovery 추가 시에도 동일한 Sub 도메인 정책이 추가됨 | ### 선택 옵션 `createCloudMysqlInstance`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--cloudMysqlImageProductCode` | String | Optional | Cloud DB for MySQL 이미지 상품 코드 - 네이버 클라우드 플랫폼에서 자동 생성 - [getCloudMysqlImageProductList](/docs/cli-vmysql-getcloudmysqlimageproductlist) 참조 | | `--cloudMysqlProductCode` | String | Optional | Cloud DB for MySQL 상품 코드 - Cloud DB for MySQL 인스턴스의 서버 스펙 결정 - 기본값: 최소 사양 (메모리, CPU 순) - [getCloudMysqlProductList](/docs/cli-vmysql-getcloudmysqlproductlist) 참조 | | `--engineVersionCode` | String | Optional | DB 엔진 버전 - 미입력 시 현재 제공 중인 최신 버전으로 생성 - [getCloudMysqlImageProductList](/docs/cli-vmysql-getcloudmysqlimageproductlist) 참조 | | `--dataStorageTypeCode` | String | Optional | 데이터 스토리지 타입 코드 - `cloudMysqlImageProductCode`의 `generationCode`에 따라 유효 값 상이 - G2: `SSD` (기본값) \| `HDD` - G3: `CB2` (기본값) - 설치 이후 데이터 스토리지 타입 변경 불가 | | `--isStorageEncryption` | Boolean | Optional | 데이터 스토리지 암호화 적용 여부 (추후 적용) - `true` \| `false` (기본값) - 암호화 적용 시 DB 데이터는 암호화되어 스토리지에 저장 - `isHa`=`true`인 경우에만 암호화 적용 가능 - Cloud DB for MySQL 인스턴스 생성 이후 스토리지 암호화 설정 변경 불가 | | `--isHa` | Boolean | Optional | 고가용성 여부 - `true` (기본값) \| `false` - `true`: Standby Master 서버를 포함한 2대의 서버로 생성되며 추가 요금 발생 - `false`: `isMultiZone`, `standbyMasterSubnetNo` 사용 불가 | | `--isBackup` | Boolean | Optional | MySQL의 백업 설정 여부 - `true` (기본값) \| `false` - `isHa`=`true`인 경우, `true`로 고정됨 | | `--isAutomaticBackup` | Boolean | Optional | 백업 시점 자동 설정 여부 - `true` (기본값) \| `false` - `true`인 경우, `backupTime` 입력 불가 | | `--backupFileRetentionPeriod` | Integer | Optional | 백업 파일 보관 기간 (일) - `1` (기본값) - 백업은 매일 수행되며, 백업 파일은 별도의 스토리지에 저장 - InnoDB 엔진으로 생성된 테이블만 백업 지원 | | `--cloudMysqlPort` | Integer | Optional | Cloud DB for MySQL 인스턴스에 접근하기 위한 TCP 포트 번호 - `10000`~`20000`(기본값:`3306`) - 한 번 지정한 포트 번호는 변경 불가 | | `--isPrivateSubDomain` | Boolean | Optional | Private Sub 도메인 사용 여부 - `true` \| `false` - `true`인 경우, `privateSubDomainPrefix` 지정 가능 | | `--isDeleteProtection` | Boolean | Optional | 클러스터 반납 보호 여부 - `true` \| `false` (기본값) - `true`인 경우, 클러스터 반납 불가 | ### 공통 옵션 `vmysql` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud DB for MySQL (VPC) 옵션](/docs/cli-vmysql#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 Cloud DB for MySQL 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ```shell ./ncloud vmysql createCloudMysqlInstance \ --vpcNo 98765432 \ --subnetNo 23456789 \ --cloudMysqlServiceName test-mysql \ --cloudMysqlServerNamePrefix testmysql \ --cloudMysqlDatabaseName testdb \ --cloudMysqlUserName testuser \ --cloudMysqlUserPassword Examplepw123! \ --hostIp % \ --cloudMysqlImageProductCode SW.VMYSL.OS.LNX64.ROCKY.0810.MYSQL.B050 \ --cloudMysqlProductCode SVR.VDBAS.HICPU.C002.M004.NET.HDD.B050.G002 \ --engineVersionCode 8.0.36 \ --isHa true \ --isMultiZone true \ --standbyMasterSubnetNo 23456790 \ --cloudMysqlPort 13306 \ --regionCode KR \ --output json ``` ### 출력 출력 예시는 다음과 같습니다. ```json { "createCloudMysqlInstanceResponse": { "totalRows": 1, "cloudMysqlInstanceList": [ { "cloudMysqlInstanceNo": "12345678", "cloudMysqlServiceName": "test-mysql", "cloudMysqlInstanceStatusName": "creating", "cloudMysqlInstanceStatus": { "code": "INIT", "codeName": "CLOUD DATABASE(VPC) Init 상태" }, "cloudMysqlInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Creat 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": true, "isBackup": true, "backupFileRetentionPeriod": 1, "backupTime": "00:00", "generationCode": "G2", "createDate": "2026-06-04T16:50:56+0900", "accessControlGroupNoList": [], "cloudMysqlConfigList": [], "cloudMysqlServerInstanceList": [ { "cloudMysqlServerName": "testmysql-001-97mj", "cloudMysqlServerRole": { "code": "M", "codeName": "Master" }, "cloudMysqlServerInstanceStatusName": "creating", "cloudMysqlServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudMysqlServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 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-04T16:50:56+0900" }, { "cloudMysqlServerName": "testmysql-002-97mk", "cloudMysqlServerRole": { "code": "H", "codeName": "Standby Master" }, "cloudMysqlServerInstanceStatusName": "creating", "cloudMysqlServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudMysqlServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudMysqlProductCode": "SVR.VDBAS.HICPU.C002.M004.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "98765432", "subnetNo": "23456790", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "isStorageEncryption": false, "dataStorageSize": 10737418240, "cpuCount": 2, "memorySize": 4294967296, "createDate": "2026-06-04T16:50:56+0900" } ] } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```