assignSecondaryIps
- Print
- PDF
assignSecondaryIps
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Can be used in a VPC environment.
Overview
Assign secondary IPs to a network interface.
Request
Request parameter
| Parameter name | Requirement status | Type | Restrictions | Description |
|---|---|---|---|---|
| regionCode | No | String | - 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. | |
| networkInterfaceNo | Yes | String | - The network interface number to assign secondary IP You can obtain networkInterfaceNo through the getNetworkInterfaceList action. | |
| secondaryIpList.N | Conditional | List | Min: 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 |
| secondaryIpCount | Conditional | Integer | Min: 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. |
| allowReassign | No | Boolean | - 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 | |
| responseFormatType | No | String | - 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
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>
Was this article helpful?