getPublicIpInstanceList

Article summary

Did you find this summary helpful?

Thank you for your feedback

Overview

Searching a public IP instance list

Description

Search a public IP instance list.

Request Parameters

Parameter Name	Requiredness	Type	Limitation	Description
isAssociated	No	Boolean		You can search either associated or non-associated public IP.
publicIpInstanceNoList	No	String	No redundancy	Public IP instance No. list to search
publicIpList	No	String	Min : 5, Max : 15	Public IP list to search
searchFilterName	No	String		Public IP (publicIp) \| Associated server name (associatedServerName)
searchFilterValue	No	String		Value to search
regionNo	No	String		You can reach a state in which input is possible by calling getRegionList.
zoneNo	No	String		You can get Public Ip instnace if you configure filters of Zone No. All Pulbic Ip Instance will be selected if you do not configure filters.
pageNo	No	Integer	Min : 0, Max : 2147483647	Page No. for each page size when there are multiple cases
pageSize	No	Integer	Min : 0, Max : 2147483647	Page size for one search page
sortedBy	No	String		You can set sorting columns for list results. Public IP (publicIp) \| Public IP instance No. (publicIpInstanceNo) [Do not distinguish between uppercase and lowercase.] Default : Public IP instance No. (publicIpInstanceNo)
sortingOrder	No	String		You can set ordering for list results in ascending or descending order. ascending \| descending [Do not distinguish between uppercase and lowercase.] Default : ascending

Response Data Type

PublicIpInstanceList type

PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();

PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;
private ServerInstance serverInstanceAssociatedWithPublicIp;
private Region region;
private Zone zone;

Examples

Request

ncloud server getPublicIpInstanceList --publicIpList 192.168.60.117 192.168.60.115

Response

{
  "getPublicIpInstanceListResponse": {
    "requestId": "dbf5e5bc-97c0-4164-9ee5-1128e50f5617",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "publicIpInstanceList": [
      {
        "publicIpInstanceNo": "396562",
        "publicIp": "192.168.60.115",
        "publicIpDescription": "",
        "createDate": "2018-02-13T13:46:23+0900",
        "publicIpInstanceStatusName": "created",
        "publicIpInstanceStatus": {
          "code": "CREAT",
          "codeName": "NET CREAT State"
        },
        "publicIpInstanceOperation": {
          "code": "NULL",
          "codeName": "NET NULL OP"
        },
        "publicIpKindType": {
          "code": "GEN",
          "codeName": "General"
        },
        "serverInstanceAssociatedWithPublicIp": {},
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo" : "1"
        }
      },
      {
        "publicIpInstanceNo": "397030",
        "publicIp": "192.168.60.117",
        "publicIpDescription": "test",
        "createDate": "2018-02-20T21:32:24+0900",
        "publicIpInstanceStatusName": "created",
        "publicIpInstanceStatus": {
          "code": "CREAT",
          "codeName": "NET CREAT State"
        },
        "publicIpInstanceOperation": {
          "code": "NULL",
          "codeName": "NET NULL OP"
        },
        "publicIpKindType": {
          "code": "GEN",
          "codeName": "General"
        },
        "serverInstanceAssociatedWithPublicIp": {},
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo" : "1"
        }
      }
    ]
  }
}

<?xml version="1.0" encoding="UTF-8" ?>
<getPublicIpInstanceListResponse>
  <requestId>dbf5e5bc-97c0-4164-9ee5-1128e50f5617</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <publicIpInstanceList>
    <publicIpInstanceNo>396562</publicIpInstanceNo>
    <publicIp>192.168.60.115</publicIp>
    <publicIpDescription></publicIpDescription>
    <createDate>2018-02-13T13:46:23+0900</createDate>
    <publicIpInstanceStatusName>created</publicIpInstanceStatusName>
    <publicIpInstanceStatus>
      <code>CREAT</code>
      <codeName>NET CREAT State</codeName>
    </publicIpInstanceStatus>
    <publicIpInstanceOperation>
      <code>NULL</code>
      <codeName>NET NULL OP</codeName>
    </publicIpInstanceOperation>
    <publicIpKindType>
      <code>GEN</code>
      <codeName>General</codeName>
    </publicIpKindType>
    <serverInstanceAssociatedWithPublicIp/>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </publicIpInstanceList>
  <publicIpInstanceList>
    <publicIpInstanceNo>397030</publicIpInstanceNo>
    <publicIp>192.168.60.117</publicIp>
    <publicIpDescription>test</publicIpDescription>
    <createDate>2018-02-20T21:32:24+0900</createDate>
    <publicIpInstanceStatusName>created</publicIpInstanceStatusName>
    <publicIpInstanceStatus>
      <code>CREAT</code>
      <codeName>NET CREAT State</codeName>
    </publicIpInstanceStatus>
    <publicIpInstanceOperation>
      <code>NULL</code>
      <codeName>NET NULL OP</codeName>
    </publicIpInstanceOperation>
    <publicIpKindType>
      <code>GEN</code>
      <codeName>General</codeName>
    </publicIpKindType>
    <serverInstanceAssociatedWithPublicIp/>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </publicIpInstanceList>
</getPublicIpInstanceListResponse>

Was this article helpful?

What's Next

getPublicIpTargetServerInstanceList

Table of contents

Overview
Description
Request Parameters
Response Data Type
Examples