---
title: "NetworkInterface"
slug: "common-vapidatatype-networkinterface"
tags: ["VPC", "Network ACL"]
updated: 2026-07-23T09:04:00Z
published: 2026-07-23T09:04:00Z
canonical: "api.ncloud-docs.com/common-vapidatatype-networkinterface"
---

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

# NetworkInterface

VPC 환경에서 이용 가능합니다.

네트워크 인터페이스입니다.

## 구문

구문은 다음과 같습니다.

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

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `networkInterfaceNo` | String | Required | 네트워크 인터페이스 번호 - 네트워크 인터페이스를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| `networkInterfaceName` | String | Required | 네트워크 인터페이스 이름 |
| `subnetNo` | String | Required | Subnet 번호 |
| `deleteOnTermination` | Boolean | Required | 네트워크 인터페이스가 할당된 디바이스 반납 시 자동 반납 여부 - `true` \| `false` - 생성 시 자동으로 결정되며, 디바이스 생성 시 새로운 디폴트 NIC일 경우 `true` |
| `isDefault` | Boolean | Required | 디바이스의 디폴트 네트워크 인터페이스 여부 - `true` \| `false` |
| `deviceName` | String | Optional | 네트워크 인터페이스가 할당된 디바이스에서의 이더넷 이름 - `eth0` \| `eth1` \| `eth2` |
| `networkInterfaceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 네트워크 인터페이스 상태 - `SET`: Set - `UNSET`: Unset - `USED`: Used - `NOTUSED`: Not Used |
| `instanceType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | 네트워크 인터페이스가 할당된 디바이스의 인스턴스 유형 - `VSVR` - `VSVR`: VPC 서버 인스턴스 |
| `instanceNo` | String | Optional | 네트워크 인터페이스가 할당된 디바이스의 인스턴스 번호 |
| `ip` | String | Required | 네트워크 인터페이스에 할당된 IP 주소 |
| `macAddress` | String | Required | MAC 주소 |
| `accessControlGroupNoList` | [AccessControlGroupNoList](/docs/common-vapidatatype-accesscontrolgroupnolist) | Optional | 네트워크 인터페이스에 적용된 ACG 번호 목록 - 최대 3개까지 적용 가능 |
| `networkInterfaceDescription` | String | Optional | 네트워크 인터페이스 설명 |
| `secondaryIpList` | [SecondaryIpList](/docs/common-vapidatatype-secondaryiplist) | Optional | 보조 IP 목록 |