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 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`regionCode`	String	Optional	리전 코드 getRegionList 참조 조회 결과의 첫 번째 리전 (기본값)
`memberServerImageInstanceNo`	String	Conditional	서버 이미지 인스턴스 번호 사용자가 생성한 서버 이미지로 서버 생성 시 입력 `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getMemberServerImageInstanceList 참조
`serverImageNo`	String	Conditional	서버 이미지 번호 신규 서버 이미지로 서버 생성 시 입력 (KVM, RHV, XEN) `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getServerImageList 참조
`serverImageProductCode`	String	Conditional	서버 이미지 상품 코드 신규 서버 이미지로 서버 생성 시 입력 (RHV, XEN) `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getServerImageProductList 참조
`serverSpecCode`	String	Conditional	서버 스펙 코드 `serverImageNo` 사용 시 서버 스펙 설정 기본값: 최소 사양(메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(NET) 순) getServerSpecList 참조
`serverProductCode`	String	Optional	서버 상품 코드 `serverImageProductCode` 사용 시 서버 스펙 설정 기본값: 최소 사양(메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형(NET) 순) getServerProductList 참조
`vpcNo`	String	Required	VPC 번호 서버 인스턴스를 생성할 VPC 설정 getVpcList 참조
`subnetNo`	String	Required	Subnet 번호 기본 네트워크 인터페이스의 Subnet 설정 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~30자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 미입력 시 자동 생성 (기본값)
`networkInterfaceList.N.networkInterfaceOrder`	Integer	Required	네트워크 인터페이스 순서 0~2 기본 네트워크 인터페이스: 0 최대 3개 입력 가능 디바이스 명명 기준으로 사용 <예시> 순서가 2인 경우, 디바이스 이름은 eth2
`networkInterfaceList.N.networkInterfaceNo`	String	Conditional	네트워크 인터페이스 번호 사용자가 직접 생성한 네트워크 인터페이스 추가 시 필수 입력 getNetworkInterfaceList 참조
`networkInterfaceList.N.subnetNo`	String	Conditional	네트워크 인터페이스의 Subnet 번호 신규 네크워크 인터페이스 생성 또는 `networkInterfaceNo` 입력 시 필수 입력 기본 네트워크 인터페이스인 경우, 자동 할당 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 참조
`placementGroupNo`	String	Optional	물리 배치 그룹 번호 서버의 소속 물리 배치 그룹 설정 getPlacementGroupList 참조
`isProtectServerTermination`	Boolean	Optional	반납 보호 여부 실수로 서버를 반납하는 사고 방지 `true` \| `false` (기본값) `true`: 보호 `false`: 보호 안 함
`serverDescription`	String	Optional	서버 설명(Byte) 0~1000
`initScriptNo`	String	Optional	초기화 스크립트 번호 최초 부팅 시 사용자가 설정한 초기화 스크립트 실행 getInitScriptList 참조
`loginKeyName`	String	Optional	인증키 이름 getLoginKeyList 참조 기본값: 최근 생성 인증키
`associateWithPublicIp`	Boolean	Optional	신규 공인 IP 생성 및 할당 여부 `true` \| `false` (기본값) `true`: 할당 `false`: 할당 안 함 Public Subnet인 경우에 사 가능 `serverCreateCount`가 1인 경우에 사용 가능 서버 생성 후 운영 중 상태로 전환 시 할당 완료
`raidTypeName`	String	Conditional	RAID 유형 이름 베어메탈 서버 생성 시 필수 입력 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 참조
`blockStorageMappingList.N.noBlockStorage`	Boolean	Conditional	스토리지 제외 여부 `true` \| `false` `true`: 제외 `false`: 제외 안 함 (`snapshotInstanceNo` 필수 입력) 기본 스토리지 사용 불가
`blockStorageMappingList.N.emptyBlockStorage`	Boolean	Conditional	신규 스토리지 생성 여부 `true` \| `false` `true`: 생성 `false`: 생성 안 함 (`snapshotInstanceNo` 필수 입력) 기본 스토리지 사용 불가
`fabricClusterPoolNo`	String	Optional	GPU Fabric Cluster Pool 지정 KVM GPU만 사용 가능 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 참조
`createServerInstancesResponse.requestId`	String	-	요청에 대한 아이디 UUID 형식
`createServerInstancesResponse.returnCode`	String	-	응답 코드
`createServerInstancesResponse.returnMessage`	String	-	응답 메시지

응답 상태 코드

Server API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Server 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

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