--- title: "ServerInstance" slug: "common-vapidatatype-serverinstance" tags: ["VPC"] updated: 2026-07-23T09:04:03Z published: 2026-07-23T09:04:03Z canonical: "api.ncloud-docs.com/common-vapidatatype-serverinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # ServerInstance VPC 환경에서 이용 가능합니다. 서버 인스턴스입니다. ## 구문 구문은 다음과 같습니다. ``` private String serverInstanceNo; private String serverName; private String serverDescription; private Integer cpuCount; private Long memorySize; private CommonCode platformType; private String loginKeyName; private String publicIpInstanceNo; private String publicIp; private CommonCode serverInstanceStatus; private CommonCode serverInstanceOperation; private String serverInstanceStatusName; private Date createDate; private Date uptime; private String serverImageProductCode; private String serverProductCode; private Boolean isProtectServerTermination; private String zoneCode; private String regionCode; private String vpcNo; private String subnetNo; private NetworkInterfaceNoList networkInterfaceNoList; private String initScriptNo; private CommonCode serverInstanceType; private CommonCode baseBlockStorageDiskType; private CommonCode baseBlockStorageDiskDetailType; private String placementGroupNo; private String placementGroupName; private String memberServerImageInstanceNo; private List blockDevicePartitionList; private CommonCode hypervisorType; private String serverImageNo; private String serverSpecCode; private List eventList; private String fabricClusterPoolNo; private String fabricClusterPoolName; private String fabricClusterMode; private String fabricClusterNo; private String fabricClusterName; private Boolean isPreInstallGpuDriver; ``` ## 필드 필드에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `serverInstanceNo` | String | Required | 서버 인스턴스 번호 - 서버 인스턴스(VM)를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 | | `serverName` | String | Required | 서버 이름 | | `serverDescription` | String | Optional | 서버 설명 | | `cpuCount` | Integer | Required | Virtual CPU 개수 | | `memorySize` | Long | Required | 메모리 사이즈(Byte) | | `platformType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버에 설치된 OS 이미지의 플랫폼 구분 - `LNX32` \| `LNX64` \| `WND32` \| `WND64` \| `UBD64` \| `UBS64` | | `loginKeyName` | String | Required | 서버 인스턴스에 할당된 로그인 키 이름 | | `publicIpInstanceNo` | String | Optional | 서버 인스턴스에 할당된 공인 IP 인스턴스 번호 | | `publicIp` | String | Optional | 서버 인스턴스에 할당된 공인 IP 주소 | | `serverInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 인스턴스 상태 - `INIT` \| `CREAT` \| `RUN` \| `NSTOP` \| `TERMT` \| `FSTOP` \| `SD_FL` \| `RS_FL` \| `ST_FL` - `INIT`: Initiated - `CREAT`: Created - `RUN`: Run - `NSTOP`: Normal Stopped - `TERMT`: Terminated - `FSTOP`: Failure Stopped - `SD_FL`: Start Failure - `RS_FL`: Restart Failure - `ST_FL`: Start Failure | | `serverInstanceOperation` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 인스턴스 운영 상태 - `START` \| `SHTDN` \| `RESTA` \| `TERMT` \| `NULL` \| `MIGRA` \| `COPY` \| `SETUP` \| `HREST` \| `HSHTD` \| `CHNG` \| `CREAT` - `START`: Start - `SHTDN`: Shutdown - `RESTA`: Restart - `TERMT`: Terminate - `NULL`: No Operation - `MIGRA`: Migration - `COPY`: Copy - `SETUP`: Setup - `HREST`: 강제 Restart - `HSHTD`: 강제 Shutdown - `CHNG`: Spec Change - `CREAT`: Create | | `serverInstanceStatusName` | String | Required | 서버 인스턴스 상태명 - 서버 인스턴스 상태와 서버 인스턴스 운영 상태를 조합하여 현재의 서버 인스턴스 상태명 전달 - `init` \| `creating` \| `booting` \| `setting up` \| `running` \| `rebooting` \| `hard rebooting` \| `shutting down` \| `hard shutting down` \| `terminating` \| `changingSpec` \| `copying` \| `repairing` | | `createDate` | Date | Required | 생성 일시(YYYY-MM-DDThh:mm:ssZ) | | `uptime` | Date | Required | 업타임(YYYY-MM-DDThh:mm:ssZ) | | `serverImageProductCode` | String | Required | 서버 이미지 상품 코드 - 네이버 클라우드 플랫폼에서 관리하는 서버 이미지 상품에 해당하는 상품 코드 | | `serverProductCode` | String | Required | 서버 상품 코드 - 네이버 클라우드 플랫폼에서 관리하는 서버 상품에 해당하는 상품 코드 | | `isProtectServerTermination` | Boolean | Required | 서버 반납 보호 여부 - `true` \| `false` - `true`인 경우 반납 시 반납이 되지 않음 | | `zoneCode` | String | Required | 서버가 위치한 존 코드 | | `regionCode` | String | Required | 서버가 위치한 리전 코드 | | `vpcNo` | String | Required | 서버가 위치한 VPC 번호 | | `subnetNo` | String | Required | 서버가 위치한 Subnet 번호 | | `networkInterfaceNoList` | [NetworkInterfaceNoList](/docs/common-vapidatatype-networkinterfacenolist) | Required | 서버에 할당된 네트워크 인터페이스 번호 목록 | | `initScriptNo` | String | Optional | 초기화 스크립트 번호 - 서버 첫 부팅시 수행되는 초기화 스크립트 번호 | | `serverInstanceType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 인스턴스 구분 - `MICRO` \| `COMPT` \| `STAND` \| `GPU` \| `LDISK` \| `CHADP` \| `BM` \| `VDS` - `MICRO`: Micro - `COMPT`: Compact - `STAND`: Standard - `GPU`: GPU - `LDISK`: Local Disk - `CHADP`: Cloud Hadoop - `BM`: Bare Metal - `VDS`: Virtual Dedicated Server | | `baseBlockStorageDiskType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 기본 블록 스토리지 디스크 유형 - `NET` - `NET`: Network Disk | | `baseBlockStorageDiskDetailType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 기본 블록 스토리지 디스크 상세 유형 - `HDD` \| `SSD` | | `placementGroupNo` | String | Optional | 서버 인스턴스가 배치되어 있는 물리 배치 그룹 번호 | | `placementGroupName` | String | Optional | 서버 인스턴스가 배치되어 있는 물리 배치 그룹 이름 | | `memberServerImageInstanceNo` | String | Optional | 회원 서버 이미지 인스턴스 번호 | | `blockDevicePartitionList` | List<[BlockDevicePartition](/docs/common-vapidatatype-blockdevicepartition)> | Optional | 블록 디바이스 파티션 목록 - 베어 메탈 서버인 경우 사용자 정의 파티션 정보 전달 | | `hypervisorType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 하이퍼바이저 구분 - `XEN` \| `KVM` | | `serverImageNo` | String | Required | 서버 이미지 번호 | | `serverSpecCode` | String | Required | 서버 스펙 코드 | | `eventList` | List | Optional | 이벤트 목록 | | `fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool 번호 | | `fabricClusterPoolName` | String | Optional | Fabric Cluster Pool 이름 | | `fabricClusterMode` | String | Optional | Fabric Cluster Mode - `SINGLE` \| `CLUSTER` | | `fabricClusterNo` | String | Optional | Fabric Cluster 번호 | | `fabricClusterName` | String | Optional | Fabric Cluster 이름 | | `isPreInstallGpuDriver` | Boolean | Optional | GPU Driver 사전 설치 여부 - `true` \| `false` |