---
title: "detachBlockStorageInstances"
slug: "cli-vserver-storage-detachblockstorageinstances"
tags: ["Block Storage", "Server", "Storage"]
updated: 2026-04-23T09:04:52Z
published: 2026-04-23T09:07:28Z
---

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

# detachBlockStorageInstances

## 개요

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

## 요청

### 요청 파라미터

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

## 응답

### 응답 데이터 타입

- BlockStorageInstanceList 타입

| BlockStorageInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<blockstorageinstance data-tomark-pass=""> blockStorageInstanceList = new ArrayList&lt;&gt;();</blockstorageinstance> |

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

## 예시

### 요청 예시

```
ncloud vserver detachBlockStorageInstances --regionCode FKR --blockStorageInstanceNoList ***7746
```

### 응답 예시

```
<detachBlockStorageInstancesResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>***7746</blockStorageInstanceNo>
      <serverInstanceNo>***4299</serverInstanceNo>
      <blockStorageName>test-***</blockStorageName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageSize>53687091200</blockStorageSize>
      <deviceName>/dev/xvdb</deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
      <blockStorageInstanceStatus>
        <code>ATTAC</code>
        <codeName>Block storage ATTACHED state</codeName>
      </blockStorageInstanceStatus>
      <blockStorageInstanceOperation>
        <code>DETAC</code>
        <codeName>Block Storage RESTART OP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>detaching</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>
</detachBlockStorageInstancesResponse>
```