---
title: "replaceServerInstanceAssociatedWithPublicIp"
slug: "cli-server-replaceserverinstanceassociatedwithpublicip"
updated: 2026-09-17T09:16:00Z
published: 2026-09-17T09:16:00Z
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

## 개요

공인 IP를 지정된 서버로 교체

## 설명

서버에 할당된 공인IP를 다른서버에 할당합니다.

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| publicIpInstanceNo | Yes | String |  | 기존 서버에 할당된 공인 IP 인스턴스 번호 |
| serverInstanceNo | Yes | String |  | - 교체할 서버 인스턴스 번호 getPublicIpTargetServerInstanceList 액션을 통해 획득 가능 같은 zone에 있는 서버끼리만 공인 IP의 교체가 가능 (KR-1 서버에 할당된 공인 IP를 KR-2의 서버로 교체는 불가능) |
| isErrorThrowing | No | Boolean |  | Default : true 이미 IP가 할당되어 있는 서버에 replaceServerInstanceAssociatedWithPublicIp 액션 시도시 발생하는 에러를 발생시키지 않음 |

## 응답 데이터 타입

- PublicIpInstanceList 타입

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

## 예시

### 호출

```
ncloud server replaceServerInstanceAssociatedWithPublicIp --serverInstanceNo 691083 --publicIpInstanceNo 662308
```

### 응답

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