---
title: "getPublicIpInstanceList"
slug: "compute-server-getpublicipinstancelist"
updated: 2026-09-17T09:57:42Z
published: 2026-09-17T09:57:42Z
canonical: "api.ncloud-docs.com/compute-server-getpublicipinstancelist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getPublicIpInstanceList

## 概要

グローバル IPアドレスインスタンスリストを照会します。

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| isAssociated | No | Boolean |  | - 割り当ての有無 割り当てられたグローバル IPアドレス、割り当てられていないグローバル IPアドレスを照会できる オプション: true \| false |
| publicIpInstanceNoList.N | No | String | 重複不可 | - 照会対象グローバル IPアドレスのインスタンス番号リスト 例) publicIpInstanceNoList.1=937520&publicIpInstanceNoList.2=932956 |
| publicIpList.N | No | List<String> | 最小: 5, 最大: 15 | - 照会対象のグローバル IPアドレス 例) publicIpList.1=106.10.53.67 |
| searchFilterName | No | String |  | - 検索時に適用するフィルタ名 グローバル IPアドレス(publicIp)と割り当てられたサーバ名(associatedServerName)で絞り込み検索 オプション: publicIp \| associatedServerName [大文字小文字を区別しない] searchFilterNameは以下の searchFilterValue値と mappingして使用 例: searchFilterName=publicIp&searchFilterValue=106.10.53.67 例) searchFilterName=associatedServerName&searchFilterValue=s1669aa4e78c |
| searchFilterValue | No | String |  | - 検索時に適用するフィルタの値 上記の searchFilterName値と mappingする値を入力 |
| regionNo | No | String |  | - リージョン番号 グローバル IPアドレスのインスタンスリストを、リージョン(Region)を使用して絞り込みできる regionNoは getRegionListアクションを通じて取得可能 |
| zoneNo | No | String |  | - ZONE番号 グローバル IPアドレスのインスタンスリストを、ゾーン(zone)を使用して絞り込みできる zoneNoは getZoneListアクションを通じて取得可能 フィルタが設定されていない場合は、そのリージョン(Region)のゾーン(zone)に属するグローバル IPアドレスリストが全選択される |
| pageNo | No | Integer | 最小: 0, 最大: 2147483647 | - ページングされた結果のページ番号 結果値は pageNoを利用してページング処理できる |
| pageSize | No | Integer | 最小: 0, 最大: 2147483647 | - ページング時に表示する各ページサイズ 結果値は pageSizeを利用してページング処理できる |
| sortedBy | No | String |  | - ソート対象 グローバル IPアドレスとグローバル IPアドレスインスタンス番号でソート オプション: publicIp (グローバル IPアドレス) \| publicIpInstanceNo (グローバル IPアドレスのインスタンス番号) [大文字小文字を区別しない] デフォルト: publicIpInstanceNo sortedByは、以下の sortingOrderと mappingして使用 例: sortedBy=publicIp&sortingOrder=ascending 例) sortedBy=publicIpInstanceNo&sortingOrder=descending |
| sortingOrder | No | String |  | - ソート順序 上記で設定した SortedByの昇順/降順ソート設定 ascending(昇順) \| descending(降順) [大文字小文字を区別しない] デフォルト: ascending |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [PublicIpInstanceList](/docs/ja/common-apidatatype-publicipinstancelist)

## 例

### リクエスト例

```
GET {SERVER_API_URL}/getPublicIpInstanceList
?searchFilterName=associatedServerName
&searchFilterValue=s1669aa4e78c
```

### レスポンス例

```
<getPublicIpInstanceListResponse>
  <requestId>9e27266d-049c-42c7-a04a-a884290dddb1</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>1081432</publicIpInstanceNo>
      <publicIp>106.10.46.237</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2018-11-23T18:33:45+0900</createDate>
      <publicIpInstanceStatusName>used</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>USED</code>
        <codeName>NET USED state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>NULL</code>
        <codeName>NET NULL OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp>
        <serverInstanceNo>1021003</serverInstanceNo>
        <serverName>s1669aa4e78c</serverName>
        <serverDescription>マイサーバイメージコピーエラーテスト</serverDescription>
        <cpuCount>2</cpuCount>
        <memorySize>4294967296</memorySize>
        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
        <platformType>
          <code>LNX64</code>
          <codeName>Linux 64 Bit</codeName>
        </platformType>
        <loginKeyName>juhoon-kim</loginKeyName>
        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
        <publicIp>106.10.46.237</publicIp>
        <privateIp>10.41.3.81</privateIp>
        <serverImageName>tensorflow-centos-7.3-64</serverImageName>
        <serverInstanceStatus>
          <code>NSTOP</code>
          <codeName>Server normal stopped state</codeName>
        </serverInstanceStatus>
        <serverInstanceOperation>
          <code>NULL</code>
          <codeName>Server NULL OP</codeName>
        </serverInstanceOperation>
        <serverInstanceStatusName>stopped</serverInstanceStatusName>
        <createDate>2018-10-22T16:19:50+0900</createDate>
        <uptime>2018-11-23T17:38:44+0900</uptime>
        <serverImageProductCode>SPSW0LINUX000066</serverImageProductCode>
        <serverProductCode>SPSVRSSD00000003</serverProductCode>
        <isProtectServerTermination>false</isProtectServerTermination>
        <portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
        <zone>
          <zoneNo>3</zoneNo>
          <zoneName>KR-2</zoneName>
          <zoneCode>KR-2</zoneCode>
          <zoneDescription>坪村ゾーン</zoneDescription>
          <regionNo>1</regionNo>
        </zone>
        <region>
          <regionNo>1</regionNo>
          <regionCode>KR</regionCode>
          <regionName>Korea</regionName>
        </region>
        <baseBlockStorageDiskType>
          <code>NET</code>
          <codeName>Network Storage</codeName>
        </baseBlockStorageDiskType>
        <baseBlockStorageDiskDetailType>
          <code>SSD</code>
          <codeName>SSD</codeName>
        </baseBlockStorageDiskDetailType>
        <serverInstanceType>
          <code>STAND</code>
          <codeName>Standard</codeName>
        </serverInstanceType>
        <userData></userData>
        <accessControlGroupList>
          <accessControlGroup>
            <accessControlGroupConfigurationNo>39995</accessControlGroupConfigurationNo>
            <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
            <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
            <isDefault>true</isDefault>
            <createDate>2018-04-09T11:12:54+0900</createDate>
          </accessControlGroup>
        </accessControlGroupList>
        <instanceTagList/>
      </serverInstanceAssociatedWithPublicIp>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>坪村ゾーン</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</getPublicIpInstanceListResponse>
```