---
title: "assignSecondaryIps"
slug: "cli-vserver-networkinterface-assignsecondaryips"
updated: 2026-04-23T09:04:53Z
published: 2026-04-23T09:07:31Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# assignSecondaryIps

## 개요<a name="개요"></a>

네트워크 인터페이스에 보조 IP를 할당합니다.

## 요청<a name="요청"></a>


### 요청 파라미터<a name="요청파라미터"></a>


| 파라미터명                            | 필수 여부      | 타입                   | 제약 사항               | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | --------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                       | - 리전 코드<br>보조 IP를 할당할 네트워크 인터페이스의 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택  |
| networkInterfaceNo                 | Yes          | String                |                       | - 보조 IP를 할당할 네트워크 인터페이스 번호<br>networkInterfaceNo는 [getNetworkInterfaceList](/docs/cli-vserver-networkinterface-getnetworkinterfacelist) 액션을 통해 획득 가능 |
| secondaryIpList.N                  | Conditional  | List&lt;String&gt;    | Min : 0, Max 5 개      | - 할당할 보조 IP 리스트<br>선택한 네트워크 인터페이스가 위치한 Subnet의 IP 주소 범위에 포함되는 Private IP를 보조 IP로 추가 가능<br>네트워크 인터페이스당 최대 5개의 보조 IP를 추가 가능<br>secondaryIpList 개수와 secondaryIpCount 개수를 합쳐서 최소 1개의 Secondary IP를 지정해야 함<br>ex) secondaryIpList.1=192.168.0.1&secondaryIpList.2=192.168.0.2    |
| secondaryIpCount                   | Conditional  | Integer               | Min : 0, Max 5        | - 보조 IP 자동 할당 개수<br>지정한 개수만큼 보조 IP 자동 할당 가능<br>선택한 네트워크 인터페이스가 위치한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨<br>네트워크 인터페이스당 최대 5개의 보조 IP를 추가 가능<br>secondaryIpList 개수와 secondaryIpCount 개수를 합쳐서 최소 1개의 Secondary IP를 지정해야 함   |
| allowReassign                      | No           | Boolean               |                       | - 명시적 재할당 허용 여부<br>`true`로 설정시 다른 네트워크 인터페이스에서 사용하고 있는 보조 IP가 있다면 해제하고 선택된 네트워크 인터페이스에 재할당함<br>`false`로 설정시 다른 네트워크 인터페이스에서 사용중인 보조 IP가 있다면 오류 발생<br>선택한 모든 보조 IP가 사용중이 아니거나 선택된 네트워크 인터페이스에 이미 할당되어 있는 경우 오류는 발생하지 않음<br>secondaryIpList로 지정한 IP에 대해서만 적용됨<br>Options : true \| false<br>Default : false  |

## 응답<a name="응답"></a>


### 응답 데이터 타입<a name="응답데이터타입"></a>

- NetworkInterfaceList 타입

| NetworkInterfaceList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<NetworkInterface> networkInterfaceList = new ArrayList<>(); |

| NetworkInterface |
| ---------- |
| private String networkInterfaceNo; |
| private String networkInterfaceName; |
| private String subnetNo; |
| private Boolean deleteOnTermination; |
| private Boolean isDefault; |
| private String deviceName; |
| private CommonCode networkInterfaceStatus; |
| private CommonCode instanceType; |
| private String instanceNo; |
| private String ip; |
| private String macAddress; |
| private AccessControlGroupNoList accessControlGroupNoList; |
| private String networkInterfaceDescription; |
| private SecondaryIpList secondaryIpList; |

| SecondaryIpList |
| ---------- |
| private List<String> secondaryIpList = new ArrayList<>(); |


## 예시<a name="예시"></a>


### 요청 예시<a name="요청예시"></a>


```
ncloud vserver assignSecondaryIps --regionCode FKR --networkInterfaceNo ***87 --secondaryIpList ***.***.1.7 --secondaryIpCount 1
```

### 응답 예시<a name="응답예시"></a>


```xml
<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>
```