Documentation Index

Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

attachNetworkInterface

Prev Next

개요

서버 인스턴스에 네트워크 인터페이스를 할당합니다. 서버 인스턴스의 기본 네트워크 인터페이스를 포함하여 최대 3개의 네트워크 인터페이스를 할당할 수 있습니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
할당할 네트워크 인터페이스의 리전(Region) 결정 가능
regionCode는 getRegionList 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택
subnetNo Yes String - Subnet 번호
할당할 네트워크 인터페이스의 Subnet을 결정함
subnetNo는 getSubnetList 액션을 통해 획득 가능
networkInterfaceNo Yes String - 할당할 네트워크 인터페이스 번호
networkInterfaceNo는 getNetworkInterfaceList 액션을 통해 획득 가능
serverInstanceNo Yes String - 서버 인스턴스 번호
네트워크 인터페이스가 할당될 서버 인스턴스를 결정함
serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능

응답

응답 데이터 타입

  • 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 attachNetworkInterface --regionCode FKR --subnetNo ***43 --networkInterfaceNo ***87 --serverInstanceNo ***4299

응답 예시

<attachNetworkInterfaceResponse>
  <requestId>1a73c4ba-2a34-4849-bf2a-4d55fd5a7814</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>SET</code>
        <codeName>set</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/>
      <networkInterfaceDescription></networkInterfaceDescription>
      <secondaryIpList></secondaryIpList>
    </networkInterface>
  </networkInterfaceList>
</attachNetworkInterfaceResponse>