createNetworkInterface

VPC環境で利用できます。

ネットワークインターフェースを作成します。

構文

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 <KR|SGN|JPN>] \
    [--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 (VPC)のオプションをご参照ください。

例

ネットワークインターフェースの作成リクエストが成功すると、ネットワークインターフェースの識別情報とネットワーク構成が返されます。

コマンド

コマンドの例は次の通りです。

./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"
  }
}

Documentation Index