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.

createCloudMysqlRecoveryInstance

Prev Next

Cloud DB for MySQL 인스턴스에 Recovery 서버 인스턴스를 추가합니다.

구문

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

./ncloud vmysql createCloudMysqlRecoveryInstance \
    --cloudMysqlInstanceNo <instance-no> \
    --cloudMysqlRecoveryServerName <recovery-server-name> \
    --fileName <backup-file-name> | --recoveryTime <recovery-time> \
    [--subnetNo <subnet-no>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

createCloudMysqlRecoveryInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudMysqlRecoveryInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--cloudMysqlInstanceNo String Required Cloud DB for MySQL 인스턴스 번호
--cloudMysqlRecoveryServerName String Required Cloud DB for MySQL Recovery 서버 인스턴스 이름
  • 영어 소문자, 숫자, 특수문자 -를 조합하여 3~20자 이내로 입력
  • 문자열의 시작은 영어 소문자, 마지막은 영어 소문자 또는 숫자로 구성
  • 접두사 뒤에 3자리 숫자가 자동으로 만들어지고, 호스트명 중복 방지를 위해 임의의 텍스트가 추가로 포함되어 생성됨
  • 예시: 접두사가 test-123인 경우, test-123-001-4y1v
--fileName String Conditional 백업 파일 이름
  • 백업 파일 복원 시 백업이 완료된 시간으로 복원
  • fileName, recoveryTime 중 하나는 필수 입력
  • getCloudMysqlBackupDetailList 참조
--recoveryTime String Conditional 시점 복원 시간
--subnetNo String Conditional Cloud DB for MySQL 인스턴스에서 사용할 기본 네트워크 인터페이스의 Subnet 번호
  • Cloud DB for MySQL이 멀티존인 경우, 필수 입력
  • 멀티존이 아닌 경우, subnetNo의 입력은 받지 않으며 기존 Subnet에 생성됨
  • Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청 가능
  • Cloud DB for MySQL 인스턴스 생성 이후 Subnet 이전 불가
  • getCloudMysqlTargetSubnetList 참조

공통 옵션

vmysql 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for MySQL 옵션을 참조해 주십시오.

예시

Recovery 서버 인스턴스 생성 요청이 성공하면 Cloud DB for MySQL 인스턴스의 구성 정보와 추가된 Recovery 서버의 생성 상태가 반환됩니다.

명령

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

./ncloud vmysql createCloudMysqlRecoveryInstance \
    --cloudMysqlInstanceNo 12345678 \
    --cloudMysqlRecoveryServerName testrecovery01 \
    --subnetNo 23456789 \
    --fileName 20260604 \
    --regionCode FKR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createCloudMysqlRecoveryInstanceResponse": {
    "totalRows": 1,
    "cloudMysqlInstanceList": [
      {
        "cloudMysqlInstanceNo": "12345678",
        "cloudMysqlServiceName": "test-mysql",
        "cloudMysqlInstanceStatusName": "creating",
        "cloudMysqlInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "cloudMysqlInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null 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": "11:15",
        "generationCode": "G2",
        "createDate": "2026-06-19T11:57:42+0900",
        "accessControlGroupNoList": [
          "67890123"
        ],
        "cloudMysqlConfigList": [],
        "cloudMysqlServerInstanceList": [
          {
            "cloudMysqlServerInstanceNo": "34567890",
            "cloudMysqlServerName": "testmysql-001-3ogv",
            "cloudMysqlServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "cloudMysqlServerInstanceStatusName": "running",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M004.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.6",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-19T12:04:29+0900",
            "createDate": "2026-06-19T11:57:42+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567891",
            "cloudMysqlServerName": "testmysql-002-3ogw",
            "cloudMysqlServerRole": {
              "code": "H",
              "codeName": "Standby Master"
            },
            "cloudMysqlServerInstanceStatusName": "running",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M004.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.7",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-19T12:04:05+0900",
            "createDate": "2026-06-19T11:57:42+0900"
          },
          {
            "cloudMysqlServerInstanceNo": "34567892",
            "cloudMysqlServerName": "testmysql-003-3ogx",
            "cloudMysqlServerRole": {
              "code": "S",
              "codeName": "Slave"
            },
            "cloudMysqlServerInstanceStatusName": "running",
            "cloudMysqlServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M004.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "98765432",
            "subnetNo": "23456789",
            "isPublicSubnet": false,
            "privateDomain": "db-1a2b3c-fkr.cdb.fin-ntruss.com",
            "privateIp": "192.168.4.8",
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "isStorageEncryption": false,
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 9234180096,
            "cpuCount": 2,
            "memorySize": 4294967296,
            "uptime": "2026-06-19T13:41:07+0900",
            "createDate": "2026-06-19T13:36:01+0900"
          },
          {
            "cloudMysqlServerName": "testrecovery01-001-3ogy",
            "cloudMysqlServerRole": {
              "code": "R",
              "codeName": "Recovery"
            },
            "cloudMysqlServerInstanceStatusName": "creating",
            "cloudMysqlServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudMysqlServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudMysqlProductCode": "SVR.VDBAS.STAND.C002.M004.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": 4294967296,
            "createDate": "2026-06-19T13:58:42+0900"
          }
        ]
      }
    ],
    "requestId": "3dd8b064-bb00-4a3a-b2e6-4cb7a1acb5f9",
    "returnCode": "0",
    "returnMessage": "success"
  }
}