replaceServerInstanceAssociatedWithPublicIp

Article summary

Did you find this summary helpful?

Thank you for your feedback

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	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 publicIpInstanceList = new ArrayList();

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>

Was this article helpful?

What's Next

getPortForwardingRuleList

Table of contents

Overview
Description
Request Parameters
Response Data Type
Examples