---
title: "createServerInstances"
slug: "cli-vserver-server-createserverinstances"
tags: ["Server"]
updated: 2026-06-25T09:10:26Z
published: 2026-06-25T09:10:26Z
canonical: "cli-fin.ncloud-docs.com/cli-vserver-server-createserverinstances"
---

> ## 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.

# createServerInstances

서버 인스턴스(VM)를 생성합니다.

## 구문<a name="구문"></a>

`createServerInstances` 구문은 다음과 같습니다.

```shell
./ncloud vserver createServerInstances \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --networkInterfaceList <network-interface-config> \
    --memberServerImageInstanceNo <member-image-no> | --serverImageNo <image-no> | --serverImageProductCode <image-product-code> \
    [--serverSpecCode <server-spec-code>] \
    [--serverProductCode <server-product-code>] \
    [--raidTypeName <raid-type-name>] \
    [--blockDevicePartitionList <block-device-partition-config>] \
    [--blockStorageMappingList <block-storage-mapping-config>] \
    [--isEncryptedBaseBlockStorageVolume <true|false>] \
    [--feeSystemTypeCode <MTRAT|FXSUM>] \
    [--serverCreateCount <count>] \
    [--serverCreateStartNo <start-no>] \
    [--serverName <server-name>] \
    [--placementGroupNo <placement-group-no>] \
    [--isProtectServerTermination <true|false>] \
    [--serverDescription <description>] \
    [--initScriptNo <init-script-no>] \
    [--loginKeyName <login-key-name>] \
    [--associateWithPublicIp <true|false>] \
    [--isPreInstallGpuDriver <true|false>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

## 옵션<a name="옵션"></a>

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

### 필수 옵션<a name="필수옵션"></a>

`createServerInstances`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| :--- | :--- | :--- | :--- |
| `--vpcNo` | String | Required | VPC 번호<ul><li>서버 인스턴스를 생성할 VPC 설정</li><li>[getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 참조</li></ul> |
| `--subnetNo` | String | Required | Subnet 번호<ul><li>기본 네트워크 인터페이스의 Subnet 설정</li><li>[getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조</li></ul> |
| `--networkInterfaceList` | List | Required | 네트워크 인터페이스 목록<ul><li>각 네트워크 인터페이스는 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력<ul><li>`networkInterfaceOrder` (Required): 네트워크 인터페이스 순서. `0`~`2` (기본 네트워크 인터페이스: `0`). 최대 3개 입력 가능. 디바이스 명명 기준으로 사용 (예시: 순서가 `2`인 경우 디바이스 이름은 `eth2`)</li><li>`networkInterfaceNo` (Conditional): 네트워크 인터페이스 번호. 사용자가 직접 생성한 네트워크 인터페이스 추가 시 필수 입력. [getNetworkInterfaceList](/docs/cli-vserver-networkinterface-getnetworkinterfacelist) 참조</li><li>`subnetNo` (Conditional): 네트워크 인터페이스의 Subnet 번호. 신규 네트워크 인터페이스 생성 또는 `networkInterfaceNo` 입력 시 필수 입력. 기본 네트워크 인터페이스인 경우 자동 할당. [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조</li><li>`ip` (Optional): 네트워크 인터페이스의 IP 주소. 미입력 시 조건 만족하는 값을 순차적으로 자동 할당 (기본값). 신규 네트워크 인터페이스 생성 시 직접 설정 가능. 네트워크 인터페이스가 생성되는 Subnet의 IP 범위 내 입력 (Subnet의 0~5번째, 마지막 IP 주소 사용 불가, Subnet 범위 내 IP 주소 중복 불가)</li><li>`accessControlGroupNoList` (Conditional): 네트워크 인터페이스의 ACG 번호 목록. 신규 네트워크 인터페이스 생성 시 필수 입력. 최대 3개 입력 가능. [getAccessControlGroupList](/docs/cli-vserver-acg-getaccesscontrolgrouplist) 참조</li></ul></li></ul> |
| `--memberServerImageInstanceNo` | String | Conditional | 서버 이미지 인스턴스 번호<ul><li>사용자가 생성한 서버 이미지로 서버 생성 시 입력</li><li>`memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력</li><li>[getMemberServerImageInstanceList](/docs/cli-vserver-serverimage-getmemberserverimageinstancelist) 참조</li></ul> |
| `--serverImageNo` | String | Conditional | 서버 이미지 번호<ul><li>신규 서버 이미지로 서버 생성 시 입력 (KVM, RHV, XEN)</li><li>`memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력</li><li>[getServerImageList](/docs/cli-vserver-serverimage-getserverimagelist) 참조</li></ul> |
| `--serverImageProductCode` | String | Conditional | 서버 이미지 상품 코드<ul><li>신규 서버 이미지로 서버 생성 시 입력 (RHV, XEN)</li><li>`memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력</li><li>[getServerImageProductList](/docs/cli-vserver-server-common-getserverimageproductlist) 참조</li></ul> |
| `--serverSpecCode` | String | Conditional | 서버 스펙 코드<ul><li>`serverImageNo` 사용 시 서버 스펙 설정</li><li>최소 사양 (기본값)<ul><li>메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(`NET`) 순</li></ul></li><li>`serverProductCode`와 동시 사용 불가</li><li>[getServerSpecList](/docs/cli-vserver-server-common-getserverspeclist) 참조</li></ul> |
| `--raidTypeName` | String | Conditional | RAID 유형 이름<ul><li>베어메탈 서버 생성 시 필수 입력</li><li>[getRaidList](/docs/cli-vserver-server-common-getraidlist) 참조</li></ul> |

### 선택 옵션<a name="선택옵션"></a>

`createServerInstances`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| :--- | :--- | :--- | :--- |
| `--serverProductCode` | String | Optional | 서버 상품 코드<ul><li>`serverImageProductCode` 사용 시 서버 스펙 설정</li><li>최소 사양 (기본값)<ul><li>메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(`NET`) 순</li></ul></li><li>`serverSpecCode`와 동시 사용 불가</li><li>[getServerProductList](/docs/cli-vserver-server-common-getserverproductlist) 참조</li></ul> |
| `--blockDevicePartitionList` | List | Optional | 블록 디바이스 파티션 목록<ul><li>베어메탈 서버에 적용되며 서버 스펙에 따라 파티션 기능이 지원되지 않을 수 있음</li><li>각 파티션은 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력<ul><li>`mountPoint` (Optional): 마운트 포인트. `/`(root) 경로로 시작 (첫 번째 마운트 포인트는 반드시 `/`(root)로 입력). `/` 하위 경로는 영문 소문자, 숫자 입력만 허용하며 영문 소문자로 시작. 운영 체제별 시스템 디렉터리로 사용 중인 경로명은 입력 불가 (예시: `/root`, `/bin`, `/dev`)</li><li>`partitionSize` (Optional): 파티션 용량. 50GB 이상</li></ul></li></ul> |
| `--blockStorageMappingList` | List | Optional | 블록 스토리지 매핑 목록<ul><li>각 스토리지는 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력<ul><li>`order` (Required): 스토리지 순서. `0`~`20`. 기본 스토리지(`order=0`)는 반드시 1개 할당해야 하며, 최대 20개 추가 가능 (기본 스토리지 포함 최대 21개). KVM만 사용 가능</li><li>`snapshotInstanceNo` (Optional): 스토리지 스냅샷 인스턴스 번호. 스냅샷으로 생성 시 입력. KVM만 사용 가능</li><li>`blockStorageSize` (Optional): 스토리지 크기. KVM만 사용 가능</li><li>`blockStorageName` (Optional): 스토리지 이름. KVM만 사용 가능</li><li>`blockStorageVolumeTypeCode` (Optional): 스토리지 볼륨 유형 코드. KVM만 사용 가능. [getBlockStorageVolumeTypeList](/docs/cli-vserver-storage-getblockstoragevolumetypelist) 참조</li><li>`noBlockStorage` (Conditional): 스토리지 제외 여부. `true` (제외) \| `false` (제외 안 함, `snapshotInstanceNo` 필수 입력). 기본 스토리지 사용 불가</li><li>`emptyBlockStorage` (Conditional): 신규 스토리지 생성 여부. `true` (생성) \| `false` (생성 안 함, `snapshotInstanceNo` 필수 입력). 기본 스토리지 사용 불가</li></ul></li></ul> |
| `--isEncryptedBaseBlockStorageVolume` | Boolean | Optional | 기본 블록 스토리지 볼륨 암호화 여부<ul><li>`true` \| `false` (기본값)<ul><li>`true`: 암호화</li><li>`false`: 암호화 안 함</li></ul></li><li>RHV 서버 이미지에서만 설정 가능</li></ul> |
| `--feeSystemTypeCode` | String | Optional | 요금제 유형 코드<ul><li>`MTRAT` (기본값) \| `FXSUM`<ul><li>`MTRAT`: 시간 요금제 (종량제)</li><li>`FXSUM`: 월 요금제 (정액제)</li></ul></li></ul> |
| `--serverCreateCount` | Integer | Optional | 서버 생성 수<ul><li>`1`~`100` (기본값: `1`)</li></ul> |
| `--serverCreateStartNo` | Integer | Optional | 서버 생성 시작 번호<ul><li>`0`~`999` (기본값: `1`)</li><li>서버 2대 이상 생성 시 서버 이름에 부여되는 일련 번호의 시작 번호 결정 가능</li><li>`serverCreateStartNo`와 `serverCreateCount`의 합은 1,000 초과 불가</li></ul> |
| `--serverName` | String | Optional | 서버 이름<ul><li>미입력 시 자동 생성</li><li>문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성</li><li>영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~30자 이내로 입력 (Windows 서버의 경우 3~15자)</li></ul> |
| `--placementGroupNo` | String | Optional | 물리 배치 그룹 번호<ul><li>서버의 소속 물리 배치 그룹 설정</li><li>[getPlacementGroupList](/docs/cli-vserver-server-placementgroup-getplacementgrouplist) 참조</li></ul> |
| `--isProtectServerTermination` | Boolean | Optional | 반납 보호 여부<ul><li>실수로 서버를 반납하는 사고 방지</li><li>`true` \| `false` (기본값)<ul><li>`true`: 보호</li><li>`false`: 보호 안 함</li></ul></li></ul> |
| `--serverDescription` | String | Optional | 서버 설명 (Byte)<ul><li>0~1,000</li></ul> |
| `--initScriptNo` | String | Optional | 초기화 스크립트 번호<ul><li>최초 부팅 시 사용자가 설정한 초기화 스크립트 실행</li><li>[getInitScriptList](/docs/cli-vserver-initscript-getinitscriptlist) 참조</li></ul> |
| `--loginKeyName` | String | Optional | 인증키 이름<ul><li>최근 생성 인증키</li><li>[getLoginKeyList](/docs/cli-vserver-server-loginkey-getloginkeylist) 참조</li></ul> |
| `--associateWithPublicIp` | Boolean | Optional | 신규 공인 IP 생성 및 할당 여부<ul><li>`true` \| `false` (기본값)<ul><li>`true`: 할당</li><li>`false`: 할당 안 함</li></ul></li><li>서버 생성 후 운영 중 상태로 전환 시 할당 완료</li><li>Public Subnet인 경우에 사용 가능</li><li>`serverCreateCount`가 1인 경우에 사용 가능</li></ul> |
| `--isPreInstallGpuDriver` | Boolean | Optional | GPU Driver 사전 설치 여부<ul><li>`true` \| `false` (기본값)<ul><li>`true`: 설치</li><li>`false`: 설치 안 함</li></ul></li></ul> |

### 공통 옵션<a name="공통옵션"></a>

`vserver` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Server 옵션](/docs/cli-vserver#옵션)을 참조해 주십시오.

## 예시<a name="예시"></a>

서버 인스턴스 생성 요청이 성공하면 생성한 서버 인스턴스의 식별 정보와 초기 상태가 반환됩니다.

### 명령<a name="명령"></a>

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

```shell
./ncloud vserver createServerInstances \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --networkInterfaceList "networkInterfaceOrder='0', accessControlGroupNoList=['67890123']" \
    --serverImageProductCode SW.VSVR.OS.LNX64.ROCKY.0810.B050 \
    --serverProductCode SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G001 \
    --serverName test-server-01 \
    --loginKeyName test-server-instance-key-01 \
    --regionCode FKR \
    --output json
```

### 출력<a name="출력"></a>

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

```json
{
  "createServerInstancesResponse": {
    "totalRows": 1,
    "serverInstanceList": [
      {
        "serverInstanceNo": "34567890",
        "serverName": "test-server-01",
        "cpuCount": 2,
        "memorySize": 8589934592,
        "platformType": {
          "code": "LNX64",
          "codeName": "Linux 64 Bit"
        },
        "loginKeyName": "test-server-instance-key-01",
        "serverInstanceStatus": {
          "code": "INIT",
          "codeName": "서버 INIT 상태"
        },
        "serverInstanceOperation": {
          "code": "NULL",
          "codeName": "서버 NULL OP"
        },
        "serverInstanceStatusName": "init",
        "createDate": "2026-05-27T16:38:35+0900",
        "uptime": "2026-05-27T16:38:35+0900",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
        "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G001",
        "isProtectServerTermination": false,
        "zoneCode": "FKR-1",
        "regionCode": "FKR",
        "vpcNo": "12345678",
        "subnetNo": "null",
        "networkInterfaceNoList": [],
        "serverInstanceType": {
          "code": "STAND",
          "codeName": "Standard"
        },
        "baseBlockStorageDiskType": {
          "code": "NET",
          "codeName": "네트웍 스토리지"
        },
        "baseBlockStorageDiskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "hypervisorType": {
          "code": "XEN",
          "codeName": "XEN"
        },
        "serverImageNo": "45678901",
        "serverSpecCode": "s2-g1-s50",
        "eventList": [],
        "isPreInstallGpuDriver": false
      }
    ],
    "requestId": "6d9e9b12-89e0-44e2-9dd1-923a4aaaa791",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```