---
title: "ServerImage"
slug: "common-vapidatatype-serverimage"
updated: 2026-10-22T10:46:03Z
published: 2026-10-22T10:46:03Z
canonical: "api-gov.ncloud-docs.com/common-vapidatatype-serverimage"
---

> ## 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.

# ServerImage

VPC 환경에서 이용 가능합니다.

서버 이미지입니다.

## 구문

구문은 다음과 같습니다.

```
private String serverImageNo;
private String serverImageName;
private String serverImageDescription;
private CommonCode serverImageType;
private CommonCode serverImageLifeCyclePhase;
private CommonCode hypervisorType;
private CommonCode cpuArchitectureType;
private CommonCode osCategoryType;
private CommonCode osType;
private String serverImageStatusName;
private CommonCode serverImageStatus;
private CommonCode serverImageOperation;
private String serverImageProductCode;
private Date createDate;
private CommonCode shareStatus;
private SharedLoginIdList sharedLoginIdList;
private String platformCategoryCode;
private List<BlockStorageMapping> blockStorageMappingList;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| serverImageNo | String | Required | 서버 이미지 번호 - 서버 이미지를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| serverImageName | String | Required | 서버 이미지 이름 |
| serverImageDescription | String | Optional | 서버 이미지 설명 |
| serverImageType | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 이미지 유형 - 유횻값: NCP \| SELF |
| serverImageLifeCyclePhase | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 이미지 라이프사이클 운영 상태 - `IN_SERVICE` \| `FADE_OUT` \| `RETIRED` 사용 가이드 [Compute > Server > VPC > Server 문제 해결 > 서버이미지(OS) 라이프사이클](https://guide.ncloud-docs.com/docs/ncp-os-lifecycle) 참조 |
| hypervisorType | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 하이퍼바이저 유형 - 유횻값: XEN \| KVM |
| cpuArchitectureType | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | CPU 아키텍처 유형 - 유횻값: X86_64 |
| osCategoryType | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | OS 카테고리 유형 - 유횻값: LINUX \| WINDOWS |
| osType | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | OS 유형 - 유횻값: CENTOS \| UBUNTU \| WINDOWS \| ROCKY \| NAVIX |
| serverImageStatusName | String | Required | 서버 이미지 상태와 서버 이미지 운영 상태를 조합하여 현재의 서버 이미지 상태명 전달 - 유횻값: initialized \| creating \| created \| createFailed \| copying \| terminating \| repairing \| terminated |
| serverImageStatus | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 이미지 상태 - INIT: Initiated - CREAT: Created - CREFL: CreateFailed |
| serverImageOperation | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 서버 이미지 운영 상태 - CREAT: Create - TERMT: Terminate - NULL: No Operation - COPY: Copy |
| serverImageProductCode | String | Required | 서버 이미지 상품 코드 |
| createDate | Date | Required | 서버 이미지 생성 일시 - 형식: YYYY-MM-DDThh:mm:ssZ |
| shareStatus | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 공유 상태 |
| sharedLoginIdList | List | Required | 공유받은 로그인 ID 목록 |
| platformCategoryCode | String | Required | 플랫폼 카테고리 코드 |
| blockStorageMappingList | List<[BlockStorageMapping](/docs/common-vapidatatype-blockstoragemapping)> | Required | 서버 이미지에 할당된 블록 스토리지 목록 - 서버 이미지가 생성이 완료된 이후 조회 가능 |