associatePublicIpWithServerInstance

Prev Next

Overview

Assign a public IP to a server instance.

Request

Request parameters

Parameter name Required Type Restrictions Description
publicIpInstanceNo Yes String - Public IP instance number to assign
publicIpInstanceNo can be obtained through the getPublicIpInstanceList action.
serverInstanceNo Yes String - Server instance number to assign
serverInstanceNo that can be assigned a public IP can be obtained through the getPublicIpTargetServerInstanceList action.
responseFormatType No String - Format type of the response result
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

GET {SERVER_API_URL}/associatePublicIpWithServerInstance
?publicIpInstanceNo=1089236
&serverInstanceNo=1088217

Response example

<associatePublicIpWithServerInstanceResponse>
  <requestId>b4b38b18-a07e-4b9b-84fb-1ffeda6638fd</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>1089236</publicIpInstanceNo>
      <publicIp>49.236.137.138</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2018-11-28T14:38:55+0900</createDate>
      <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>USE</code>
        <codeName>NET USE OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp>
        <serverInstanceNo>1088217</serverInstanceNo>
        <serverName>s167545541a3</serverName>
        <serverDescription></serverDescription>
        <cpuCount>4</cpuCount>
        <memorySize>8589934592</memorySize>
        <baseBlockStorageSize>53687091200</baseBlockStorageSize>
        <platformType>
          <code>LNX32</code>
          <codeName>Linux 32 Bit</codeName>
        </platformType>
        <loginKeyName>juhoon-kim</loginKeyName>
        <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
        <publicIp>49.236.137.138</publicIp>
        <privateIp>10.41.83.168</privateIp>
        <serverImageName>centos-6.3-32</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-11-27T17:42:13+0900</createDate>
        <uptime>2018-11-27T18:35:47+0900</uptime>
        <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
        <serverProductCode>SPSVRSTAND000005</serverProductCode>
        <isProtectServerTermination>false</isProtectServerTermination>
        <portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
        <zone>
          <zoneNo>3</zoneNo>
          <zoneName>KR-2</zoneName>
          <zoneCode>KR-2</zoneCode>
          <zoneDescription>Pyeongchon 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>HDD</code>
          <codeName>HDD</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>Pyeongchon zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</associatePublicIpWithServerInstanceResponse>

Errors

Errors that may occur while using this action are listed below. For more information about common errors, see NAVER Cloud Platform API.

HTTP Response Code Return code Return message
400 24094 The line for internet access of server does not correspond with which of Public IP.
400 24109 The input parameter instance number is invalid.
400 24120 The input parameter server instance number is invalid.
400 24122 The input parameter public IP instance number is invalid.
400 25029 You may not perform the allocate task since (other) user is changing the target official IP settings.
400 25101 The server is currently being operated. so public IP is unable to be associated with the server.
400 28100 Another public IP is already associated with the server.
400 28101 A public IP is already associated with server.