---
title: "BlockStorageInstance"
slug: "common-apidatatype-blockstorageinstance"
updated: 2026-10-22T10:46:30Z
published: 2026-10-22T10:46:30Z
canonical: "api-gov.ncloud-docs.com/common-apidatatype-blockstorageinstance"
---

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

# BlockStorageInstance

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

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

## 구문

구문은 다음과 같습니다.

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

## 필드

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

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