configuration / network / interfaces
CLI REST-API

## add-interface

    add-interface [vif-id] [port-id]
    The "add-interface" command adds another virtual interface to the system. Virtual
    interfaces can be assigned to an individual VLAN and they are used to configure
    IPv4 and IPv6 addresses. Each virtual interface has to be assigned to a
    physical network port on the system. Please note that if you assign the virtual
    interface to a network port that is part of a bonding group or PRP team, the
    system automatically sets up the IP addresses of the interface on all ports of
    the bonding/LACP/PRP group.

    In order to assign and configure a new virtual interface after you created it with
    "add-interface", you have to edit the configuration parameters in the
    /configuration/network/interfaces/[name of virtual interface]/ menu. For example,
    assigning the virtual interface 10 to network port lan0 requires the following command:

    "/configuration/network/interfaces/vif10/misc/assigned-port lan0"

    RESTAPI: The Json-data will be copied to the new interface.
    The data can be passed in the body like this:
    {
        "parameters": {
            "vif-id": "vif0"
        }
    }

Name | Value | Description | Example
--- | --- | --- | ---
| vif-id |  | vif0
| port-id |  | lan0

See also:
/configuration/network/interfaces: Configue existing Interfaces
/configuration/network/interfaces/delete-interface: deletes a virtual interfaces definition from the system configuration

#### REST-API Support:

This command is supported by the REST API:
Method: POST
URL: /api/configuration/network/interfaces/add-interface
Body:

    {
        "parameters": {
            "vif-id": [vif-id]
        }
    }

Example using curl:

    curl -X POST /api/configuration/network/interfaces/add-interface -d
    "{
        \"parameters\": {
            \"vif-id\": \"vif0\"
        }
    }"