---
title: "createBlockStorageInstance "
slug: "cli-server-createblockstorageinstance"
updated: 2026-04-23T08:56:58Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-createblockstorageinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createBlockStorageInstance

## 개요<a name="개요"></a>

블록 스토리지 인스턴스 생성

## 설명 <a name="설명"></a>

블록 스토리지 인스턴스를 생성합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터   명           | 필수   여부 | 타입   | 제약사항             | 설명                                                         |
| ----------------------- | ----------- | ------ | -------------------- | ------------------------------------------------------------ |
| blockStorageName        | No          | String | Min : 3, Max : 30    | - 생성할 블록스토리지 명<br>      default : Ncloud가 알아서 배정 |
| blockStorageSize        | Yes         | String | Min : 10, Max : 2000 | 생성할 블록 스토리지 사이즈를 입력함   <br>      GB 단위로 입력이 가능하고, 최대   2000GB 까지만 입력 가능 |
| blockStorageDescription | No          | String | Min : 10, Max : 1000 | 블록 스토리지 설명                                           |
| serverInstanceNo        | Yes         | String |                      | - attach할 서버 인스턴스 번호<br>      필수 항목이며, getServerInstanceList 액션을 통해 서버 인스턴스 번호 획득 가능 |
| diskDetailTypeCode      | No          | String | Min : 1, Max : 5     | - 디스크 상세 유형 코드(HDD/SSD)<br>      하드 디스크(HDD)와   SSD(SSD) 중 선택 가능<br>      default : HDD |

## 응답 데이터 타입 <a name="응답데이터타입"></a>
- BlockStorageInstanceList 타입

| BlockStorageInstanceList extends CommonResponse |
| ---------------------------------------- |
| private Integer totalRows;
| private List<BlockStorageInstance> blockStorageInstanceList = new ArrayList<BlockStorageInstance>(); |

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

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

```
ncloud server createBlockStorageInstance --blockStorageSize 100 --serverInstanceNo 397255 --diskDetailTypeCode SSD
```

### 응답 <a name="응답"></a>
 
```json
{
  "createBlockStorageInstanceResponse": {
    "requestId": "4b829bad-fba8-411d-9a21-0264a5854014",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "397260",
        "serverInstanceNo": "397255",
        "serverName": "ncloud-mktest",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "Server BS"
        },
        "blockStorageName": "bst-a3e9783e47c71f3",
        "blockStorageSize": 107374182400,
        "deviceName": "",
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "INIT",
          "codeName": "Block Storage INIT State"
        },
        "blockStorageInstanceOperation": {
          "code": "NULL",
          "codeName": "Block Storage NULL OP"
        },
        "blockStorageInstanceStatusName": "initialized",
        "createDate": "2018-02-23T14:00:55+0900",
        "blockStorageInstanceDescription": "",
        "diskType": {
          "code": "NET",
          "codeName": "Network Storage"
        },
        "diskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo": "1"
        }
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<createBlockStorageInstanceResponse>
  <requestId>4b829bad-fba8-411d-9a21-0264a5854014</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstanceNo>397260</blockStorageInstanceNo>
    <serverInstanceNo>397255</serverInstanceNo>
    <serverName>ncloud-mktest</serverName>
    <blockStorageType>
      <code>SVRBS</code>
      <codeName>Server BS</codeName>
    </blockStorageType>
    <blockStorageName>bst-a3e9783e47c71f3</blockStorageName>
    <blockStorageSize>107374182400</blockStorageSize>
    <deviceName></deviceName>
    <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
    <blockStorageInstanceStatus>
      <code>INIT</code>
      <codeName>Block Storage INIT State</codeName>
    </blockStorageInstanceStatus>
    <blockStorageInstanceOperation>
      <code>NULL</code>
      <codeName>Block Storage NULL OP</codeName>
    </blockStorageInstanceOperation>
    <blockStorageInstanceStatusName>initialized</blockStorageInstanceStatusName>
    <createDate>2018-02-23T14:00:55+0900</createDate>
    <blockStorageInstanceDescription></blockStorageInstanceDescription>
    <diskType>
      <code>NET</code>
      <codeName>Network Storage</codeName>
    </diskType>
    <diskDetailType>
      <code>SSD</code>
      <codeName>SSD</codeName>
    </diskDetailType>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>
```