assignSecondaryIps
    • PDF

    assignSecondaryIps

    • PDF

    기사 요약

    개요

    네트워크 인터페이스에 보조 IP를 할당합니다.

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    보조 IP를 할당할 네트워크 인터페이스의 리전(Region) 결정 가능
    regionCode는 getRegionList 액션을 통해 획득 가능
    Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    networkInterfaceNoYesString- 보조 IP를 할당할 네트워크 인터페이스 번호
    networkInterfaceNo는 getNetworkInterfaceList 액션을 통해 획득 가능
    secondaryIpList.NConditionalList<String>Min : 0, Max 5 개- 할당할 보조 IP 리스트
    선택한 네트워크 인터페이스가 위치한 Subnet의 IP 주소 범위에 포함되는 Private IP를 보조 IP로 추가 가능
    네트워크 인터페이스당 최대 5개의 보조 IP를 추가 가능
    secondaryIpList 개수와 secondaryIpCount 개수를 합쳐서 최소 1개의 Secondary IP를 지정해야 함
    ex) secondaryIpList.1=192.168.0.1&secondaryIpList.2=192.168.0.2
    secondaryIpCountConditionalIntegerMin : 0, Max 5- 보조 IP 자동 할당 개수
    지정한 개수만큼 보조 IP 자동 할당 가능
    선택한 네트워크 인터페이스가 위치한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨
    네트워크 인터페이스당 최대 5개의 보조 IP를 추가 가능
    secondaryIpList 개수와 secondaryIpCount 개수를 합쳐서 최소 1개의 Secondary IP를 지정해야 함
    allowReassignNoBoolean- 명시적 재할당 허용 여부
    true로 설정시 다른 네트워크 인터페이스에서 사용하고 있는 보조 IP가 있다면 해제하고 선택된 네트워크 인터페이스에 재할당함
    false로 설정시 다른 네트워크 인터페이스에서 사용중인 보조 IP가 있다면 오류 발생
    선택한 모든 보조 IP가 사용중이 아니거나 선택된 네트워크 인터페이스에 이미 할당되어 있는 경우 오류는 발생하지 않음
    secondaryIpList로 지정한 IP에 대해서만 적용됨
    Options : true | false
    Default : false

    응답

    응답 데이터 타입

    • 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 assignSecondaryIps --regionCode FKR --networkInterfaceNo ***87 --secondaryIpList ***.***.1.7 --secondaryIpCount 1
    

    응답 예시

    <assignSecondaryIpsResponse>
      <requestId>73caedc4-073d-4001-a363-efedd90831be</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <networkInterfaceList>
        <networkInterface>
          <networkInterfaceNo>***87</networkInterfaceNo>
          <networkInterfaceName>test-***</networkInterfaceName>
          <subnetNo>***43</subnetNo>
          <deleteOnTermination>true</deleteOnTermination>
          <isDefault>true</isDefault>
          <deviceName>eth0</deviceName>
          <networkInterfaceStatus>
            <code>USED</code>
            <codeName>used </codeName>
          </networkInterfaceStatus>
          <instanceType>
            <code>VSVR</code>
            <codeName>Server (VPC)</codeName>
          </instanceType>
          <instanceNo>***4299</instanceNo>
          <ip>***.***.1.6</ip>
          <macAddress>F2:20:***:***:8A:F5</macAddress>
          <accessControlGroupNoList>
            <accessControlGroupNo>***63</accessControlGroupNo>
          </accessControlGroupNoList>
          <networkInterfaceDescription></networkInterfaceDescription>
          <secondaryIpList>
            <secondaryIp>***.***.1.7</secondaryIp>
            <secondaryIp>***.***.1.8</secondaryIp>
          </secondaryIpList>
        </networkInterface>
      </networkInterfaceList>
    </assignSecondaryIpsResponse>
    

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

    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.