---
title: "getBlockStorageSnapshotInstanceList "
slug: "cli-server-getblockstoragesnapshotinstancelist"
updated: 2026-04-23T08:56:58Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-getblockstoragesnapshotinstancelist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.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>

| 파라미터 명                        | 필수   여부 | 타입         | 제약사항                  | 설명                                                         |
| ---------------------------------- | ----------- | ------------ | ------------------------- | ------------------------------------------------------------ |
| blockStorageSnapshotInstanceNoList | No          | List<String> | 중복 불가                 | 블록 스토리지 스냅샷 인스턴스 번호 리스트에 해당하는 블록 스토리지 스냅샷 조회 |
| originalBlockStorageInstanceNoList | No          | List<String> | 중복 불가                 | 원본 블록 스토리지 인스턴스 번호 리스트에 해당하는 블록 스토리지 스냅샷 조회 |
| regionNo                           | No          | String       |                           | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |
| pageNo                             | No          | String       | Min : 0, Max : 2147483647 | 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호        |
| pageSize                           | No          | String       | Min : 0, Max : 2147483647 | 한 페이지에서 조회할 페이지 사이즈                           |

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

- BlockStorageSnapshotInstanceList 타입

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

| BlockStorageSnapshotInstance                             |
| -------------------------------------------------------- |
| private String blockStorageSnapshotInstanceNo;           |
| private String blockStorageSnapshotName;                 |
| private Long blockStorageSnapshotVolumeSize;             |
| private String originalBlockStorageInstanceNo;           |
| private String originalBlockStorageName;                 |
| private CommonCode blockStorageSnapshotInstanceStatus;   |
| private CommonCode blockStorageSnapshotInstanceOperation;|
| private String blockStorageSnapshotInstanceStatusName;   |
| private Date createDate;                                 |
| private String blockStorageSnapshotInstanceDescription;  |
| private String serverImageProductCode;                   |
| private String osInformation;                            |

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

### 호출 <a name="호출"></a>

```
ncloud server getBlockStorageSnapshotInstanceList --pageNo 1 --pageSize 2
```

### 응답 <a name="응답"></a>
 
```json
{
  "getBlockStorageSnapshotInstanceListResponse": {
    "requestId": "78d786e1-c5f9-4575-9ec8-51a0ea95e69b",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 23,
    "blockStorageSnapshotInstanceList": [
      {
        "blockStorageSnapshotInstanceNo": "396066",
        "blockStorageSnapshotName": "hhhhhfhhhh",
        "blockStorageSnapshotVolumeSize": 21474836480,
        "originalBlockStorageInstanceNo": "393839",
        "originalBlockStorageName": "sjkfja",
        "blockStorageSnapshotInstanceStatus": {
          "code": "CREAT",
          "codeName": "Block Storage CREATED State"
        },
        "blockStorageSnapshotInstanceOperation": {
          "code": "NULL",
          "codeName": "Block Storage NULL OP"
        },
        "blockStorageSnapshotInstanceStatusName": "created",
        "createDate": "2018-02-07T16:24:04+0900",
        "blockStorageSnapshotInstanceDescription": "",
        "serverImageProductCode": "SPSW0LINUX000029",
        "osInformation": "Ubuntu Server 16.04 (64-bit) "
      },
      {
        "blockStorageSnapshotInstanceNo": "396064",
        "blockStorageSnapshotName": "kkkkkk",
        "blockStorageSnapshotVolumeSize": 10737418240,
        "originalBlockStorageInstanceNo": "393838",
        "originalBlockStorageName": "HDSHF",
        "blockStorageSnapshotInstanceStatus": {
          "code": "CREAT",
          "codeName": "Block Storage CREATED State"
        },
        "blockStorageSnapshotInstanceOperation": {
          "code": "NULL",
          "codeName": "Block Storage NULL OP"
        },
        "blockStorageSnapshotInstanceStatusName": "created",
        "createDate": "2018-02-07T16:20:20+0900",
        "blockStorageSnapshotInstanceDescription": "",
        "serverImageProductCode": "SPSW0LINUX000029",
        "osInformation": "Ubuntu Server 16.04 (64-bit) "
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<getBlockStorageSnapshotInstanceListResponse>
  <requestId>78d786e1-c5f9-4575-9ec8-51a0ea95e69b</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>23</totalRows>
  <blockStorageSnapshotInstanceList>
    <blockStorageSnapshotInstanceNo>396066</blockStorageSnapshotInstanceNo>
    <blockStorageSnapshotName>hhhhhfhhhh</blockStorageSnapshotName>
    <blockStorageSnapshotVolumeSize>21474836480</blockStorageSnapshotVolumeSize>
    <originalBlockStorageInstanceNo>393839</originalBlockStorageInstanceNo>
    <originalBlockStorageName>sjkfja</originalBlockStorageName>
    <blockStorageSnapshotInstanceStatus>
      <code>CREAT</code>
      <codeName>Block Storage CREATED State</codeName>
    </blockStorageSnapshotInstanceStatus>
    <blockStorageSnapshotInstanceOperation>
      <code>NULL</code>
      <codeName>Block Storage NULL OP</codeName>
    </blockStorageSnapshotInstanceOperation>
    <blockStorageSnapshotInstanceStatusName>created</blockStorageSnapshotInstanceStatusName>
    <createDate>2018-02-07T16:24:04+0900</createDate>
    <blockStorageSnapshotInstanceDescription></blockStorageSnapshotInstanceDescription>
    <serverImageProductCode>SPSW0LINUX000029</serverImageProductCode>
    <osInformation>Ubuntu Server 16.04 (64-bit) </osInformation>
  </blockStorageSnapshotInstanceList>
  <blockStorageSnapshotInstanceList>
    <blockStorageSnapshotInstanceNo>396064</blockStorageSnapshotInstanceNo>
    <blockStorageSnapshotName>kkkkkk</blockStorageSnapshotName>
    <blockStorageSnapshotVolumeSize>10737418240</blockStorageSnapshotVolumeSize>
    <originalBlockStorageInstanceNo>393838</originalBlockStorageInstanceNo>
    <originalBlockStorageName>HDSHF</originalBlockStorageName>
    <blockStorageSnapshotInstanceStatus>
      <code>CREAT</code>
      <codeName>Block Storage CREATED State</codeName>
    </blockStorageSnapshotInstanceStatus>
    <blockStorageSnapshotInstanceOperation>
      <code>NULL</code>
      <codeName>Block Storage NULL OP</codeName>
    </blockStorageSnapshotInstanceOperation>
    <blockStorageSnapshotInstanceStatusName>created</blockStorageSnapshotInstanceStatusName>
    <createDate>2018-02-07T16:20:20+0900</createDate>
    <blockStorageSnapshotInstanceDescription></blockStorageSnapshotInstanceDescription>
    <serverImageProductCode>SPSW0LINUX000029</serverImageProductCode>
    <osInformation>Ubuntu Server 16.04 (64-bit) </osInformation>
  </blockStorageSnapshotInstanceList>
</getBlockStorageSnapshotInstanceListResponse>
```