createNetworkInterface
    • PDF

    createNetworkInterface

    • PDF

    기사 요약

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