블록 스토리지 스냅샷 인스턴스 목록을 조회합니다.
구문
getBlockStorageSnapshotInstanceList 구문은 다음과 같습니다.
./ncloud vserver getBlockStorageSnapshotInstanceList \
[--originalBlockStorageInstanceNoList <original-block-storage-instance-no-list>] \
[--blockStorageSnapshotInstanceNoList <block-storage-snapshot-instance-no-list>] \
[--blockStorageSnapshotName <block-storage-snapshot-name>] \
[--blockStorageSnapshotVolumeSize <block-storage-snapshot-volume-size>] \
[--isEncryptedOriginalBlockStorageVolume <true|false>] \
[--hypervisorTypeCodeList <hypervisor-type-code-list>] \
[--isBootable <true|false>] \
[--blockStorageSnapshotInstanceStatusCode <INIT|CREAT>] \
[--pageNo <page-no>] \
[--pageSize <page-size>] \
[--sortedBy <blockStorageSnapshotName>] \
[--sortingOrder <ASC|DESC>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
getBlockStorageSnapshotInstanceList 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
getBlockStorageSnapshotInstanceList의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--pageSize |
Integer | Conditional | 페이지당 항목 수
|
선택 옵션
getBlockStorageSnapshotInstanceList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--originalBlockStorageInstanceNoList |
List | Optional | 원본 스토리지 번호 목록
|
--blockStorageSnapshotInstanceNoList |
List | Optional | 스냅샷 인스턴스 번호 목록
|
--blockStorageSnapshotName |
String | Optional | 스냅샷 이름 |
--blockStorageSnapshotVolumeSize |
Integer | Optional | 스냅샷 크기 (GB)
|
--isEncryptedOriginalBlockStorageVolume |
Boolean | Optional | 원본 스토리지 암호화 여부
|
--hypervisorTypeCodeList |
List | Optional | 하이퍼바이저 타입 코드 목록
|
--isBootable |
Boolean | Optional | 서버 이미지 생성 가능 여부
|
--blockStorageSnapshotInstanceStatusCode |
String | Optional | 스냅샷 인스턴스 상태 코드
|
--pageNo |
Integer | Optional | 페이지 번호
|
--sortedBy |
String | Optional | 정렬 기준
|
--sortingOrder |
String | Optional | 정렬 순서
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server 옵션을 참조해 주십시오.
예시
블록 스토리지 스냅샷 인스턴스 목록 조회 요청이 성공하면 각 스냅샷의 식별 및 구성 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver getBlockStorageSnapshotInstanceList \
--originalBlockStorageInstanceNoList 89012345 \
--blockStorageSnapshotInstanceNoList 90123456 \
--blockStorageSnapshotVolumeSize 100 \
--isEncryptedOriginalBlockStorageVolume false \
--hypervisorTypeCodeList XEN \
--isBootable false \
--pageNo 0 \
--pageSize 10 \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getBlockStorageSnapshotInstanceListResponse": {
"totalRows": 1,
"blockStorageSnapshotInstanceList": [
{
"blockStorageSnapshotInstanceNo": "90123456",
"blockStorageSnapshotName": "test-snapshot-01",
"blockStorageSnapshotVolumeSize": 53687091200,
"originalBlockStorageInstanceNo": "89012345",
"blockStorageSnapshotInstanceStatus": {
"code": "CREAT",
"codeName": "블록스토리지 CREATED 상태"
},
"blockStorageSnapshotInstanceOperation": {
"code": "NULL",
"codeName": "블록스토리지 NULL OP"
},
"blockStorageSnapshotInstanceStatusName": "created",
"createDate": "2026-05-20T15:47:35+0900",
"isEncryptedOriginalBlockStorageVolume": false,
"blockStorageSnapshotDescription": "Test snapshot",
"snapshotType": {
"code": "FULL",
"codeName": "Full Storage Snapshot"
},
"snapshotChainDepth": 0,
"isBootable": false,
"hypervisorType": {
"code": "XEN",
"codeName": "XEN"
},
"blockStorageVolumeType": {
"code": "SSD",
"codeName": "SSD"
}
}
],
"requestId": "bb697829-6326-414b-b3c7-fcb8f40d69ba",
"returnCode": "0",
"returnMessage": "success"
}
}