[comment]: # translation:outdated

[comment]: # ({9230837a-9230837a})
# hostinterface.massremove

[comment]: # ({/9230837a-9230837a})

[comment]: # ({75214f21-4559aff6})
### Описание

`object hostinterface.massremove(параметры объекта)`

Этот метод позволяет удалить интерфейсы узлов сети у заданных узлов сети.

::: noteclassic
Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/75214f21-4559aff6})

[comment]: # ({new-8970fdbb})
### Параметры

`(объект)` Параметры, которые содержат ID обновляемых узлов сети и
удаляемых интерфейсов.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**hostids**<br>(требуется)|строка/массив|ID обновляемых узлов сети.|
|**interfaces**<br>(требуется)|строка/массив|Удаляемые интерфейсы узлов сети с заданных узлов сети.<br><br>У объекта интерфейса узла сети должны быть заданы свойства ip, dns и port|

[comment]: # ({/new-8970fdbb})

[comment]: # ({61a8b976-61a8b976})
### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID удаленных интерфейсов
узлов сети, указанных в свойстве `interfaceids`.

[comment]: # ({/61a8b976-61a8b976})

[comment]: # ({b41637d2-b41637d2})
### Примеры

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({3d9767f9-cceffaf2})
#### Удаление интерфейсов

Удалить SNMP-интерфейс "127.0.0.1" у двух узлов сети.

Запрос:

```json
{
    "jsonrpc": "2.0",
    "method": "hostinterface.massremove",
    "params": {
        "hostids": [
            "30050",
            "30052"
        ],
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "port": "161"
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30069",
            "30070"
        ]
    },
    "id": 1
}
```

[comment]: # ({/3d9767f9-cceffaf2})

[comment]: # ({a3245281-a3245281})
### Смотрите также

-   [hostinterface.delete](delete)
-   [host.massremove](/manual/api/reference/host/massremove)

[comment]: # ({/a3245281-a3245281})

[comment]: # ({6853cf7a-6853cf7a})
### Источник

CHostInterface::massRemove() в
*ui/include/classes/api/services/CHostInterface.php*.

[comment]: # ({/6853cf7a-6853cf7a})