createNetworkInterface
- 인쇄
- PDF
createNetworkInterface
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
개요
네트워크 인터페이스를 생성합니다.
요청
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| regionCode | No | String | - 리전 코드 네트워크 인터페이스가 생성될 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | |
| vpcNo | Yes | String | - VPC 번호 네트워크 인터페이스가 생성될 VPC 결정 vpcNo는 getVpcList 액션을 통해 획득 가능 | |
| subnetNo | Yes | String | - Subnet 번호 네트워크 인터페이스가 생성될 Subnet 결정 subnetNo는 getSubnetList 액션을 통해 획득 가능 | |
| networkInterfaceName | No | String | Min : 3, Max : 30 소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함 영어 또는 숫자로 끝나야 함 | - 생성할 네트워크 인터페이스 이름 Default : NAVER Cloud Platform가 자동으로 부여 |
| accessControlGroupNoList.N | Yes | List<String> | Min : 1, Max : 3 개 | - 네트워크 인터페이스에 적용할 ACG 번호 리스트 최대 3개의 ACG 적용 가능 accessControlGroupNo는 getAccessControlGroupList 액션을 통해 획득 가능 ex) accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345 |
| serverInstanceNo | No | String | - 네트워크 인터페이스를 할당할 서버 인스턴스 번호 생성하는 네트워크 인터페이스가 Private Subnet의 네트워크 인터페이스인 경우에만 서버에 할당 가능 serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 | |
| ip | No | String | - IP 주소 네트워크 인터페이스에 할당할 IP 주소를 직접 입력 가능 네트워크 인터페이스가 생성되는 Subnet의 IP 주소 범위에 포함되어야 함 Subnet의 0~5번째, 마지막 IP 주소는 사용할 수 없으며 Subnet 범위에서 중복된 IP 주소 사용 불가 Default : 조건을 만족하는 IP 주소가 순차적으로 할당됨 ex) 192.168.0.6 | |
| isBareMetal | No | Boolean | - 베어메탈용 네트워크 인터페이스 여부 true로 설정시 베어메탈용 네트워크 인터페이스를 생성하고 이 경우 서버를 명시해야만 생성 가능(serverInstanceNo 파라미터 필수) false로 설정시 일반 네트워크 인터페이스 생성 일반 서브넷에서는 베어메탈용 네트워크 인터페이스 생성 불가능 Default : 일반 네트워크 인터페이스 생성 | |
| secondaryIpList.N | No | List<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 |
| secondaryIpCount | No | Integer | Min : 0, Max : 5 | - 보조 IP 자동 할당 개수 지정한 개수만큼 보조 IP를 자동 할당 가능 선택한 Subnet에서 사용중이지 않은 Private IP가 순차적으로 할당됨 secondaryIpList의 개수와 함쳐서 최대 5개의 보조 IP 추가 가능 |
| networkInterfaceDescription | No | String | Min : 0, Max : 1000 Bytes | 생성할 네트워크 인터페이스에 대한 설명 |
| responseFormatType | No | String | - 응답 결과의 포맷 타입 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>
이 문서가 도움이 되었습니까?