createPublicIpInstance

Prev Next

Overview

Creates public IP instances.

Request

Request parameters

Parameter name Required Type Restrictions Description
serverInstanceNo No String - Number of server instance for which to create and assign a public IP address
serverInstanceNo that can be assigned a public IP can be obtained through the getPublicIpTargetServerInstanceList action.
publicIpDescription No String Min: 1, Max: 1000 Public IP description
regionNo No String - Region number
regionNo where the public IP will be created is can be obtained through the getRegionList action.
zoneNo No String - Zone number
zoneNo where the public IP will be created can be obtained through the getZoneList action.
Default: Select the first zone of the Region.
responseFormatType No String - Format type of the response result
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

GET {SERVER_API_URL}/createPublicIpInstance

Response example

<createPublicIpInstanceResponse>
  <requestId>2f8ca49e-0532-43f2-884d-d7f8a737cac4</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>created</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>NULL</code>
        <codeName>NET NULL OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp/>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>Pyeongchon zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>

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 10101 Unable to request for public IP. You may request as many public IPs as the number of server in possession.
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 24094 The line for internet access of server does not correspond with which of Public IP.
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.