attachNetworkInterface

Prev Next

Can be used in a VPC environment.

Overview

This assigns a network interface to the server instance. You can assign up to three network interfaces, including the server instance's default network interface.

Request

Request parameters

Parameter name Required Type Restrictions Description
regionCode No String Region code
You can decide the region of the network interface to be assigned.
regionCode can be obtained through the getRegionList action.
Default: Select the first region of the getRegionList search results
subnetNo Yes String Subnet number
This determines the subnet of the network interface to be assigned.
subnetNo can be obtained through the getSubnetList action.
networkInterfaceNo Yes String The number of the network interface to be assigned
networkInterfaceNo can be obtained through the getNetworkInterfaceList action.
serverInstanceNo Yes String Server instance number
This determines the server instance to which a network interface will be assigned.
serverInstanceNo can be obtained through the getServerInstanceList action.
responseFormatType No String Format type of the response results
Options : xml | json
Default : xml

Response

Response body

Example

Request Example

GET {API_URL}/attachNetworkInterface
?regionCode=KR
&subnetNo=***43
&networkInterfaceNo=***87
&serverInstanceNo=***4299

Response Example

<attachNetworkInterfaceResponse>
  <requestId>1a73c4ba-2a34-4849-bf2a-4d55fd5a7814</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <networkInterfaceList>
    <networkInterface>
      <networkInterfaceNo>***87</networkInterfaceNo>
      <networkInterfaceName>test-***</networkInterfaceName>
      <subnetNo>***43</subnetNo>
      <deleteOnTermination>false</deleteOnTermination>
      <isDefault>false</isDefault>
      <deviceName>eth1</deviceName>
      <networkInterfaceStatus>
        <code>SET</code>
        <codeName>set</codeName>
      </networkInterfaceStatus>
      <instanceType>
        <code>VSVR</code>
        <codeName>Server (VPC)</codeName>
      </instanceType>
      <instanceNo>***4299</instanceNo>
      <ip>***.***.1.7</ip>
      <macAddress>F2:20:***:***:8A:F5</macAddress>
      <accessControlGroupNoList/>
      <networkInterfaceDescription></networkInterfaceDescription>
      <secondaryIpList></secondaryIpList>
    </networkInterface>
  </networkInterfaceList>
</attachNetworkInterfaceResponse>