---
title: "getPublicIpInstanceList"
slug: "cli-server-getpublicipinstancelist"
tags: ["Server"]
updated: 2026-09-17T10:08:35Z
published: 2026-09-17T10:08:35Z
canonical: "cli.ncloud-docs.com/cli-server-getpublicipinstancelist"
---

> ## 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.

# getPublicIpInstanceList

## 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<publicipinstance data-tomark-pass=""> publicIpInstanceList = new ArrayList<publicipinstance data-tomark-pass="">();</publicipinstance></publicipinstance> |

| 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>
```