replaceServerInstanceAssociatedWithPublicIp

Prev Next

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