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

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

# replaceServerInstanceAssociatedWithPublicIp

## Overview

Replace the public IP to the specified server

## Description

Assigns the public IP assigned to the server to another server.

## Request Parameters

| Parameter Name | Requiredness | Type | Limitation | Description |
| --- | --- | --- | --- | --- |
| publicIpInstanceNo | Yes | String |  | Public IP instance number assigned to an existing server |
| serverInstanceNo | Yes | String |  | Server instance number to replace You can get it through the getPublicIpTargetServerInstanceList action. Public IP can be replaced only between servers in the same zone. (Can not replace public IP assigned to KR-1 server with server of KR-2) |
| isErrorThrowing | No | Boolean |  | Default : true A server that is already assigning IP does not generate an error that occurs when attempting replaceServerInstanceAssociatedWithPublicIp action. |

## 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 replaceServerInstanceAssociatedWithPublicIp --serverInstanceNo 691083 --publicIpInstanceNo 662308
```

### Response

```
{
  "replaceServerInstanceAssociatedWithPublicIpResponse": {
    "requestId": "82d58738-1aae-4677-982f-b194b24a683b",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "publicIpInstanceList": [
      {
        "publicIpInstanceNo": "662308",
        "publicIp": "49.236.160.36",
        "publicIpDescription": "testfsdf",
        "createDate": "2018-05-23T11:04:38+0900",
        "publicIpInstanceStatusName": "changing",
        "publicIpInstanceStatus": {
          "code": "USED",
          "codeName": "NET USED state"
        },
        "publicIpInstanceOperation": {
          "code": "CHANG",
          "codeName": "NET CHANGE OP"
        },
        "publicIpKindType": {
          "code": "GEN",
          "codeName": "General"
        },
        "serverInstanceAssociatedWithPublicIp": {
          "serverInstanceNo": "691083",
          "serverName": "import-key",
          "serverDescription": "",
          "cpuCount": 2,
          "memorySize": 4294967296,
          "baseBlockStorageSize": 53687091200,
          "platformType": {
            "code": "LNX64",
            "codeName": "Linux 64 Bit"
          },
          "loginKeyName": "import-key",
          "isFeeChargingMonitoring": false,
          "publicIp": "49.236.160.36",
          "privateIp": "10.39.3.136",
          "serverImageName": "centos-6.6-64",
          "serverInstanceStatus": {
            "code": "RUN",
            "codeName": "Server run state"
          },
          "serverInstanceOperation": {
            "code": "NULL",
            "codeName": "Server NULL OP"
          },
          "serverInstanceStatusName": "running",
          "createDate": "2018-06-15T11:15:10+0900",
          "uptime": "2018-06-15T11:15:10+0900",
          "serverImageProductCode": "SPSW0LINUX000044",
          "serverProductCode": "SPSVRSSD00000003",
          "isProtectServerTermination": false,
          "portForwardingPublicIp": "49.236.160.11",
          "zone": {
            "zoneNo": "2",
            "zoneName": "KR-1",
            "zoneDescription": "가산 zone",
            "regionNo": "1"
          },
          "region": {
            "regionNo": "1",
            "regionCode": "KR",
            "regionName": "Korea"
          },
          "baseBlockStorageDiskType": {
            "code": "NET",
            "codeName": "Network Storage"
          },
          "baseBlockStorageDiskDetailType": {
            "code": "SSD",
            "codeName": "SSD"
          },
          "serverInstanceType": {
            "code": "STAND",
            "codeName": "Standard"
          },
          "userData": "",
          "accessControlGroupList": []
        },
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneDescription": "가산 zone",
          "regionNo": "1"
        }
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<replaceServerInstanceAssociatedWithPublicIpResponse>
  <requestId>82d58738-1aae-4677-982f-b194b24a683b</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstanceNo>662308</publicIpInstanceNo>
    <publicIp>49.236.160.36</publicIp>
    <publicIpDescription>testfsdf</publicIpDescription>
    <createDate>2018-05-23T11:04:38+0900</createDate>
    <publicIpInstanceStatusName>changing</publicIpInstanceStatusName>
    <publicIpInstanceStatus>
      <code>USED</code>
      <codeName>NET USED state</codeName>
    </publicIpInstanceStatus>
    <publicIpInstanceOperation>
      <code>CHANG</code>
      <codeName>NET CHANGE OP</codeName>
    </publicIpInstanceOperation>
    <publicIpKindType>
      <code>GEN</code>
      <codeName>General</codeName>
    </publicIpKindType>
    <serverInstanceAssociatedWithPublicIp>
      <serverInstanceNo>691083</serverInstanceNo>
      <serverName>import-key</serverName>
      <serverDescription></serverDescription>
      <cpuCount>2</cpuCount>
      <memorySize>4294967296</memorySize>
      <baseBlockStorageSize>53687091200</baseBlockStorageSize>
      <platformType>
        <code>LNX64</code>
        <codeName>Linux 64 Bit</codeName>
      </platformType>
      <loginKeyName>import-key</loginKeyName>
      <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
      <publicIp>49.236.160.36</publicIp>
      <privateIp>10.39.3.136</privateIp>
      <serverImageName>centos-6.6-64</serverImageName>
      <serverInstanceStatus>
        <code>RUN</code>
        <codeName>Server run state</codeName>
      </serverInstanceStatus>
      <serverInstanceOperation>
        <code>NULL</code>
        <codeName>Server NULL OP</codeName>
      </serverInstanceOperation>
      <serverInstanceStatusName>running</serverInstanceStatusName>
      <createDate>2018-06-15T11:15:10+0900</createDate>
      <uptime>2018-06-15T11:15:10+0900</uptime>
      <serverImageProductCode>SPSW0LINUX000044</serverImageProductCode>
      <serverProductCode>SPSVRSSD00000003</serverProductCode>
      <isProtectServerTermination>false</isProtectServerTermination>
      <portForwardingPublicIp>49.236.160.11</portForwardingPublicIp>
      <zone>
        <zoneNo>2</zoneNo>
        <zoneName>KR-1</zoneName>
        <zoneDescription>가산 zone</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/>
    </serverInstanceAssociatedWithPublicIp>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneDescription>가산 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </publicIpInstanceList>
</replaceServerInstanceAssociatedWithPublicIpResponse>
```