VPC 환경에서 이용 가능합니다.
서버 인스턴스(VM)를 생성합니다.
구문
createServerInstances 구문은 다음과 같습니다.
./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>] \
[--fabricClusterPoolNo <fabric-cluster-pool-no>] \
[--isPreInstallGpuDriver <true|false>] \
[--regionCode <KR|SGN|JPN>] \
[--output <json|xml>]
옵션
createServerInstances 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createServerInstances의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Required | VPC 번호
|
--subnetNo |
String | Required | Subnet 번호
|
--networkInterfaceList |
List | Required | 네트워크 인터페이스 목록
|
--memberServerImageInstanceNo |
String | Conditional | 서버 이미지 인스턴스 번호
|
--serverImageNo |
String | Conditional | 서버 이미지 번호
|
--serverImageProductCode |
String | Conditional | 서버 이미지 상품 코드
|
--serverSpecCode |
String | Conditional | 서버 스펙 코드
|
--raidTypeName |
String | Conditional | RAID 유형 이름
|
선택 옵션
createServerInstances의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--serverProductCode |
String | Optional | 서버 상품 코드
serverSpecCode와 동시 사용 불가 |
--blockDevicePartitionList |
List | Optional | 블록 디바이스 파티션 목록
|
--blockStorageMappingList |
List | Optional | 블록 스토리지 매핑 목록
|
--isEncryptedBaseBlockStorageVolume |
Boolean | Optional | 기본 블록 스토리지 볼륨 암호화 여부
|
--feeSystemTypeCode |
String | Optional | 요금제 유형 코드
|
--serverCreateCount |
Integer | Optional | 서버 생성 수
|
--serverCreateStartNo |
Integer | Optional | 서버 생성 시작 번호
|
--serverName |
String | Optional | 서버 이름
|
--placementGroupNo |
String | Optional | 물리 배치 그룹 번호
|
--isProtectServerTermination |
Boolean | Optional | 반납 보호 여부
|
--serverDescription |
String | Optional | 서버 설명 (Byte)
|
--initScriptNo |
String | Optional | 초기화 스크립트 번호
|
--loginKeyName |
String | Optional | 인증키 이름
|
--associateWithPublicIp |
Boolean | Optional | 신규 공인 IP 생성 및 할당 여부
|
--fabricClusterPoolNo |
String | Optional | Fabric Cluster Pool 번호 |
--isPreInstallGpuDriver |
Boolean | Optional | GPU Driver 사전 설치 여부
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server (VPC) 옵션을 참조해 주십시오.
예시
서버 인스턴스 생성 요청이 성공하면 서버 인스턴스의 식별 정보와 초기 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver createServerInstances \
--vpcNo 12345678 \
--subnetNo 23456789 \
--networkInterfaceList "networkInterfaceOrder='0', accessControlGroupNoList=['67890123']" \
--serverImageProductCode SW.VSVR.OS.LNX64.ROCKY.0810.B050 \
--serverProductCode SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002 \
--serverName test-server-01 \
--loginKeyName test-server-instance-key-01 \
--regionCode KR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createServerInstancesResponse": {
"totalRows": 1,
"serverInstanceList": [
{
"serverInstanceNo": "34567890",
"serverName": "test-server-01",
"cpuCount": 2,
"memorySize": 4294967296,
"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-14T17:29:35+0900",
"uptime": "2026-05-14T17:29:35+0900",
"serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
"serverProductCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002",
"isProtectServerTermination": false,
"zoneCode": "KR-1",
"regionCode": "KR",
"vpcNo": "12345678",
"subnetNo": "null",
"networkInterfaceNoList": [],
"serverInstanceType": {
"code": "HICPU",
"codeName": "High-CPU"
},
"baseBlockStorageDiskType": {
"code": "NET",
"codeName": "네트웍 스토리지"
},
"baseBlockStorageDiskDetailType": {
"code": "SSD",
"codeName": "SSD"
},
"hypervisorType": {
"code": "XEN",
"codeName": "XEN"
},
"serverImageNo": "45678901",
"serverSpecCode": "c2-g2-s50",
"eventList": [],
"isPreInstallGpuDriver": false
}
],
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"returnCode": "0",
"returnMessage": "success"
}
}