createNetworkInterface

네트워크 인터페이스를 생성합니다.

구문

createNetworkInterface 구문은 다음과 같습니다.

./ncloud vserver createNetworkInterface \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --accessControlGroupNoList <acg-no-list> \
    [--serverInstanceNo <server-instance-no>] \
    [--isBareMetal <true|false>] \
    [--networkInterfaceName <nic-name>] \
    [--networkInterfaceDescription <nic-description>] \
    [--ip <ip>] \
    [--secondaryIpList <secondary-ip-list>] \
    [--secondaryIpCount <secondary-ip-count>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

createNetworkInterface 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createNetworkInterface의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--vpcNo`	String	Required	VPC 번호 getVpcList 참조
`--subnetNo`	String	Required	Subnet 번호 getSubnetList 참조
`--accessControlGroupNoList`	List	Required	ACG 번호 목록 공백으로 구분하여 1~3개 입력 가능 (예시: `--accessControlGroupNoList 1234 2345`) getAccessControlGroupList 참조
`--serverInstanceNo`	String	Conditional	서버 인스턴스 번호 Private Subnet의 네트워크 인터페이스인 경우에만 서버에 할당 가능 getServerInstanceList 참조

선택 옵션

createNetworkInterface의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--isBareMetal`	Boolean	Optional	베어메탈 서버용 네트워크 인터페이스 여부 `true` \| `false` (기본값) `true`: 베어메탈 서버용 (`serverInstanceNo` 필수 입력) `false`: 일반 일반 Subnet에서는 베어메탈 서버용 네트워크 인터페이스 생성 불가
`--networkInterfaceName`	String	Optional	네트워크 인터페이스 이름 미입력 시 자동 생성 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~30자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성
`--networkInterfaceDescription`	String	Optional	네트워크 인터페이스 설명 (Byte) 0~1,000
`--ip`	String	Optional	Primary IP 주소 미입력 시 자동 할당 Subnet의 IP 주소 범위 내 입력 Subnet의 0~5번째, 마지막 IP 주소 사용 불가 Subnet 범위 내 IP 주소 중복 불가
`--secondaryIpList`	List	Optional	Secondary IP 목록 공백으로 구분하여 여러 개 입력 가능 (예시: `--secondaryIpList 192.168.0.1 192.168.0.2`) Subnet의 IP 주소 범위 내 입력 `secondaryIpCount` 포함 최대 5개 입력 가능 Subnet 범위 내 IP 주소 중복 불가
`--secondaryIpCount`	Integer	Optional	Secondary IP 자동 할당 수 0~5 Private IP를 순차적으로 자동 할당 `secondaryIpList` 포함 최대 5개 입력 가능

공통 옵션

vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server 옵션을 참조해 주십시오.

예시

네트워크 인터페이스 생성 요청이 성공하면 네트워크 인터페이스의 식별 정보와 네트워크 구성이 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vserver createNetworkInterface \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --accessControlGroupNoList 67890123 \
    --networkInterfaceName test-nic-01 \
    --networkInterfaceDescription "Test network interface" \
    --secondaryIpCount 1 \
    --regionCode FKR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createNetworkInterfaceResponse": {
    "totalRows": 1,
    "networkInterfaceList": [
      {
        "networkInterfaceNo": "56789012",
        "networkInterfaceName": "test-nic-01",
        "subnetNo": "23456789",
        "deleteOnTermination": false,
        "isDefault": false,
        "deviceName": "",
        "networkInterfaceStatus": {
          "code": "NOTUSED",
          "codeName": "미사용중"
        },
        "ip": "192.0.2.10",
        "macAddress": "F2:20:AF:00:00:01",
        "enableFlowLog": false,
        "accessControlGroupNoList": [
          "67890123"
        ],
        "networkInterfaceDescription": "Test network interface",
        "secondaryIpList": [
          "192.0.2.11"
        ]
      }
    ],
    "requestId": "b1c2d3e4-f5a6-7890-bcde-f12345678901",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index

createNetworkInterface

구문

옵션

필수 옵션

선택 옵션

공통 옵션

예시

명령

출력