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

# setBlockStorageReturnProtection

## 개요<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>blockStorageInstanceNo는 [getBlockStorageInstanceList](/docs/cli-vserver-storage-getblockstorageinstancelist) 액션을 통해 획득 가능 |
| isReturnProtection                   | Yes          | Boolean               |  | - 반납 보호 여부<br>Options : true \| false |
| 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 setBlockStorageReturnProtection --regionCode FKR --blockStorageInstanceNo ***7746 --isReturnProtection true
```

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

```xml
<setBlockStorageReturnProtectionResponse>
  <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>NULL</code>
        <codeName>Block Storage NULL OP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>attached</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>FKR-1</zoneCode>
      <regionCode>FKR</regionCode>
      <isReturnProtection>true</isReturnProtection>
    </blockStorageInstance>
  </blockStorageInstanceList>
</setBlockStorageReturnProtectionResponse>
```
