개요

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

요청

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
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<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<>();

예시

요청 예시

ncloud vserver createNetworkInterface --regionCode KR --vpcNo ***04 --subnetNo ***43 --networkInterfaceName test-*** --accessControlGroupNoList ***63 ***64 --serverInstanceNo ***4299 --ip ***.***.1.7 --secondaryIpList ***.***.1.8 --secondaryIpCount 1

응답 예시

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

이 문서가 도움이 되었습니까?

개요
요청
- 요청 파라미터
응답
- 응답 데이터 타입
예시
- 요청 예시
- 응답 예시

태그