hostinterface.massremove

Descripción

object hostinterface.massremove(object parameters)

Este método permite eliminar interfaces de equipo de los equipos dados.

Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que contienen los ID de los equipos que se actualizarán y las interfaces que se van a eliminar.

Parámetro Tipo Descripción
interfaces objeto/matriz Interfaces de equipo para eliminar de los equipos dados.

El objeto de interfaz de equipo debe tener definidas las propiedades ip, dns y port.

Comportamiento del parámetro:
- obligatorio
hostids cadena/matriz ID de los equipos que se actualizarán.

Comportamiento de parámetros:
- requerido

Valores devueltos

(object) Devuelve un objeto que contiene los IDs de las interfaces de equipo eliminadas bajo la propiedad interfaceids.

Ejemplos

Eliminando interfaces

Elimine la interfaz SNMP "127.0.0.1" de dos equipos.

Solicitud:

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

Respuesta:

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

Ver también

-hostinterface.delete -host.massremove

Fuente

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