--- title: "createNetworkInterface" slug: "cli-vserver-networkinterface-createnetworkinterface" updated: 2026-09-17T10:11:00Z published: 2026-09-17T10:11:00Z canonical: "cli.ncloud-docs.com/cli-vserver-networkinterface-createnetworkinterface" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createNetworkInterface VPC環境で利用できます。 ネットワークインターフェースを作成します。 ## 構文 `createNetworkInterface`構文は次の通りです。 ``` ./ncloud vserver createNetworkInterface \ --vpcNo \ --subnetNo \ --accessControlGroupNoList \ [--serverInstanceNo ] \ [--isBareMetal ] \ [--networkInterfaceName ] \ [--networkInterfaceDescription ] \ [--ip ] \ [--secondaryIpList ] \ [--secondaryIpCount ] \ [--regionCode ] \ [--output ] ``` ## オプション `createNetworkInterface`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createNetworkInterface`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | VPC番号 - [getVpcList](/docs/ja/cli-vpc-vpcmanagement-getvpclist)を参照 | | `--subnetNo` | String | Required | Subnet番号 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--accessControlGroupNoList` | List | Required | ACG番号リスト - スペースで区切って1~3個入力可能 (例: `--accessControlGroupNoList 1234 2345`) - [getAccessControlGroupList](/docs/ja/cli-vserver-acg-getaccesscontrolgrouplist)を参照 | | `--serverInstanceNo` | String | Conditional | サーバインスタンス番号 - Private Subnetのネットワークインターフェースの場合にのみサーバに割り当て可能 - [getServerInstanceList](/docs/ja/cli-vserver-server-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 (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 ネットワークインターフェースの作成リクエストが成功すると、ネットワークインターフェースの識別情報とネットワーク構成が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./ncloud vserver createNetworkInterface \ --vpcNo 12345678 \ --subnetNo 23456789 \ --accessControlGroupNoList 67890123 \ --networkInterfaceName test-nic-01 \ --networkInterfaceDescription "Test network interface" \ --secondaryIpCount 1 \ --regionCode KR \ --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" } } ```