MENU
      assignSecondaryIps

        assignSecondaryIps


        Article summary

        Can be used in a VPC environment.

        Overview

        Assign secondary IPs to a network interface.

        Request

        Request parameter

        Parameter nameRequirement statusTypeRestrictionsDescription
        regionCodeNoString- Region code
        You can decide the region of the network interface to assign secondary IPs.
        You can obtain regionCode through the getRegionList action.
        Default: Selects the first region of the getRegionList search results.
        networkInterfaceNoYesString- The network interface number to assign secondary IP
        You can obtain networkInterfaceNo through the getNetworkInterfaceList action.
        secondaryIpList.NConditionalListMin: 0, Max: 5- List of secondary IPs to assign
        You can add private IPs that are included in the IP address range of the subnet where the network interface is located as secondary IPs.
        Up to 5 secondary IPs per network interface can be added.
        At least one secondary IP must be specified, which is counted by adding the numbers of secondaryIpList and secondaryIpCount.
        E.g., secondaryIpList.1=192.168.0.1&secondaryIpList.2=192.168.0.2
        secondaryIpCountConditionalIntegerMin: 0, Max: 5- Number of automatically assigned secondary IPs
        A specified number of secondary IPs can be assigned automatically.
        Private IPs, which are not being used in the subnet where the selected network interface is located, get assigned in sequence.
        Up to 5 secondary IPs per network interface can be added.
        At least one secondary IP must be specified, which is counted by adding the numbers of secondaryIpList and secondaryIpCount.
        allowReassignNoBoolean- Whether reassignment is explicitly allowed
        When set to true, it's necessary to remove the secondary IPs being used by another network interface, if there is one, and to reassign them to the selected network interface.
        When set to false, an error occurs if there are secondary IPs being used by another network interface.
        The error will not occur if all the selected secondary IPs are not in use or already assigned to the selected network interface.
        It is only applicable for the IPs specified with secondaryIpList.
        Options: true | false
        Default: false
        responseFormatTypeNoString- Format type of the response result
        Options: xml | json
        Default: xml

        Response

        Response body

        Examples

        Request examples

        GET {API_URL}/assignSecondaryIps
        ?regionCode=KR
        &networkInterfaceNo=***87
        &secondaryIpList.1=***.***.1.7
        $secondaryIpCount=1
        HTTP

        Response examples

        <assignSecondaryIpsResponse>
          <requestId>73caedc4-073d-4001-a363-efedd90831be</requestId>
          <returnCode>0</returnCode>
          <returnMessage>success</returnMessage>
          <totalRows>1</totalRows>
          <networkInterfaceList>
            <networkInterface>
              <networkInterfaceNo>***87</networkInterfaceNo>
              <networkInterfaceName>test-***</networkInterfaceName>
              <subnetNo>***43</subnetNo>
              <deleteOnTermination>true</deleteOnTermination>
              <isDefault>true</isDefault>
              <deviceName>eth0</deviceName>
              <networkInterfaceStatus>
                <code>USED</code>
                <codeName>used </codeName>
              </networkInterfaceStatus>
              <instanceType>
                <code>VSVR</code>
                <codeName>Server (VPC)</codeName>
              </instanceType>
              <instanceNo>***4299</instanceNo>
              <ip>***.***.1.6</ip>
              <macAddress>F2:20:***:***:8A:F5</macAddress>
              <accessControlGroupNoList>
                <accessControlGroupNo>***63</accessControlGroupNo>
              </accessControlGroupNoList>
              <networkInterfaceDescription></networkInterfaceDescription>
              <secondaryIpList>
                <secondaryIp>***.***.1.7</secondaryIp>
                <secondaryIp>***.***.1.8</secondaryIp>
              </secondaryIpList>
            </networkInterface>
          </networkInterfaceList>
        </assignSecondaryIpsResponse>
        XML

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.