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 a actualizar y las interfaces a eliminar.

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

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

Comportamiento del parámetro:
- requerido
hostids ID/array IDs de los hosts a actualizar.

Comportamiento del parámetro:
- 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.