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.

createCloudMysqlInstance

Prev Next

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 번호
  • Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청 가능
  • Cloud DB for MySQL 인스턴스 생성 이후 Subnet 이전 불가
  • 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 참조
--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 이미지 상품 코드
--cloudMysqlProductCode String Optional Cloud DB for MySQL 상품 코드
  • Cloud DB for MySQL 인스턴스의 서버 스펙 결정
  • 기본값: 최소 사양 (메모리, CPU 순)
  • getCloudMysqlProductList 참조
--engineVersionCode String Optional DB 엔진 버전
--dataStorageTypeCode String Optional 데이터 스토리지 타입 코드
  • cloudMysqlImageProductCodegenerationCode에 따라 유효 값 상이
    • G2: SSD (기본값) | HDD
    • G3: CB1 (기본값)
  • 설치 이후 데이터 스토리지 타입 변경 불가
--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(기본값:13306`)
  • 한 번 지정한 포트 번호는 변경 불가
--isPrivateSubDomain Boolean Optional Private Sub 도메인 사용 여부
  • true | false
  • true인 경우, privateSubDomainPrefix 지정 가능
--isDeleteProtection Boolean Optional 클러스터 반납 보호 여부
  • true | false (기본값)
  • true인 경우, 클러스터 반납 불가

공통 옵션

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"
  }
}