--- title: "ServerInstance" slug: "common-apidatatype-serverinstance" updated: 2026-07-23T09:04:15Z published: 2026-07-23T09:04:15Z canonical: "api.ncloud-docs.com/common-apidatatype-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 Classic 환경에서 이용 가능합니다. 서버 인스턴스 정보입니다. ## 구문 구문은 다음과 같습니다. ``` private String serverInstanceNo; private String serverName; private String serverDescription; private Integer cpuCount; private Long memorySize; private Long baseBlockStorageSize; private CommonCode platformType; private String loginKeyName; private Boolean isFeeChargingMonitoring; private String publicIp; private String privateIp; private String serverImageName; 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 portForwardingPublicIp; private Integer portForwardingExternalPort; private Integer portForwardingInternalPort; private Zone zone; private Region region; private CommonCode baseBlockStorageDiskType; private CommonCode baseBlockStroageDiskDetailType; private CommonCode serverInstanceType; private String userData; private List accessControlGroupList; private List blockDevicePartitionList; ``` ## 필드 필드에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `serverInstanceNo` | String | Required | 서버 인스턴스 번호 - 서버 인스턴스(VM)를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 | | `serverName` | String | Required | 서버 이름 | | `serverDescription` | String | Required | 서버 설명 | | `cpuCount` | Integer | Required | Virtual CPU 수 | | `memorySize` | Long | Required | 메모리 사이즈(Byte) | | `baseBlockStorageSize` | Long | Required | 기본 블록 스토리지 사이즈(Byte) | | `platformType` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 서버에 설치된 이미지의 플랫폼 구분 - `LNX32` \| `WIN64` | | `loginKeyName` | String | Required | 서버의 패스워드를 발급한 공개 키로 암호화한 로그인 키 이름 | | `isFeeChargingMonitoring` | Boolean | Required | 유료 모니터링 여부 - `true` \| `false` | | `publicIp` | String | Optional | 서버에 할당되어 있는 공인 IP | | `privateIp` | String | Required | 서버에 할당되어 있는 사설 IP | | `serverImageName` | String | Required | 서버 이미지 이름 | | `serverInstanceStatus` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 서버 인스턴스 상태 - `INIT` \| `CREAT` \| `RUN` \| `NSTOP` \| `TERMT` \| `FSTOP` \| `SD_FL` \| `RS_FL` \| `ST_FL` - `INIT`: 서버 INIT 상태 - `CREAT`: 서버 CREATED 상태 - `RUN`: 서버 RUN 상태 - `NSTOP`: 서버 NORMAL STOPPED 상태 - `TERMT`: 서버 TERMINATED 상태 - `FSTOP`: 서버 FAILURE STOPPED 상태 - `SD_FL`: 서버 Shutdown 실패 상태 - `RS_FL`: 서버 Restart 실패 상태 - `ST_FL`: 서버 Start 실패 상태 | | `serverInstanceOperation` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 서버 인스턴스 운영 상태 - `START` \| `SHTDN` \| `RESTA` \| `TERMT` \| `NULL` \| `MIGRA` \| `COPY` \| `SETUP` \| `HREST` \| `HSHTD` \| `CHNG` \| `CREAT` - `START`: Start - `SHTDN`: Shutdown - `RESTA`: Restart - `TERMT`: Terminate - `NULL`: Null - `MIGRA`: 마이그레이션 - `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`인 경우 반납 시 반납이 되지 않음 | | `portForwardingPublicIp` | String | Optional | 포트 포워딩 공인 IP - 포트 포워딩 공인 IP가 설정되어 있는 경우에만 전달 | | `portForwardingExternalPort` | Integer | Optional | 포트 포워딩 공인 외부 포트 값 - 포트 포워딩 설정이 되어 있는 경우에만 전달 | | `portForwardingInternalPort` | Integer | Optional | 포트 포워딩 내부 공인 내부 포트 값 - 포트 포워딩 설정이 되어 있는 경우에만 전달 | | `zone` | Zone | Required | 서버가 위치한 존 | | `region` | Region | Required | 서버가 위치한 리전 | | `baseBlockStorageDiskType` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 기본 블록 스토리지 디스크 유형 - `LOCAL` \| `NET` - `LOCAL`: Local - `NET`: Network | | `baseBlockStorageDiskDetailType` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 기본 블록 스토리지 디스크 상세 유형 - `HDD` \| `SSD` | | `serverInstanceType` | [CommonCode](/docs/common-apidatatype-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 | | `userData` | String | Required | 사용자 데이터 - 사용자가 수행 가능한 스크립트 전달 가능. 해당 스크립트가 전달되면 서버 첫 부팅 시 해당 스크립트가 수행 - 해당 값은 단건 조회 시에만 전달 | | `accessControlGroupList` | List<[AccessControlGroup](/docs/common-apidatatype-accesscontrolgroup)> | Required | ACG 목록 | | `blockDevicePartitionList` | List<[BlockDevicePartition](/docs/common-apidatatype-blockdevicepartition)> | Optional | 블록 디바이스 파티션 목록 - 베어 메탈 서버인 경우 사용자 정의 파티션 정보가 전달 |