---
title: "BlockStorageInstance"
slug: "common-apidatatype-blockstorageinstance"
updated: 2026-04-23T08:55:24Z
published: 2026-04-23T09:02:10Z
---

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

# BlockStorageInstance

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

블록 스토리지 인스턴스입니다.

## 구문 <a name="구문"></a>
구문은 다음과 같습니다.

```Java
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String serverName;
private CommonCode blockStorageType;
private String blockStorageName;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageInstanceDescription;
private CommonCode diskTypeCode;
private CommonCode diskType;
private CommonCode diskDetailType;
private Integer maxIopsThroughput;
private Region region;
private Zone zone;
```

## 필드 <a name="필드"></a>
필드에 대한 설명은 다음과 같습니다.

| 필드                      | 타입 | 필수 여부       | 설명                                                                                                                                                                                                                                                                 |
| ------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `blockStorageInstanceNo`          | String      | Required     | 블록 스토리지를 식별하기 위한 네이버 클라우드 플랫폼의 식별자                                                                                                                                                                            |
| `serverInstanceNo`                | String      | Required     | 블록 스토리지가 Attached 되어 있는 서버 인스턴스(VM) 번호                                                                                                                                                                                                                  |
| `serverName`                      | String      | Required     | Attached 되어 있는 서버 이름                                                                                                                                                                                                                                           |
| `blockStorageType`                | [CommonCode](/docs/common-apidatatype-commoncode)      | Required | 블록 스토리지 유형 <ul><li>`BASIC` \| `SVRBS` \| `SNAP` \| `NSI` <ul><li>`BASIC`: 기본 블록 스토리지 </li><li>`SVRBS`: 추가 블록 스토리지</li><li>`SNAP`: 스냅샷</li><li>`NSI`: 회원 서버 이미지</li></ul></li></ul> |
| `blockStorageName`                | String      | Required     | 블록 스토리지 이름<ul><li>예시: /dev/xvda, /dev/xvdb</li></ul>                                                                                                                                                                                                                                |
| `blockStorageSize`                | String      | Required     | 블록 스토리지 크기(Gbyte)                                                                                                                                                                                                                                             |
| `blockStorageProductCode`         | String      | Required     | 블록 스토리지 상품 코드<ul><li> 네이버 클라우드 플랫폼에서 관리하는 블록 스토리지에 해당하는 상품 코드</li></ul>                                                                                                                                                                                              |
| `blockStorageInstanceStatus`      | [CommonCode](/docs/common-apidatatype-commoncode)     | Required | 블록 스토리지 인스턴스 상태<ul><li>`INIT` \| `CREAT` \| `ATTAC` \| `TERMT` \| `NAVAI` \| `DT_FL`<ul><li>`INIT`: initiated</li><li>`CREAT`: Created</li><li>`ATTAC`: Attached</li><li>`TERMT`: Terminated</li><li>`NAVAI`: Not available</li><li>`DT_FL`: Detach failed</li></ul></li></ul>                |
| `blockStorageInstanceOperation`   | [CommonCode](/docs/common-apidatatype-commoncode)       | Optional | 블록  스토리지 인스턴스 운영 상태<ul><li>`ATTAC` \| `DETAC` \| `TERMT` \| `NULL` \| `COPY` \| `CREAT`<ul><li>`ATTAC`: Stop </li><li> `DETAC`: Restart</li><li>`TERMT`: Terminate</li><li>`NULL`: No operation </li><li> `COPY`: Copy </li><li>`CREAT`: Create</li></ul></li></ul>
| `blockStorageInstanceStatusName`  | String      | Required     | 블록 스토리지 인스턴스 상태명<ul><li>블록 스토리지 인스턴스 상태와 블록 스토리지 인스턴스 운영 상태를 조합하여 현재의 블록 스토리지 인스턴스 상태명 전달</li><li>`initialized` \| `creating` \| `detached` \| `copying` \| `terminating` \| `repairing` \| `terminated` \| `detachFailed`</li></ul>|
| `createDate`                      | Date      | Required       | 블록 스토리지 생성  일시<br/>                                                                                                                                                                                                                    |
| `serverInstanceStatus`            | [CommonCode](/docs/common-apidatatype-commoncode)      | Required | 서버 인스턴스 상태                                                                                                                                                                                                                                                         |
| `blockStorageInstanceDescription` | String      | Required     | 블록 스토리지 인스턴스 설명                                                                                                                                                                                                                                                 |
| `diskType`                        | [CommonCode](/docs/common-apidatatype-commoncode)      | Required | 디스크 유형<ul><li>`NET`  \| `LOCAL`<ul><li>`NET`: 네트워크 디스크 </li><li>`LOCAL`: 로컬 디스크 </li></ul>                                                                                                                                                                                                        |
| `diskDetailType`                  | [CommonCode](/docs/common-apidatatype-commoncode)      | Required | 디스크 상세 유형 <ul><li>`HDD` \| `SSD`</li></ul>  |
| `maxIopsThroughput`               | Integer       | Optional    | 최대 IOPS<ul><li>HDD의 경우에는 값이 할당되지 않음</li></ul>                                                                                                                                                                                                                        |
| `region`                          | Region      | Required     | 리전                                                                                                                                                                                                                                                                     |
| `zone`                            | Zone      | Required       | 존                                                                                                                                                                                                                                                       |