Cloud DB for MySQL 인스턴스를 생성합니다.
구문
createCloudMysqlInstance 구문은 다음과 같습니다.
./ncloud vmysql createCloudMysqlInstance \
--vpcNo <vpc-no> \
--subnetNo <subnet-no> \
--cloudMysqlServiceName <service-name> \
--cloudMysqlServerNamePrefix <server-name-prefix> \
--cloudMysqlDatabaseName <database-name> \
--cloudMysqlUserName <user-name> \
--cloudMysqlUserPassword <user-password> \
--hostIp <host-ip> \
[--cloudMysqlImageProductCode <image-product-code>] \
[--cloudMysqlProductCode <product-code>] \
[--engineVersionCode <engine-version-code>] \
[--dataStorageTypeCode <SSD|HDD|CB1>] \
[--isStorageEncryption <true|false>] \
[--isHa <true|false>] \
[--isMultiZone <true|false>] \
[--standbyMasterSubnetNo <standby-subnet-no>] \
[--isBackup <true|false>] \
[--isAutomaticBackup <true|false>] \
[--backupTime <hh:mm>] \
[--backupFileRetentionPeriod <retention-days>] \
[--cloudMysqlPort <port>] \
[--isPrivateSubDomain <true|false>] \
[--privateSubDomainPrefix <private-sub-domain-prefix>] \
[--isDeleteProtection <true|false>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudMysqlInstance 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudMysqlInstance의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Required | Cloud DB for MySQL 인스턴스를 생성할 VPC 번호 |
--subnetNo |
String | Required | Cloud DB for MySQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호
|
--cloudMysqlServiceName |
String | Required | Cloud DB for MySQL 서비스 이름
|
--cloudMysqlServerNamePrefix |
String | Required | Cloud DB for MySQL 서버 이름 접두사
|
--cloudMysqlDatabaseName |
String | Required | Cloud DB for MySQL 인스턴스에 기본으로 생성할 DB 이름
|
--cloudMysqlUserName |
String | Required | DB User 계정 ID
|
--cloudMysqlUserPassword |
String | Required | DB User 계정 비밀번호
|
--hostIp |
String | Required | MySQL 서버에 접속을 허용할 호스트 IP 주소
|
--isMultiZone |
Boolean | Conditional | 멀티존 여부
|
--standbyMasterSubnetNo |
String | Conditional | Standby Master 서버의 Subnet 번호
|
--backupTime |
String | Conditional | 백업 시점 설정 (HH:MM)
|
--privateSubDomainPrefix |
String | Conditional | Private 도메인에 추가할 Sub 도메인 입력
|
선택 옵션
createCloudMysqlInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudMysqlImageProductCode |
String | Optional | Cloud DB for MySQL 이미지 상품 코드
|
--cloudMysqlProductCode |
String | Optional | Cloud DB for MySQL 상품 코드
|
--engineVersionCode |
String | Optional | DB 엔진 버전
|
--dataStorageTypeCode |
String | Optional | 데이터 스토리지 타입 코드
|
--isStorageEncryption |
Boolean | Optional | 데이터 스토리지 암호화 적용 여부 (추후 적용)
|
--isHa |
Boolean | Optional | 고가용성 여부
|
--isBackup |
Boolean | Optional | MySQL의 백업 설정 여부
|
--isAutomaticBackup |
Boolean | Optional | 백업 시점 자동 설정 여부
|
--backupFileRetentionPeriod |
Integer | Optional | 백업 파일 보관 기간 (일)
|
--cloudMysqlPort |
Integer | Optional | Cloud DB for MySQL 인스턴스에 접근하기 위한 TCP 포트 번호
|
--isPrivateSubDomain |
Boolean | Optional | Private Sub 도메인 사용 여부
|
--isDeleteProtection |
Boolean | Optional | 클러스터 반납 보호 여부
|
공통 옵션
vmysql 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for MySQL 옵션을 참조해 주십시오.
예시
Cloud DB for MySQL 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./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.STAND.C002.M008.NET.HDD.B050.G001 \
--engineVersionCode 8.0.36 \
--isHa true \
--isMultiZone true \
--standbyMasterSubnetNo 23456790 \
--cloudMysqlPort 113306 \
--regionCode FKR \
--output 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": 313306
"isHa": true,
"isMultiZone": false,
"isBackup": true,
"backupFileRetentionPeriod": 1,
"backupTime": "00:00",
"generationCode": "G2",
"createDate": "2026-06-19T17:42:23+0900",
"accessControlGroupNoList": [],
"cloudMysqlConfigList": [],
"cloudMysqlServerInstanceList": [
{
"cloudMysqlServerName": "testmysql-001-3ohr",
"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.STAND.C002.M008.NET.HDD.B050.G001",
"regionCode": "FKR",
"zoneCode": "FKR-1",
"vpcNo": "98765432",
"subnetNo": "23456789",
"isPublicSubnet": false,
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"isStorageEncryption": false,
"dataStorageSize": 10737418240,
"cpuCount": 2,
"memorySize": 8589934592,
"createDate": "2026-06-19T17:42:23+0900"
},
{
"cloudMysqlServerName": "testmysql-002-3ohs",
"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.STAND.C002.M008.NET.HDD.B050.G001",
"regionCode": "FKR",
"zoneCode": "FKR-1",
"vpcNo": "98765432",
"subnetNo": "23456790",
"isPublicSubnet": false,
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"isStorageEncryption": false,
"dataStorageSize": 10737418240,
"cpuCount": 2,
"memorySize": 8589934592,
"createDate": "2026-06-19T17:42:23+0900"
}
]
}
],
"requestId": "a95ed1e5-31e2-4d98-9261-5384b0da177e",
"returnCode": "0",
"returnMessage": "success"
}
}