createNetworkInterface

네트워크 인터페이스를 생성합니다.

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
네트워크 인터페이스가 생성될 리전(Region) 결정 가능
regionCode는 getRegionList 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택
vpcNo Yes String - VPC 번호
네트워크 인터페이스가 생성될 VPC를 결정함
vpcNo는 getVpcList 액션을 통해 획득 가능
subnetNo Yes String - Subnet 번호
네트워크 인터페이스가 생성될 Subnet을 결정함
subnetNo는 getSubnetList 액션을 통해 획득 가능
networkInterfaceName No String Min : 3, Max : 30
소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함
영어 또는 숫자로 끝나야 함		 - 생성할 네트워크 인터페이스 이름
Default : NAVER Cloud Platform가 자동으로 부여함
accessControlGroupNoList.N Yes List<String> Min : 1, Max : 3 개 - 네트워크 인터페이스에 적용할 ACG 번호 리스트
최대 3개의 ACG 적용 가능
accessControlGroupNo는 getAccessControlGroupList 액션을 통해 획득 가능
ex) --accessControlGroupNoList 1234 2345
serverInstanceNo No String - 네트워크 인터페이스를 할당할 서버 인스턴스 번호
생성하는 네트워크 인터페이스가 Private Subnet의 네트워크 인터페이스인 경우에만 서버에 할당 가능
serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
ip No String - IP 주소
네트워크 인터페이스에 할당할 IP 주소를 직접 입력 가능
네트워크 인터페이스가 생성되는 Subnet의 IP 주소 범위에 포함되어야 함
Subnet의 0~5번째, 마지막 IP 주소는 사용할 수 없으며 Subnet 범위에서 중복된 IP 주소 사용 불가
Default : 조건을 만족하는 IP 주소가 순차적으로 할당됨
ex) 192.168.0.6
isBareMetal No Boolean - 베어메탈용 네트워크 인터페이스 여부
true로 설정시 베어메탈용 네트워크 인터페이스를 생성하고 이 경우 서버를 명시해야만 생성가능(serverInstanceNo 파라미터 필수)
false로 설정시 일반 네트워크 인터페이스 생성
일반 서브넷에서는 베어메탈용 네트워크 인터페이스 생성 불가능
Default : 일반 네트워크 인터페이스 생성
secondaryIpList.N No List<String> Min : 0, Max : 5 개 - 보조 IP 리스트
선택한 Subnet의 IP 주소 범위에 포함되는 Private IP를 보조 IP로 추가 가능
secondaryIpCount의 개수와 합쳐서 최대 5개의 보조 IP 추가 가능
선택한 Subnet에서 이미 사용중인 IP 주소는 사용 불가
명시적 재할당 기능을 이용하려면 네트워크 인터페이스 생성 후 assignSecondaryIps 액션을 통해 가능
ex) secondaryIpList.1=192.168.0.1&secondaryIpList.2=192.168.0.2
secondaryIpCount No Integer Min : 0, Max : 5 - 보조 IP 자동 할당 개수
지정한 개수만큼 보조 IP를 자동 할당 가능
선택한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨
secondaryIpList의 개수와 함쳐서 최대 5개의 보조 IP 추가 가능
networkInterfaceDescription No String Min : 0, Max : 1000 Bytes 생성할 네트워크 인터페이스에 대한 설명
  • NetworkInterfaceList 타입
NetworkInterfaceList extends CommonResponse
private Integer totalRows;
private List 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 secondaryIpList = new ArrayList<>(); 
ncloud vserver createNetworkInterface --regionCode FKR --vpcNo ***04 --subnetNo ***43 --networkInterfaceName test-*** --accessControlGroupNoList ***63 ***64 --serverInstanceNo ***4299 --ip ***.***.1.7 --secondaryIpList ***.***.1.8 --secondaryIpCount 1
Plain text
<createNetworkInterfaceResponse>
  <requestId>18e8b085-c6bc-4953-9ec7-9cdf43236c59</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>USED</code>
        <codeName>used </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>
        <accessControlGroupNo>***63</accessControlGroupNo>
      </accessControlGroupNoList>
      <networkInterfaceDescription></networkInterfaceDescription>
      <secondaryIpList>
        <secondaryIp>***.***.1.8</secondaryIp>
        <secondaryIp>***.***.1.9</secondaryIp>
      </secondaryIpList>
    </networkInterface>
  </networkInterfaceList>
</createNetworkInterfaceResponse>
XML