---
title: "BlockStorageInstance"
slug: "common-vapidatatype-blockstorageinstance"
tags: ["VPC", "Block Storage"]
updated: 2026-07-23T09:04:00Z
published: 2026-07-23T09:04:00Z
canonical: "api.ncloud-docs.com/common-vapidatatype-blockstorageinstance"
---

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

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

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

## 구문

구문은 다음과 같습니다.

```
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String blockStorageName;
private CommonCode blockStorageType;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageDescription;
private CommonCode blockStorageDiskType;
private CommonCode blockStorageDiskDetailType;
private Integer maxIopsThroughput;
private Boolean isEncryptedVolume;
private String zoneCode;
private String regionCode;
private Boolean isReturnProtection;
private CommonCode blockStorageVolumeType;
private CommonCode hypervisorType;
private Long throughput;
private Long iops;
private Long blockStorageSnapshotInstanceNo;
```

## 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `blockStorageInstanceNo` | String | Required | 블록 스토리지 인스턴스 번호 - 블록 스토리지 인스턴스를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| `serverInstanceNo` | String | Optional | 블록 스토리지 인스턴스가 할당된 서버 인스턴스 번호 |
| `blockStorageName` | String | Required | 블록 스토리지 이름 |
| `blockStorageType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 유형 - `BASIC` \| `SVRBS` - `BASIC`: 기본 블록 스토리지 - `SVRBS`: 서버 추가 블록 스토리지 |
| `blockStorageSize` | Long | Required | 블록 스토리지 사이즈(Byte) |
| `deviceName` | String | Optional | 할당된 서버 인스턴스에서의 디바이스 이름 - <예시> /dev/xvda, /dev/xvdb |
| `blockStorageProductCode` | String | Required | 블록 스토리지 상품 코드 - 네이버 클라우드 플랫폼에서 관리하는 블록 스토리지에 해당하는 상품 코드 |
| `blockStorageInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 인스턴스 상태 - `INIT` \| `CREAT` \| `ATTAC` - `INIT`: Initiated - `CREAT`: Created - `ATTAC`: Attached |
| `blockStorageInstanceOperation` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 인스턴스 운영 상태 - `ATTAC` \| `CREAT` \| `NULL` - `ATTAC`: Attach - `CREAT`: Create - `NULL`: No Operation |
| `blockStorageInstanceStatusName` | String | Required | 블록 스토리지 인스턴스 상태명 - 블록 스토리지 인스턴스 상태와 블록 스토리지 인스턴스 운영 상태를 조합하여 현재의 블록 스토리지 인스턴스 상태명 전달 |
| `createDate` | Date | Required | 생성 일시(YYYY-MM-DDThh:mm:ssZ) |
| `blockStorageDescription` | String | Optional | 블록 스토리지 설명 |
| `blockStorageDiskType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 디스크 유형 - `NET` - `NET` : 네트워크 디스크 |
| `blockStorageDiskDetailType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 디스크 상세 유형 - `HDD` \| `SSD` |
| `maxIopsThroughput` | Integer | Optional | 최대 IOPS - SSD의 경우에만 의미 있는 값이 할당됨 |
| `isEncryptedVolume` | Boolean | Required | 볼륨 암호화 여부 - `true` \| `false` |
| `zoneCode` | String | Required | 블록 스토리지가 위치한 존 코드 |
| `regionCode` | String | Required | 블록 스토리지가 위치한 리전 코드 |
| `isReturnProtection` | Boolean | Required | 반납 보호 여부 - `true` \| `false` |
| `blockStorageVolumeType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 블록 스토리지 볼륨 유형 |
| `hypervisorType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 하이퍼바이저 유형 |
| `throughput` | Long | Optional | 블록 스토리지 Throughput |
| `iops` | Long | Optional | 블록 스토리지 IOPS |
| `blockStorageSnapshotInstanceNo` | Long | Optional | 블록 스토리지 스냅샷 인스턴스 번호 |