--- title: "createServerInstances" slug: "compute-vserver-server-createserverinstances" tags: ["Server"] updated: 2026-10-22T10:47:00Z published: 2026-10-22T10:47:00Z canonical: "api-gov.ncloud-docs.com/compute-vserver-server-createserverinstances" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createServerInstances VPC 환경에서 이용 가능합니다. 서버 인스턴스(VM)를 생성합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vserver/v2/createServerInstances | 참고 - 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. - **XEN/RHV/KVM** 하이퍼바이저 타입의 서버 인스턴스(VM)를 생성하려면 serverImageNo와 serverSpecCode를 사용합니다. 또한, serverImageProductCode와 serverProductCode를 이용하면 **XEN/RHV** 하이퍼바이저 타입의 서버 인스턴스(VM)만 생성할 수 있습니다. ### 요청 헤더 Server API에서 공통으로 사용하는 헤더에 대한 정보는 [Server 요청 헤더](/docs/compute-vserver#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - 조회 결과의 첫 번째 리전 (기본값) | | `memberServerImageInstanceNo` | String | Conditional | 서버 이미지 인스턴스 번호 - 사용자가 생성한 서버 이미지로 서버 생성 시 입력 - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getMemberServerImageInstanceList](/docs/compute-vserver-serverimage-getmemberserverimageinstancelist) 참조 | | `serverImageNo` | String | Conditional | 서버 이미지 번호 - 신규 서버 이미지로 서버 생성 시 입력 (KVM, RHV, XEN) - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getServerImageList](/docs/compute-vserver-serverimage-getServerImageList) 참조 | | `serverImageProductCode` | String | Conditional | 서버 이미지 상품 코드 - 신규 서버 이미지로 서버 생성 시 입력 (RHV, XEN) - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getServerImageProductList](/docs/compute-vserver-server-common-getserverimageproductlist) 참조 | | `serverSpecCode` | String | Conditional | 서버 스펙 코드 - `serverImageNo` 사용 시 서버 스펙 설정 - 기본값: 최소 사양(메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(NET) 순) - [getServerSpecList](/docs/compute-vserver-server-common-getserverspeclist) 참조 | | `serverProductCode` | String | Optional | 서버 상품 코드 - `serverImageProductCode` 사용 시 서버 스펙 설정 - 기본값: 최소 사양(메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(NET) 순) - [getServerProductList](/docs/compute-vserver-server-common-getserverproductlist) 참조 | | `vpcNo` | String | Required | VPC 번호 - 서버 인스턴스를 생성할 VPC 설정 - [getVpcList](/docs/networking-vpc-vpcmanagement-getvpclist) 참조 | | `subnetNo` | String | Required | Subnet 번호 - 기본 네트워크 인터페이스의 Subnet 설정 - [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 | | `isEncryptedBaseBlockStorageVolume` | Boolean | Optional | 기본 블록 스토리지 볼륨 암호화 여부 - `true` \| `false` (기본값) - `true`: 암호화 - `false`: 암호화 안 함 - RHV 서버 이미지에서만 설정 가능 | | `feeSystemTypeCode` | String | Optional | 요금제 유형 코드 - `MTRAT` (기본값) \| `FXSUM` - `MTRAT`: 시간 요금제 (종량제) - `FXSUM`: 월 요금제 (정액제) | | `serverCreateCount` | Integer | Optional | 서버 생성 수 - 1~100 (기본값: 1) | | `serverCreateStartNo` | Integer | Optional | 서버 생성 시작 번호 - 0~999 (기본값: 1) - 서버 2대 이상 생성 시 서버 이름에 부여되는 일련 번호의 시작 번호 결정 가능 - `serverCreateStartNo`와 `serverCreateCount`의 합은 1000 초과 불가 | | `serverName` | String | Optional | 서버 이름 - 영문 소문자, 숫자, 특수 문자 '-'를 조합하여 3~40자 이내로 입력 (Windows 서버의 경우 3~15자) - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 미입력 시 자동 생성 (기본값) | | `networkInterfaceList.N.networkInterfaceOrder` | Integer | Required | 네트워크 인터페이스 순서 - 0~2 - 기본 네트워크 인터페이스: 0 - 최대 3개 입력 가능 - 디바이스 명명 기준으로 사용 - <예시> 순서가 2인 경우, 디바이스 이름은 eth2 | | `networkInterfaceList.N.networkInterfaceNo` | String | Conditional | 네트워크 인터페이스 번호 - 사용자가 직접 생성한 네트워크 인터페이스 추가 시 필수 입력 - [getNetworkInterfaceList](/docs/compute-vserver-networkinterface-getnetworkinterfacelist) 참조 | | `networkInterfaceList.N.subnetNo` | String | Conditional | 네트워크 인터페이스의 Subnet 번호 - 신규 네크워크 인터페이스 생성 또는 `networkInterfaceNo` 입력 시 필수 입력 - 기본 네트워크 인터페이스인 경우, 자동 할당 - [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 | | `networkInterfaceList.N.ip` | String | Optional | 네트워크 인터페이스의 IP 주소 - 신규 네트워크 인터페이스 생성 시 직접 설정 가능 - 네트워크 인터페이스가 생성되는 Subnet의 IP 범위 내 입력 - Subnet의 0~5번째, 마지막 IP 주소 사용 불가 - Subnet 범위 내 IP 주소 중복 불가 - 미입력 시 조건 만족하는 값을 순차적으로 자동 할당 (기본값) | | `networkInterfaceList.N.accessControlGroupNoList.N` | Array | Conditional | 네트워크 인터페이스의 ACG 번호 목록 - 신규 네트워크 인터페이스 생성 시 필수 입력 - 최대 3개 입력 가능 - <예시> `accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345` - [getAccessControlGroupList](/docs/compute-vserver-acg-getaccesscontrolgrouplist) 참조 | | `placementGroupNo` | String | Optional | 물리 배치 그룹 번호 - 서버의 소속 물리 배치 그룹 설정 - [getPlacementGroupList](/docs/compute-vserver-server-placementgroup-getplacementgrouplist) 참조 | | `isProtectServerTermination` | Boolean | Optional | 반납 보호 여부 - 실수로 서버를 반납하는 사고 방지 - `true` \| `false` (기본값) - `true`: 보호 - `false`: 보호 안 함 | | `serverDescription` | String | Optional | 서버 설명(Byte) - 0~1000 | | `initScriptNo` | String | Optional | 초기화 스크립트 번호 - 최초 부팅 시 사용자가 설정한 초기화 스크립트 실행 - [getInitScriptList](/docs/compute-vserver-initscript-getinitscriptlist) 참조 | | `loginKeyName` | String | Optional | 인증키 이름 - [getLoginKeyList](/docs/compute-vserver-server-loginkey-getloginkeylist) 참조 - 기본값: 최근 생성 인증키 | | `associateWithPublicIp` | Boolean | Optional | 신규 공인 IP 생성 및 할당 여부 - `true` \| `false` (기본값) - `true`: 할당 - `false`: 할당 안 함 - Public Subnet인 경우에 사 가능 - `serverCreateCount`가 1인 경우에 사용 가능 - 서버 생성 후 운영 중 상태로 전환 시 할당 완료 | | `raidTypeName` | String | Conditional | RAID 유형 이름 - 베어메탈 서버 생성 시 필수 입력 - [getRaidList](/docs/compute-vserver-server-common-getraidlist) 참조 | | `blockDevicePartitionList.N.mountPoint` | String | Optional | 마운트 포인트 - `/(root) ` 경로로 시작하는 마운트 포인트 입력 - 첫 번째 마운트 포인트는 반드시 `/(root)`로 입력 - `/` 하위 경로는 영문 소문자, 숫자 입력만 허용하며 영문 소문자로 시작 - 운영 체제별 시스템 디렉터리로 사용 중인 경로명은 입력 불가 - <예시> /root, /bin, /dev | | `blockDevicePartitionList.N.partitionSize` | String | Optional | 파티션 용량 - 50GB 이상 | | `blockStorageMappingList.N.order` | Integer | Required | 생성 스토리지 순서 - KVM만 사용 가능 - 기본 스토리지는 반드시 1개 할당 - 기본 스토리지: 0 - 추가 스토리지: 1~20 - 기본 스토리지 포함 최대 21개 할당 가능 | | `blockStorageMappingList.N.snapshotInstanceNo` | String | Optional | 생성 스토리지 스냅샷 번호 - 스냅샷으로 생성 시 입력 - KVM만 사용 가능 | | `blockStorageMappingList.N.blockStorageSize` | String | Optional | 생성 스토리지 크기 - KVM만 사용 가능 | | `blockStorageMappingList.N.blockStorageName` | String | Optional | 생성 스토리지 이름 - KVM만 사용 가능 | | `blockStorageMappingList.N.blockStorageVolumeTypeCode` | String | Optional | 생성 스토리지 볼륨 타입 코드 - KVM만 사용 가능 - [getBlockStorageVolumeTypeList](/docs/compute-vserver-storage-getblockstoragevolumetypelist) 참조 | | `blockStorageMappingList.N.noBlockStorage` | Boolean | Conditional | 스토리지 제외 여부 - `true` \| `false` - `true`: 제외 - `false`: 제외 안 함 (`snapshotInstanceNo` 필수 입력) - 기본 스토리지 사용 불가 | | `blockStorageMappingList.N.emptyBlockStorage` | Boolean | Conditional | 신규 스토리지 생성 여부 - `true` \| `false` - `true`: 생성 - `false`: 생성 안 함 (`snapshotInstanceNo` 필수 입력) - 기본 스토리지 사용 불가 | | `fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool 번호 - [getFabricClusterPoolList](/docs/compute-vserver-fabriccluster-getfabricclusterpoollist) 참조 | | `responseFormatType` | String | Optional | 응답 데이터의 형식 - `xml` (기본값) \| `json` | 참고 요청 쿼리 파라미터 입력 시 다음 내용을 참고해 주십시오. - 신규 서버 이미지로 서버를 생성하는 경우, 생성할 서버의 하이퍼바이저 타입에 따라 사용 가능한 필드가 다음과 같이 상이합니다. - KVM: `serverImageNo`와 `serverSpecCode` 사용 - XEN: `serverImageNo`와 `serverSpecCode` 또는 `serverImageProductCode`와 `serverProductCode` 사용 - RHV: `serverImageNo`와 `serverSpecCode` 또는 `serverImageProductCode`와 `serverProductCode` 사용 - `associateWithPublicIp`: 공인 IP 할당 후 요금이 부과되므로 사용하지 않는 경우에는 반납해 주십시오. - `blockDevicePartitionList.N.mountPoint`: 생성할 서버 스펙에 따라 파티션을 지원하지 않을 수 있습니다. ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.gov-ntruss.com/vserver/v2/createServerInstances ?regionCode=KR &serverImageProductCode=SW.VSVR.OS.LNX64.UBNTU.SVR2004.B050 &vpcNo=***75 &subnetNo=***36 &serverProductCode=SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002 &feeSystemTypeCode=MTRAT &serverCreateCount=1 &serverName=test-*** &networkInterfaceList.1.networkInterfaceOrder=0 &networkInterfaceList.1.accessControlGroupNoList.1=***43 &isProtectServerTermination=false &loginKeyName=test-*** &associateWithPublicIp=true &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `createServerInstancesResponse` | Object | - | 응답 결과 - [ServerInstanceList](/docs/common-vapidatatype-serverinstancelist) 참조 | | `createServerInstancesResponse.requestId` | String | - | 요청에 대한 아이디 - UUID 형식 | | `createServerInstancesResponse.returnCode` | String | - | 응답 코드 | | `createServerInstancesResponse.returnMessage` | String | - | 응답 메시지 | ### 응답 상태 코드 Server API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Server 응답 상태 코드](/docs/compute-vserver#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "createServerInstancesResponse": { "totalRows": 1, "serverInstanceList": [ { "serverInstanceNo": "*****9212", "serverName": "test-***", "serverDescription": "", "cpuCount": 2, "memorySize": 8589934592, "platformType": { "code": "UBS64", "codeName": "Ubuntu Server 64 Bit" }, "loginKeyName": "test-***", "publicIpInstanceNo": "", "publicIp": "", "serverInstanceStatus": { "code": "INIT", "codeName": "서버 INIT 상태" }, "serverInstanceOperation": { "code": "NULL", "codeName": "서버 NULL OP" }, "serverInstanceStatusName": "init", "createDate": "2025-06-13T17:01:34+0900", "uptime": "2025-06-13T17:01:33+0900", "serverImageProductCode": "SW.VSVR.OS.LNX64.UBNTU.SVR2004.B050", "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002", "isProtectServerTermination": false, "zoneCode": "KR-1", "regionCode": "KR", "vpcNo": "", "subnetNo": "", "networkInterfaceNoList": [], "initScriptNo": "", "serverInstanceType": { "code": "STAND", "codeName": "Standard" }, "baseBlockStorageDiskType": { "code": "NET", "codeName": "네트웍 스토리지" }, "baseBlockStorageDiskDetailType": { "code": "SSD", "codeName": "SSD" }, "placementGroupNo": "", "placementGroupName": "", "memberServerImageInstanceNo": "", "hypervisorType": { "code": "XEN", "codeName": "XEN" }, "serverImageNo": "16187005", "serverSpecCode": "s2-g2-s50", "eventList": [] } ], "requestId": "e4a3ca5e-9b81-4b3b-8011-ad0f0e2bf71a", "returnCode": "0", "returnMessage": "success" } } ```