getBlockStorageSnapshotInstanceList

Prev Next

Available in VPC

Overview

Get the list of block storage snapshot instances.

Request

Request parameters

Parameter name Required Type Restrictions Description
regionCode No String Region code
  • Determine the Region in which the block storage snapshot instance list will be queried.
  • regionCode can be obtained through the getRegionList action.
  • Default: Select the first Region of the getRegionList query result.
blockStorageSnapshotInstanceNoList.N No List<String> Block storage snapshot instance number list
  • Search by filtering with block storage snapshot instance number.
  • blockStorageSnapshotInstanceNo can be obtained through the getBlockStorageSnapshotInstanceList action.
  • Example) --blockStorageSnapshotInstanceNoList 1234 2345
blockStorageSnapshotName No String Block storage snapshot name
  • Search by filtering with the block storage snapshot name.
blockStorageSnapshotInstanceStatusCode No String Block storage snapshot instance status code
  • Search by filtering with the block storage snapshot instance status code.
  • Options: INIT | CREAT
originalBlockStorageInstanceNoList.N No List<String> Source block storage snapshot instance number list
  • Search by filtering with source block storage snapshot instance number.
  • originalBlockStorageInstanceNo can be obtained through the getBlockStorageInstanceList action.
  • Example) --originalBlockStorageInstanceNoList 1234 2345
blockStorageSnapshotVolumeSize No Integer Block storage snapshot volume size
  • Search by filtering with block storage snapshots that are equal to or less than the GB size entered.
isEncryptedOriginalBlockStorageVolume No Boolean Source block storage volume encryption status
  • Search by filtering with encryption status of the source block storage volume.
  • Options: true | false
hypervisorTypeCodeList No List<String> Hypervisor type code list
  • Search by filtering with hypervisor type.
  • Options: XEN | KVM
  • Example) --hypervisorTypeCodeList KVM XEN
isBootable No Boolean My server image creation availability
  • Search by filtering with My server image creation availability.
  • Options: true | false
pageNo No Integer Page numbers in paged results
  • The results can be paged using pageNo and pageSize.
pageSize Conditional Integer Size of each page to display when paging
  • The results can be paged using pageNo and pageSize.
  • Required when entering pageNo
sortedBy No String Sort target
  • The results can be sorted by block storage snapshot name.
  • Options: blockStorageSnapshotName
sortingOrder No String Sort order
  • Set ascending/descending sorting when using sortedBy.
  • Options: ASC (ascending) | DESC (descending)
  • Default: ASC
responseFormatType No String Response result's format type
  • Options: xml | json
  • Default: xml

Response

Response data type

  • BlockStorageSnapshotInstanceList type
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;

Examples

Request example

ncloud vserver getBlockStorageSnapshotInstanceList --regionCode KR --blockStorageSnapshotInstanceNoList ***1951 --blockStorageSnapshotName test-*** --blockStorageSnapshotInstanceStatusCode CREAT --originalBlockStorageInstanceNoList ***7746 --blockStorageSnapshotVolumeSize 50 --isEncryptedOriginalBlockStorageVolume false --hypervisorTypeCodeList KVM --isBootable true

Response example

<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>true</isBootable>
      <hypervisorType>
        <code>KVM</code>
        <codeName>KVM</codeName>
      </hypervisorType>
      <blockStorageVolumeType>
        <code>CB1</code>
        <codeName>Common BlockStorage 1</codeName>
      </blockStorageVolumeType>
    </blockStorageSnapshotInstance>
  </blockStorageSnapshotInstanceList>
</getBlockStorageSnapshotInstanceListResponse>