---
title: "ServerImage"
slug: "common-vapidatatype-serverimage"
updated: 2026-04-23T08:54:56Z
published: 2026-04-23T09:02:00Z
canonical: "api.ncloud-docs.com/common-vapidatatype-serverimage"
---

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

# ServerImage

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

서버 이미지입니다.

## 구문<a name="구문"></a>

구문은 다음과 같습니다.

```Java
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;
```

## 필드<a name="필드"></a>

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

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