createNetworkInterface
    • PDF

    createNetworkInterface

    • PDF

    Article Summary

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

    개요

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

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    네트워크 인터페이스가 생성될 리전(Region) 결정 가능
    regionCode는 getRegionList 액션을 통해 획득 가능
    Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    vpcNoYesString- VPC 번호
    네트워크 인터페이스가 생성될 VPC 결정
    vpcNo는 getVpcList 액션을 통해 획득 가능
    subnetNoYesString- Subnet 번호
    네트워크 인터페이스가 생성될 Subnet 결정
    subnetNo는 getSubnetList 액션을 통해 획득 가능
    networkInterfaceNameNoStringMin : 3, Max : 30
    소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함
    영어 또는 숫자로 끝나야 함
    - 생성할 네트워크 인터페이스 이름
    Default : NAVER Cloud Platform가 자동으로 부여
    accessControlGroupNoList.NYesList<String>Min : 1, Max : 3 개- 네트워크 인터페이스에 적용할 ACG 번호 리스트
    최대 3개의 ACG 적용 가능
    accessControlGroupNo는 getAccessControlGroupList 액션을 통해 획득 가능
    ex) accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345
    serverInstanceNoNoString- 네트워크 인터페이스를 할당할 서버 인스턴스 번호
    생성하는 네트워크 인터페이스가 Private Subnet의 네트워크 인터페이스인 경우에만 서버에 할당 가능
    serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
    ipNoString- IP 주소
    네트워크 인터페이스에 할당할 IP 주소를 직접 입력 가능
    네트워크 인터페이스가 생성되는 Subnet의 IP 주소 범위에 포함되어야 함
    Subnet의 0~5번째, 마지막 IP 주소는 사용할 수 없으며 Subnet 범위에서 중복된 IP 주소 사용 불가
    Default : 조건을 만족하는 IP 주소가 순차적으로 할당됨
    ex) 192.168.0.6
    isBareMetalNoBoolean- 베어메탈용 네트워크 인터페이스 여부
    true로 설정시 베어메탈용 네트워크 인터페이스를 생성하고 이 경우 서버를 명시해야만 생성 가능(serverInstanceNo 파라미터 필수)
    false로 설정시 일반 네트워크 인터페이스 생성
    일반 서브넷에서는 베어메탈용 네트워크 인터페이스 생성 불가능
    Default : 일반 네트워크 인터페이스 생성
    secondaryIpList.NNoList<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
    secondaryIpCountNoIntegerMin : 0, Max : 5- 보조 IP 자동 할당 개수
    지정한 개수만큼 보조 IP를 자동 할당 가능
    선택한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨
    secondaryIpList의 개수와 함쳐서 최대 5개의 보조 IP 추가 가능
    networkInterfaceDescriptionNoStringMin : 0, Max : 1000 Bytes생성할 네트워크 인터페이스에 대한 설명
    responseFormatTypeNoString- 응답 결과의 포맷 타입
    Options : xml | json
    Default : xml

    응답

    응답 바디

    예시

    요청 예시

    GET {API_URL}/createNetworkInterface
    ?regionCode=KR
    &vpcNo=***04
    &subnetNo=***43
    &networkInterfaceName=test-***
    &accessControlGroupNoList.1=***63
    &serverInstanceNo=***4299
    &ip=***.***.1.7
    &secondaryIpList.1=***.***.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>
    

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.