---
title: "changeBlockStorageInstance"
slug: "cli-vserver-storage-changeblockstorageinstance"
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.

# changeBlockStorageInstance

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

## 개요

블록 스토리지 속성을 변경합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 볼륨 사이즈를 변경할 블록 스토리지 인스턴스의 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| blockStorageInstanceNo | Yes | String |  | - 볼륨 사이즈를 변경할 블록 스토리지 인스턴스 번호 blockStorageInstanceNo는 [getBlockStorageInstanceList](/docs/cli-vserver-storage-getblockstorageinstancelist) 액션을 통해 획득 가능 |
| blockStorageSize | Yes | Integer | - XEN 블록 스토리지 Min : 10, Max : 2000 GB - KVM 블록 스토리지 Min : 10, Max : 16380 GB 10GB 단위 입력 | - 변경할 블록 스토리지 사이즈 볼륨 사이즈는 확대만 가능하며, 축소 기능은 제공하지 않음 추가된 볼륨 사이즈는 서버에서 파일 스토리지 크기를 확장해야 적용 가능 사용자 가이드 [Compute > Server > Storage](https://guide-fin.ncloud-docs.com/docs/server-storage-vpc#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80%ED%81%AC%EA%B8%B0%ED%99%95%EC%9E%A5) 참조 |
| 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 changeBlockStorageInstance --regionCode KR --blockStorageInstanceNo ***7746 --blockStorageSize 60
```

### 응답 예시

```
<changeBlockStorageInstanceResponse>
  <requestId>17b3bcf6-8e52-47e5-b822-1352ec765a97</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>64424509440</blockStorageSize>
      <deviceName>/dev/xvdb</deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
      <blockStorageInstanceStatus>
        <code>ATTAC</code>
        <codeName>Block storage ATTACHED state</codeName>
      </blockStorageInstanceStatus>
      <blockStorageInstanceOperation>
        <code>CHNG</code>
        <codeName>Block Storage Resize OP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>changingSpec</blockStorageInstanceStatusName>
      <createDate>2020-08-25T09:38:49+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>KR-1</zoneCode>
      <regionCode>KR</regionCode>
    </blockStorageInstance>
  </blockStorageInstanceList>
</changeBlockStorageInstanceResponse>
```