---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/interfaces-api
---

# Сетевые интерфейсы

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/services/connection-to-provider/
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

{% cut "Получение состояния соединения" %}

```
GET /l2manager/connection_state
```

**Ответ на успешный запрос:**

```json5
{
    "id":  "string",
    "zone": "string" | null,
    "type": "ethernet" | "vlan" | "bond" | "loopback" | "gre" | "pppoe" | "l2tp" | "pptp" | "span",
    "status": "unknown" | "up" | "down" | "going-up",
    "vce_id": "string",
    "vpp_index": "integer",
    "kernel_index": "integer",
    "l3": ["string"],
    "dns": ["string"],
    "gateway": "string" | null
}
```

* `id` - идентификатор интерфейса, в котором используется физический порт;
* `zone` - идентификатор зоны, к которой относится порт. Может быть `null`, если зона не назначена;
* `type` - тип подключения. Допустимые значения:
  * `ethernet` - физический сетевой интерфейс (Ethernet); 
  * `vlan` - виртуальный сетевой интерфейс (VLAN); 
  * `bond` - агрегированный сетевой интерфейс (LACP);
  * `loopback` - виртуальный сетевой интерфейс (Loopback); 
  * `gre` - туннельный сетевой интерфейс (GRE);
  * `pppoe` - виртуальный сетевой интерфейс (PPPoE); 
  * `l2tp` - туннельный сетевой интерфейс (L2TP); 
  * `pptp` - туннельный сетевой интерфейс (PPTP); 
  * `span` - виртуальный сетевой интерфейс (SPAN);
  * `l2bridge` - сетевой мост между интерфейсами на уровне канального доступа (L2-мост).
* `status` - статус соединения:
  * `unknown` - неизвестен;
  * `up` - подключен;
  * `down` - не подключен;
  * `going-up` - подключение.
* `vce_id` - идентификатор VCE, к которому относится интерфейс. Для корневого VCE значение имеет вид `00000000-0000-0000-0000-000000000000`;
* `vpp_index` - индекс интерфейса в VPP;
* `kernel_index` - индекс интерфейса в системе;
* `l3` - список IP-адресов в формате CIDR;
* `dns` - список IP-адресов DNS;
* `gateway` - IP-адрес шлюза. Может быть `null`, если включено получение адресов по DHCP.

{% endcut %}

{% cut "Получение MAC-адреса по IP-адресу" %}

```
GET /l2manager/get_mac/<IP-адрес>
```

**Ответ на успешный запрос:**

```json5
{
  "mac": "string"
}
```

* `mac` - MAC-адрес в формате `11:22:33:44:55:66`. Все буквы в нижнем регистре.


{% endcut %}

{% cut "Получение списка MAC-адресов" %}

```
GET /l2manager/ports_macs
```

**Ответ на успешный запрос:**

```json5
{
  "mac_addresses": [
    "string",
    ...
  ]
}
```

* `mac_addresses` - список MAC-адресов сетевой карты, в формате `11:22:33:44:55:66`. Все буквы в нижнем регистре.

{% endcut %}

## Настройки соединений

{% cut "Получение настроек соединений" %}

```
GET /l2manager/connection_settings
```

**Ответ на успешный запрос:**

```json5
{
    "id":  "string",
    "title":  "string",
    "enabled": "bool",
    "comment": "string",
    "zone": "string" | null,
    "vce_id": "string",
    "netflow_index":  "integer",
    "type": "ethernet" | "vlan" | "bond" | "loopback" | "gre" | "pppoe" | "l2tp" | "pptp" | "span" | "l2bridge",
    "role": "cp" | "lan" | "wan",
    "l3_mode": "dhcp" | "static" | "none",
    "l3": ["string"],
    "config": { 
        // ВАЖНО: Содержит ОДИН из объектов ниже в зависимости от значения "type"
        
        // Для type: "ethernet"
        "port": "string" | null,
        
        // Для type: "vlan"
        "tag": "integer",
        "parent_interface": "string",

        // Для type: "bond"
        "ports": ["string"],
    
        // Для type: "gre"
        "server": "string",
        "parent_interface": "string",
        "local_ip": "string" | null,

        // Для type: "pppoe"
        "username": "string",
        "password": "string",
        "service": "string",
        "concentrator": "string",
        "parent_interface": "string",

        // Для type: "l2tp"
        "server": "string", 
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "pptp"
        "server": "string",
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "span"
        "source": ["string"],
        "destination": "string" | null,
        "direction": "tx" | "rx" | "both",

        // Для type: "l2bridge"
        "interfaces": ["string"],
        "vlan_mapping": [
            [
                "integer",
                "integer"
            ]
        ],   
    }    
}
```

* `id` - идентификатор интерфейса;
* `title` - название соединения;
* `enabled` - статус активности соединения:
  * `true` - включен;
  * `false` - выключен.
* `comment` - комментарий, максимальная длина - 256 символов. Может быть пустым;
* `zone` - идентификатор зоны. Может быть `null`, если зона не назначена;
* `vce_id` - идентификатор VCE. Для корневого VCE значение имеет вид `00000000-0000-0000-0000-000000000000`;
* `netflow_index` - целое число от 0 до 65535, индекс сетевого подключения для [Netflow](https://docs.ideco.ru/v22/ru/ngfw/settings/services/netflow);
* `type` - тип подключения. Допустимые значения: 
  * `ethernet` - физический сетевой интерфейс (Ethernet); 
  * `vlan` - виртуальный сетевой интерфейс (VLAN); 
  * `bond` - агрегированный сетевой интерфейс (LACP);
  * `loopback` - виртуальный сетевой интерфейс (Loopback); 
  * `gre` - туннельный сетевой интерфейс (GRE);
  * `pppoe` - виртуальный сетевой интерфейс (PPPoE); 
  * `l2tp` - туннельный сетевой интерфейс (L2TP); 
  * `pptp` - туннельный сетевой интерфейс (PPTP); 
  * `span` - виртуальный сетевой интерфейс (SPAN);
  * `l2bridge` - сетевой мост между интерфейсами на уровне канального доступа (L2-мост).
* `role` - роль интерфейса: 
  * `cp` - используется для администрирования NGFW Novum через веб-интерфейс;
  * `lan` - используется для создания локальных интерфейсов;
  * `wan` - используется для подключения к провайдеру.
* `l3_mode` - режим настройки IP-конфигурации:
  * `dhcp` - автоматическая настройка IP-адреса устройством при подключении к сети;
  * `static` - ручная настройка IP-адреса, который остается неизменным;
  * `none` - настройка, при которой не выдаются IP-адреса.
* `l3` - список IP-адресов в формате CIDR. Заполняется, если параметр `l3_mode` имеет значение `static`. Может быть пустым, если параметр `l3_mode` имеет значение `none` и `dhcp`.
* `config` - конфигурация соединения содержит список параметров в зависимости от значения параметра `type`:
  * `ethernet` - параметры Ethernet-интерфейса:
    * `port` - наименование порта.
  * `vlan` - параметры VLAN-интерфейса:
    * `tag` - тег VLAN;
    * `parent_interface` - идентификатор родительского интерфейса, на котором создан VLAN.
  * `bond` - параметры LACP-интерфейса:
    * `ports` - список наименований портов.
  * `gre` - параметры GRE-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `local_ip` - IP-адрес родительского интерфейса.
  * `pppoe` - параметры PPPoE-интерфейса:
    * `username` - имя пользователя для подключения;
    * `password`- пароль пользователя для подключения. Может быть пустым;
    * `service` - идентификатор сервиса. Может быть пустым;
    * `concentrator` - идентификатор концентратора. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение.
  * `l2tp` - параметры L2TP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `pptp` - параметры PPTP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `span` - параметры SPAN-интерфейса:
    * `source` - список идентификаторов интерфейсов;
    * `destination` - наименование порта назначения;
    * `direction` - тип дублирования трафика:
      * `tx` - только исходящий;
      * `rx` - только входящий;
      * `both` - весь трафик.
  * `l2bridge` - параметры L2-моста:
    * `interfaces` - список идентификаторов интерфейсов;
    * `vlan_mapping` - список тегов VLAN для маппинга. Каждый список должен содержать только два тега в формате `[исходный_vlan, новый_vlan]`.       

Если параметр `type` имеет значение `loopback`, то параметр `config` передается пустым.

{% endcut %}

{% cut "Добавление настройки соединения" %}

```
POST /l2manager/connection_settings
```

**Тело запроса:**

```json5
{
    "title":  "string",
    "enabled": "bool",
    "comment": "string",
    "zone": "string" | null,
    "vce_id": "string",
    "netflow_index":  "integer",
    "type": "ethernet" | "vlan" | "bond" | "loopback" | "gre" | "pppoe" | "l2tp" | "pptp" | "span" | "l2bridge",
    "role": "cp" | "lan" | "wan",
    "l3_mode": "dhcp" | "static" | "none",
    "l3": ["string"],
    "config": { 
        // ВАЖНО: Содержит ОДИН из объектов ниже в зависимости от значения "type"
        
        // Для type: "ethernet"
        "port": "string" | null,
        
        // Для type: "vlan"
        "tag": "integer",
        "parent_interface": "string",

        // Для type: "bond"
        "ports": ["string"],
    
        // Для type: "gre"
        "server": "string",
        "parent_interface": "string",
        "local_ip": "string" | null,

        // Для type: "pppoe"
        "username": "string",
        "password": "string",
        "service": "string",
        "concentrator": "string",
        "parent_interface": "string",

        // Для type: "l2tp"
        "server": "string", 
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "pptp"
        "server": "string",
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "span"
        "source": ["string"],
        "destination": "string" | null,
        "direction": "tx" | "rx" | "both",

        // Для type: "l2bridge"
        "interfaces": ["string"],
        "vlan_mapping": [
            [
                "integer",
                "integer"
            ]
        ],   
    }    
}
```

* `title` - название соединения;
* `enabled` - статус активности соединения:
  * `true` - включен;
  * `false` - выключен.
* `comment` - комментарий, максимальная длина - 256 символов. Может быть пустым;
* `zone` - идентификатор зоны. Может быть `null`, если зона не назначена;
* `vce_id` - идентификатор VCE. Для корневого VCE значение имеет вид `00000000-0000-0000-0000-000000000000`;
* `netflow_index` - целое число от 0 до 65535, индекс сетевого подключения для [Netflow](https://docs.ideco.ru/v22/ru/ngfw/settings/services/netflow);
* `type` - тип подключения. Допустимые значения:
  * `ethernet` - физический сетевой интерфейс (Ethernet); 
  * `vlan` - виртуальный сетевой интерфейс (VLAN); 
  * `bond` - агрегированный сетевой интерфейс (LACP);
  * `loopback` - виртуальный сетевой интерфейс (Loopback); 
  * `gre` - туннельный сетевой интерфейс (GRE);
  * `pppoe` - виртуальный сетевой интерфейс (PPPoE); 
  * `l2tp` - туннельный сетевой интерфейс (L2TP); 
  * `pptp` - туннельный сетевой интерфейс (PPTP); 
  * `span` - виртуальный сетевой интерфейс (SPAN);
  * `l2bridge` - сетевой мост между интерфейсами на уровне канального доступа (L2-мост).
* `role` - роль интерфейса: 
  * `cp` - используется для администрирования NGFW Novum через веб-интерфейс;
  * `lan` - используется для создания локальных интерфейсов;
  * `wan` - используется для подключения к провайдеру.
* `l3_mode` - режим настройки IP-конфигурации:
  * `dhcp` - автоматическая настройка IP-адреса устройством при подключении к сети;
  * `static` - ручная настройка IP-адреса, который остается неизменным;
  * `none` - настройка, при которой не выдаются IP-адреса.
* `l3` - список IP-адресов в формате CIDR. Заполняется, если параметр `l3_mode` имеет значение `static`. Может быть пустым, если параметр `l3_mode` имеет значение `none` и `dhcp`.
* `config` - конфигурация соединения содержит список параметров в зависимости от значения параметра `type`:
  * `ethernet` - параметры Ethernet-интерфейса:
    * `port` - наименование порта.
  * `vlan` - параметры VLAN-интерфейса:
    * `tag` - тег VLAN;
    * `parent_interface` - идентификатор родительского интерфейса, на котором создается VLAN.
  * `bond` - параметры LACP-интерфейса:
    * `ports` - список наименований портов.
  * `gre` - параметры GRE-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `local_ip` - IP-адрес родительского интерфейса.
  * `pppoe` - параметры PPPoE-интерфейса:
    * `username` - имя пользователя для подключения;
    * `password`- пароль пользователя для подключения. Может быть пустым;
    * `service` - идентификатор сервиса. Может быть пустым;
    * `concentrator` - идентификатор концентратора. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение.
  * `l2tp` - параметры L2TP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `pptp` - параметры PPTP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `span` - параметры SPAN-интерфейса:
    * `source` - список идентификаторов интерфейсов;
    * `destination` - наименование порта назначения;
    * `direction` - тип дублирования трафика:
      * `tx` - только исходящий;
      * `rx` - только входящий;
      * `both` - весь трафик.
  * `l2bridge` - параметры L2-моста:
    * `interfaces` - список идентификаторов интерфейсов;
    * `vlan_mapping` - список тегов VLAN для маппинга. Каждый список должен содержать только два тега в формате `[исходный_vlan, новый_vlan]`.       

Если параметр `type` имеет значение `loopback`, то параметр `config` передается пустым.

**Ответ на успешный запрос:**

```json5
{
  "id": "string"
}
```

* `id` - идентификатор созданного соединения.

{% endcut %}

{% cut "Редактирование настройки соединения" %}

```
PATCH /l2manager/connection_settings/<id соединения>
```

**Тело запроса (все или некоторые поля):**

```json5
{
    "title":  "string",
    "enabled": "bool",
    "comment": "string",
    "zone": "string" | null,
    "vce_id": "string",
    "netflow_index":  "integer",
    "role": "cp" | "lan" | "wan",
    "l3_mode": "dhcp" | "static" | "none",
    "l3": ["string"],
    "config": { 
        // ВАЖНО: Содержит ОДИН из объектов ниже в зависимости от значения "type"
        
        // Для type: "ethernet"
        "port": "string" | null,
        
        // Для type: "vlan"
        "tag": "integer",
        "parent_interface": "string",

        // Для type: "bond"
        "ports": ["string"],
    
        // Для type: "gre"
        "server": "string",
        "parent_interface": "string",
        "local_ip": "string" | null,

        // Для type: "pppoe"
        "username": "string",
        "password": "string",
        "service": "string",
        "concentrator": "string",
        "parent_interface": "string",

        // Для type: "l2tp"
        "server": "string", 
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "pptp"
        "server": "string",
        "username": "string",
        "password": "string",
        "parent_interface": "string",
        "dns": ["string"],

        // Для type: "span"
        "source": ["string"],
        "destination": "string" | null,
        "direction": "tx" | "rx" | "both",

        // Для type: "l2bridge"
        "interfaces": ["string"],
        "vlan_mapping": [
            [
                "integer",
                "integer"
            ]
        ],   
    }    
}
```

* `title` - название соединения;
* `enabled` - статус активности соединения:
  * `true` - включен;
  * `false` - выключен.
* `comment` - комментарий, максимальная длина - 256 символов. Может быть пустым;
* `zone` - идентификатор зоны. Может быть `null`, если зона не назначена;
* `vce_id` - идентификатор VCE. Для корневого VCE значение имеет вид `00000000-0000-0000-0000-000000000000`;
* `netflow_index` - целое число от 0 до 65535, индекс сетевого подключения для [Netflow](https://docs.ideco.ru/v22/ru/ngfw/settings/services/netflow);
* `role` - роль интерфейса: 
  * `cp` - используется для администрирования NGFW Novum через веб-интерфейс;
  * `lan` - используется для создания локальных интерфейсов;
  * `wan` - используется для подключения к провайдеру.
* `l3_mode` - режим настройки IP-конфигурации:
  * `dhcp` - автоматическая настройка IP-адреса устройством при подключении к сети;
  * `static` - ручная настройка IP-адреса, который остается неизменным;
  * `none` - настройка, при которой не выдаются IP-адреса.
* `l3` - список IP-адресов в формате CIDR. Заполняется, если параметр `l3_mode` имеет значение `static`. Может быть пустым, если параметр `l3_mode` имеет значение `none` и `dhcp`.
* `config` - конфигурация соединения содержит список параметров в зависимости от значения параметра `type`:
  * `ethernet` - параметры Ethernet-интерфейса:
    * `port` - наименование порта.
  * `vlan` - параметры VLAN-интерфейса:
    * `tag` - тег VLAN;
    * `parent_interface` - идентификатор родительского интерфейса, на котором создается VLAN.
  * `bond` - параметры LACP-интерфейса:
    * `ports` - список наименований портов.
  * `gre` - параметры GRE-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `local_ip` - IP-адрес родительского интерфейса.
  * `pppoe` - параметры PPPoE-интерфейса:
    * `username` - имя пользователя для подключения;
    * `password`- пароль пользователя для подключения. Может быть пустым;
    * `service` - идентификатор сервиса. Может быть пустым;
    * `concentrator` - идентификатор концентратора. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение.
  * `l2tp` - параметры L2TP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `pptp` - параметры PPTP-интерфейса:
    * `server` - IP-адрес или доменное имя устройства, к которому осуществляется подключение;
    * `username` - имя пользователя для подключения;
    * `password` - пароль пользователя для подключения. Может быть пустым;
    * `parent_interface` - идентификатор родительского интерфейса, через который выполняется подключение;
    * `dns`- список IP-адресов DNS.
  * `span` - параметры SPAN-интерфейса:
    * `source` - список идентификаторов интерфейсов;
    * `destination` - наименование порта назначения;
    * `direction` - тип дублирования трафика:
      * `tx` - только исходящий;
      * `rx` - только входящий;
      * `both` - весь трафик.
  * `l2bridge` - параметры L2-моста:
    * `interfaces` - список идентификаторов интерфейсов;
    * `vlan_mapping` - список тегов VLAN для маппинга. Каждый список должен содержать только два тега в формате `[исходный_vlan, новый_vlan]`.       

Если параметр `type` имеет значение `loopback`, то параметр `config` передается пустым.

**Ответ на успешный запрос:** 200 ОК

{% endcut %}

{% cut "Удаление настройки соединения" %}

```
DELETE /l2manager/connection_settings/<id соединения>
```

**Ответ на успешный запрос:** 200 OK

{% endcut %}

## Физические порты

{% cut "Получение списка физических портов" %}

```
GET /l2manager/ports
```

**Ответ на успешный запрос:**

```json5
[
  {
    "id": "string", 
    "name": "string",
    "kernel_ifindex": "integer",
    "vpp_ifindex": "integer",
    "vce_id": "string",
    "mac": "string",
    "cluster": "booleen",
    "exist": "booleen",
    "description": "string",
    "link": "unknown" | "up" | "down",
    "bus": "string",
    "device_id": "string" | null,
    "vendor_id": "integer" | null,
    "model_id": "integer" | null,
  },
  ...
]
```

* `id` - идентификатор физического порта;
* `name` - название физического порта. Допустимы латинские буквы в верхнем и нижнем регистре, цифры и специальные символы: `.`, `_` и `-`. Максимальная длина - 42 символа;
* `kernel_ifindex` - индекс интерфейса в системе;
* `vpp_ifindex` - индекс интерфейса в VCE;
* `mac` - MAC-адрес сетевой карты в формате `11:22:33:44:55:66`. Все буквы в нижнем регистре;
* `cluster` - использование в кластерной сети:
  * `true` - используется;
  * `false` - не используется.
* `exist` - существует ли физический порт:
  * `true` - существует;
  * `false` - не существует.
* `description` - описание физического порта;
* `link` - статусы соединения:
  * `unknown` - неизвестен;
  * `up` - подключен;
  * `down` - не подключен.
* `bus` - шина, к которой подключен порт:
  * `pci` - физическая сетевая карта;
  * `vmbus` - виртуальная сетевая карта в Hyper-V;
  * `unknown` - виртуальный интерфейс.
* `device_id` - PCI-адрес интерфейса в формате `00:06.0`, либо `1-1:1.0` для USB-адаптеров. Может быть `null`;
* `vendor_id` - идентификатор вендора сетевого адаптера. Может быть `null`;
* `model_id` - идентификатор модели сетевого адаптера. Может быть `null`.

{% endcut %}

{% cut "Добавление физического порта" %}

```
POST /l2manager/ports
```

**Тело запроса:**

```json5
{
  "name": "string", 
  "mac": "string",
  "cluster": "booleen"
}
```

* `name` - название физического порта. Допустимы латинские буквы в верхнем и нижнем регистре, цифры и специальные символы: `.`, `_` и `-`. Значение должно быть уникальным. Максимальная длина - 42 символа;
* `mac` - MAC-адрес сетевой карты в формате `11:22:33:44:55:66`. Все буквы в нижнем регистре. Значение должно быть уникальным;
* `cluster` - использование в кластерной сети:
  * `true` - используется;
  * `false` - не используется.

**Ответ на успешный запрос:**

```json5
{
  "id": "string"
}
```

* `id` - идентификатор физического порта.

{% endcut %}

{% cut "Редактирование физического порта" %}

```
PATCH /l2manager/ports/<id физического порта>
```

**Тело запроса (все или некоторые поля):**

```json5
{
  "name": "string", 
  "mac": "string",
  "cluster": "booleen"
}
```

* `name` - название физического порта. Допустимы латинские буквы в верхнем и нижнем регистре, цифры и специальные символы: `.`, `_` и `-`. Значение должно быть уникальным. Максимальная длина - 42 символа;
* `mac` - MAC-адрес сетевой карты в формате `11:22:33:44:55:66`. Все буквы в нижнем регистре. Значение должно быть уникальным;
* `cluster` - использование в кластерной сети:
  * `true` - используется;
  * `false` - не используется.

**Ответ на успешный запрос:** 200 ОК

{% endcut %}

{% cut "Удаление физического порта" %}

```
DELETE /l2manager/ports/<id физического порта>
```

**Ответ на успешный запрос:** 200 OK

{% endcut %}

<!--статья: https://stash.ideco.dev/projects/UTM/repos/l2-manager/browse/docs-->
