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

(object) Parámetros que contienen los IDs de los hosts que se van a actualizar y las interfaces que se van a eliminar.

Parámetro Tipo Descripción
interfaces object/array Interfaces de host que se eliminarán de los hosts indicados.

El objeto de interfaz de host debe tener definidas únicamente las propiedades ip, dns y port.

Comportamiento del parámetro:
- obligatorio
hostids ID/array IDs de los hosts que se van a actualizar.

Comportamiento del parámetro:
- obligatorio

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.