getMemberServerImageInstanceList

Prev Next

Can be used in a VPC environment.

Overview

Query the list of member server image instances.

Caution

My server images on KVM servers are not supported.

Request

Request parameter

Parameter Name Required Status Type Restrictions Description
regionCode No String Region Code
You can decide the region where the list of member server image instances will be queried.
The regionCode can be obtained through the getRegionList action.
Default: Select the first region of the getRegionList query results.
memberServerImageInstanceNoList.N No List<String> List of the member server image instance numbers
You can search by filtering with the member server image instance number.
The memberServerImageInstanceNo can be obtained through the getMemberServerImageInstanceList action.
ex) --memberServerImageInstanceNoList 1234 2345
memberServerImageName No String Member server image name
You can search by filtering with a member server image name.
memberServerImageInstanceStatusCode No String The status code of member server image instance
You can search by filtering with the status code of member server image instance.
Options : INIT | CREAT
platformTypeCodeList.N No List<String> List of platform type codes
You can search by filtering with a platform type.
Options : LNX32 | LNX64 | WND32 | WND64 | UBD64 | UBS64
ex) --platformTypeCodeList LNX32 LNX64
pageNo No Integer The page number of the paged results
The results can shown as pages using pageNo and pageSize.
pageSize Conditional Integer The size of each page to be displayed at the time of paging
The results can shown as pages using pageNo and pageSize.
Enter it when entering pageNo.
sortedBy No String Sorting target
The result can be sorted with a member server image name.
Options : memberServerImageName
sortingOrder No String Sorting order
When using sortedBy, set sorting in ascending /descending order.
Options: ASC (ascending order) | DESC (descending order)
Default : ASC
responseFormatType No String Format type for the response result
Options : xml | json
Default : xml

Response

Response data type

  • MemberServerImageInstanceList type
MemberServerImageInstanceList extends CommonResponse
private Integer totalRows;
private List<MemberServerImageInstance> memberServerImageInstanceList = new ArrayList<>();
MemberServerImageInstance
private String memberServerImageInstanceNo;
private String memberServerImageName;
private String memberServerImageDescription;
private String originalServerInstanceNo;
private String originalServerImageProductCode;
private CommonCode memberServerImageInstanceStatus;
private CommonCode memberServerImageInstanceOperation;
private String memberServerImageInstanceStatusName;
private Date createDate;
private Integer memberServerImageBlockStorageTotalRows;
private Long memberServerImageBlockStorageTotalSize;
private CommonCode shareStatus;
private SharedLoginIdList sharedLoginIdList;

Example

Request example

ncloud vserver getMemberServerImageInstanceList --regionCode KR --memberServerImageInstanceNoList ***5847 --memberServerImageName test-*** --memberServerImageInstanceStatusCode CREAT --platformTypeCodeList LNX64

Response example

<getMemberServerImageInstanceListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <memberServerImageInstanceList>
    <memberServerImageInstance>
      <memberServerImageInstanceNo>***5847</memberServerImageInstanceNo>
      <memberServerImageName>test-***</memberServerImageName>
      <memberServerImageDescription></memberServerImageDescription>
      <originalServerInstanceNo>***4299</originalServerInstanceNo>
      <originalServerImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</originalServerImageProductCode>
      <memberServerImageInstanceStatus>
        <code>CREAT</code>
        <codeName>NSI CREATED state</codeName>
      </memberServerImageInstanceStatus>
      <memberServerImageInstanceOperation>
        <code>NULL</code>
        <codeName>NSI NULLOP</codeName>
      </memberServerImageInstanceOperation>
      <memberServerImageInstanceStatusName>created</memberServerImageInstanceStatusName>
      <createDate>2020-08-24T10:34:27+0900</createDate>
      <shareStatus>
        <code>NULL</code>
        <codeName>NSI Share NULL State</codeName>
      </shareStatus>
      <sharedLoginIdList/>
    </memberServerImageInstance>
  </memberServerImageInstanceList>
</getMemberServerImageInstanceListResponse>