---
title: "getPublicIpInstanceList"
slug: "cli-server-getpublicipinstancelist"
tags: ["Block Storage", "Server"]
updated: 2026-04-23T08:56:58Z
published: 2026-04-23T08:58:53Z
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

## 개요<a name="개요"></a>

공인 IP 인스턴스 리스트 조회

## 설명 <a name="설명"></a>

공인 IP 인스턴스 리스트를 조회합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터 명            | 필수   여부 | 타입         | 제약사항                  | 설명                                                         |
| ---------------------- | ----------- | ------------ | ------------------------- | ------------------------------------------------------------ |
| isAssociated           | No          | Boolean      |                           | 할당된 공인IP, 할당되지 않은 공인IP 조회 가능    |
| publicIpInstanceNoList | No          | List<String> | 중복 불가                 | 조회할 공인 IP 인스턴스 번호 리스트                          |
| publicIpList           | No          | String       | Min : 5, Max : 15         | 조회할 공인 IP 리스트                                        |
| searchFilterName       | No          | String       |                           | 공인 아이피(publicIp)   \| 할당된 서버 명(associatedServerName) |
| searchFilterValue      | No          | String       |                           | 조회할 값                                                    |
| regionNo               | No          | String       |                           | 입력 가능한 상태는 getRegionList 액션을 통해서 획득 가능 |
| zoneNo                 | No          | String       |                           | 공인 IP 인스턴스   리스트를 ZONE을 이용해 필터링 가능<br>필터를 설정하지 않으면 해당 리전의   ZONE에 속한 공인 IP 리스트가   모두 선택됨 |
| pageNo                 | No          | Integer      | Min : 0, Max : 2147483647 | 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호        |
| pageSize               | No          | Integer      | Min : 0, Max : 2147483647 | 한 페이지에서 조회할 페이지 사이즈                          |
| sortedBy               | No          | String       |                           | 목록 결과에 대한 정렬 컬럼을 정할 수 있음<br>공인 IP(publicIp) \| 공인 IP 인스턴스 번호(publicIpInstanceNo)   [대소문자 구분 없음]<br>Default : 공인 IP 인스턴스   번호(publicIpInstanceNo) |
| sortingOrder           | No          | String       |                           | 오름차순 내림차순에 대한 목록 결과에 ordering을   정할 수 있음<br>오름차순(ascending) \| 내림차순(descending) [대소문자 구분   없음]<br>Default : 오름차순(ascending) |

## 응답 데이터 타입 <a name="응답데이터타입"></a>

- PublicIpInstanceList 타입

| PublicIpInstanceList extends CommonResponse |
| ------------------------------------------- |
| private Integer totalRows;
| private List<PublicIpInstance> publicIpInstanceList = new ArrayList<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;                                           |

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

```
ncloud server getPublicIpInstanceList --publicIpList 192.168.60.117 192.168.60.115
```

### 응답 <a name="응답"></a>
 
```json
{
  "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
<?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>
```