---
title: "getBlockStorageSnapshotInstanceList"
slug: "cli-vserver-snapshot-getblockstoragesnapshotinstancelist"
tags: ["Block Storage", "Server", "Snapshots"]
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.

# getBlockStorageSnapshotInstanceList

## 개요<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 조회 결과의 첫 번째 리전을 선택  |
| blockStorageSnapshotInstanceNoList.N      | No           | List&lt;String&gt;    |                           | - 블록 스토리지 스냅샷 인스턴스 번호 리스트<br>블록 스토리지 스냅샷 인스턴스 번호로 필터링하여 검색 가능<br>blockStorageSnapshotInstanceNo는 [getBlockStorageSnapshotInstanceList](/docs/cli-vserver-snapshot-getblockstoragesnapshotinstancelist) 액션을 통해 획득 가능<br>ex) --blockStorageSnapshotInstanceNoList 1234 2345  |
| blockStorageSnapshotName                  | No           | String                |                           | - 블록 스토리지 스냅샷 이름<br>블록 스토리지 스냅샷 이름으로 필터링하여 검색 가능  |
| blockStorageSnapshotInstanceStatusCode    | No           | String                |                           | - 블록 스토리지 스냅샷 인스턴스 상태 코드<br>블록 스토리지 스냅샷 인스턴스 상태 코드로 필터링하여 검색 가능<br>Options : INIT \| CREAT   |
| originalBlockStorageInstanceNoList.N      | No           | List&lt;String&gt;    |                           | - 원본 블록 스토리지 인스턴스 번호 리스트<br>원본 블록 스토리지 인스턴스 번호로 필터링하여 검색 가능<br>originalBlockStorageInstanceNo는 [getBlockStorageInstanceList](/docs/cli-vserver-storage-getblockstorageinstancelist) 액션을 통해 획득 가능<br>ex) --originalBlockStorageInstanceNoList 1234 2345 |
| blockStorageSnapshotVolumeSize            | No           | Integer               |                           | - 블록 스토리지 스냅샷 볼륨 사이즈<br>입력한 GB 단위 사이즈 이하의 블록스토리지 스냅샷을 필터링하여 검색 가능 |
| isEncryptedOriginalBlockStorageVolume     | No           | Boolean               |                           | - 원본 블록 스토리지 볼륨 암호화 여부<br>원본 블록 스토리지 볼륨의 암호화 여부로 필터링하여 검색 가능<br>Options : true \| false  |
| hypervisorTypeCodeList                        | No           | List&lt;String&gt;                |                           | - 하이퍼바이저 타입 코드 리스트 <br>하이퍼바이저 타입으로 필터링하여 검색 가능<br> Options : XEN \| RHV <br>ex) --hypervisorTypeCodeList RHV XEN    |
| isBootable     | No           | Boolean               |                           | - 내 서버 이미지 생성 가능 여부 <br> 내 서버 이미지 생성 가능 여부로 필터링하여 검색 가능<br>Options : true \| false  |
| pageNo                                    | No           | Integer               |                           | - 페이징된 결과의 페이지 번호<br>결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능  |
| pageSize                                  | Conditional  | Integer               |                           | - 페이징 시 보여줄 각 페이지 사이즈<br>결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능<br>pageNo 입력시 반드시 입력 필요 |
| sortedBy                                  | No           | String                |                           | - 정렬 대상<br>결과값을 블록 스토리지 스냅샷 이름으로 정렬 가능<br>Options : blockStorageSnapshotName  |
| sortingOrder                              | No           | String                |                           | - 정렬 순서<br>sortedBy 이용시 오름차순/내림차순 정렬을 설정함<br>Options : ASC (오름차순) \| DESC (내림차순)<br>Default : ASC |
| output | No | String | | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul> |

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

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

- BlockStorageSnapshotInstanceList 타입

| BlockStorageSnapshotInstanceList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<BlockStorageSnapshotInstance> blockStorageSnapshotInstanceList = new ArrayList<>(); |

| BlockStorageSnapshotInstance |
| ---------- |
| private String blockStorageSnapshotInstanceNo; |
| private String blockStorageSnapshotName; |
| private Long blockStorageSnapshotVolumeSize; |
| private String originalBlockStorageInstanceNo; |
| private CommonCode blockStorageSnapshotInstanceStatus; |
| private CommonCode blockStorageSnapshotInstanceOperation; |
| private String blockStorageSnapshotInstanceStatusName; |
| private Date createDate; |
| private Boolean isEncryptedOriginalBlockStorageVolume; |
| private String blockStorageSnapshotDescription; |
| private CommonCode snapshotType; |
| private String baseSnapshotInstanceNo; |
| private Integer snapshotChainDepth; |
| private CommonCode hypervisorType; |
| private Boolean isBootable; |
| private CommonCode blockStorageVolumeType;                |


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

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


```
ncloud vserver getBlockStorageSnapshotInstanceList --regionCode FKR --blockStorageSnapshotInstanceNoList ***1951 --blockStorageSnapshotName test-*** --blockStorageSnapshotInstanceStatusCode CREAT --originalBlockStorageInstanceNoList ***7746 --blockStorageSnapshotVolumeSize 50 --isEncryptedOriginalBlockStorageVolume false --hypervisorTypeCodeList XEN --isBootable false
```

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

```xml
<getBlockStorageSnapshotInstanceListResponse>
  <requestId>08cacedf-cfd7-4a8d-a495-89aa0d72f7ca</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageSnapshotInstanceList>
    <blockStorageSnapshotInstance>
      <blockStorageSnapshotInstanceNo>***1951</blockStorageSnapshotInstanceNo>
      <blockStorageSnapshotName>test-***</blockStorageSnapshotName>
      <blockStorageSnapshotVolumeSize>53687091200</blockStorageSnapshotVolumeSize>
      <originalBlockStorageInstanceNo>***7746</originalBlockStorageInstanceNo>
      <blockStorageSnapshotInstanceStatus>
        <code>CREAT</code>
        <codeName>Block storage CREATED state</codeName>
      </blockStorageSnapshotInstanceStatus>
      <blockStorageSnapshotInstanceOperation>
        <code>NULL</code>
        <codeName>Block Storage NULLOP</codeName>
      </blockStorageSnapshotInstanceOperation>
      <blockStorageSnapshotInstanceStatusName>created</blockStorageSnapshotInstanceStatusName>
      <createDate>2020-08-25T10:18:15+0900</createDate>
      <isEncryptedOriginalBlockStorageVolume>false</isEncryptedOriginalBlockStorageVolume>
      <blockStorageSnapshotDescription></blockStorageSnapshotDescription>
      <snapshotType>
        <code>FULL</code>
        <codeName>Full Storage Snapshot</codeName>
      </snapshotType>
      <baseSnapshotInstanceNo/>
      <snapshotChainDepth>0</snapshotChainDepth>
      <isBootable>false</isBootable>
      <hypervisorType>
        <code>XEN</code>
        <codeName>XEN</codeName>
      </hypervisorType>
      <blockStorageVolumeType>
          <code>SSD</code>
          <codeName>SSD</codeName>
      </blockStorageVolumeType>
    </blockStorageSnapshotInstance>
  </blockStorageSnapshotInstanceList>
</getBlockStorageSnapshotInstanceListResponse>
```