assignSecondaryIps

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

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

개요

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

요청

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
regionCode	No	String		- 리전 코드 보조 IP를 할당할 네트워크 인터페이스의 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택
networkInterfaceNo	Yes	String		- 보조 IP를 할당할 네트워크 인터페이스 번호 networkInterfaceNo는 getNetworkInterfaceList 액션을 통해 획득 가능
secondaryIpList.N	Conditional	List<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
secondaryIpCount	Conditional	Integer	Min : 0, Max 5	- 보조 IP 자동 할당 개수 지정한 개수만큼의 보조 IP 자동 할당 가능 선택한 네트워크 인터페이스가 위치한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨 네트워크 인터페이스당 최대 5개의 보조 IP 추가 가능 secondaryIpList 개수와 secondaryIpCount 개수를 합쳐서 최소 1개의 Secondary IP 지정 필요
allowReassign	No	Boolean		- 명시적 재할당 허용 여부 `true`로 설정시 다른 네트워크 인터페이스에서 사용하고 있는 보조 IP가 있다면 해제하고 선택된 네트워크 인터페이스에 재할당 필요 `false`로 설정시 다른 네트워크 인터페이스에서 사용중인 보조 IP가 있다면 오류 발생 선택한 모든 보조 IP가 사용중이 아니거나 선택된 네트워크 인터페이스에 이미 할당되어 있는 경우 오류 발생하지 않음 secondaryIpList로 지정한 IP에 대해서만 적용됨 Options : true \| false Default : false
responseFormatType	No	String		- 응답 결과의 포맷 타입 Options : xml \| json Default : xml

응답

응답 바디

NetworkInterfaceList

예시

요청 예시

GET {API_URL}/assignSecondaryIps
?regionCode=KR
&networkInterfaceNo=***87
&secondaryIpList.1=***.***.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>

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

What's Next

getNetworkInterfaceDetail

개요
요청
응답
예시

태그