---
title: "attachBlockStorageInstance"
slug: "cli-vserver-storage-attachblockstorageinstance"
tags: ["Block Storage", "Server", "Storage"]
updated: 2026-04-23T09:04:52Z
published: 2026-04-23T09:07:28Z
canonical: "cli-fin.ncloud-docs.com/cli-vserver-storage-attachblockstorageinstance"
---

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

# attachBlockStorageInstance

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


블록 스토리지 인스턴스를 서버 인스턴스에 할당합니다.

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

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


| 파라미터명                            | 필수 여부      | 타입                   | 제약 사항                   | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                           | - 리전 코드<br>서버 인스턴스에 할당할 블록 스토리지 인스턴스의 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택  |
| blockStorageInstanceNo             | Yes          | String                |                           | - 블록 스토리지 인스턴스 번호<br>서버 인스턴스에 할당할 블록 스토리지 인스턴스 번호 결정<br>blockStorageInstanceNo는 [getBlockStorageInstanceList](/docs/cli-vserver-storage-getblockstorageinstancelist) 액션을 통해 획득 가능    |
| serverInstanceNo                   | Yes          | String                |                           | - 서버 인스턴스 번호<br>블록 스토리지 인스턴스가 할당될 서버 인스턴스 결정<br>serverInstanceNo는 [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 액션을 통해 획득 가능 |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

## 응답<a name="응답"></a>

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

- BlockStorageInstanceList 타입

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

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


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


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

```
ncloud vserver attachBlockStorageInstance --regionCode FKR --blockStorageInstanceNo ***7746 --serverInstanceNo ***4299
```

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


```xml
<attachBlockStorageInstanceResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>***7746</blockStorageInstanceNo>
      <serverInstanceNo></serverInstanceNo>
      <blockStorageName>test-***</blockStorageName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageSize>53687091200</blockStorageSize>
      <deviceName></deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
      <blockStorageInstanceStatus>
        <code>CREAT</code>
        <codeName>Block storage CREATED state</codeName>
      </blockStorageInstanceStatus>
      <blockStorageInstanceOperation>
        <code>ATTAC</code>
        <codeName>Block Storage  STOP OP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>attaching</blockStorageInstanceStatusName>
      <createDate>2020-08-25T09:18:34+0900</createDate>
      <blockStorageDescription></blockStorageDescription>
      <blockStorageDiskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </blockStorageDiskType>
      <blockStorageDiskDetailType>
        <code>SSD</code>
        <codeName>SSD</codeName>
      </blockStorageDiskDetailType>
      <maxIopsThroughput>4000</maxIopsThroughput>
      <isEncryptedVolume>false</isEncryptedVolume>
      <zoneCode>FKR-1</zoneCode>
      <regionCode>FKR</regionCode>
      <isReturnProtection>false</isReturnProtection>
    </blockStorageInstance>
  </blockStorageInstanceList>
</attachBlockStorageInstanceResponse>
```