hostinterface.massremove

Descripción

object hostinterface.massremove(object parameters)

Este método le permite eliminar interfaces de host de los hosts especificados.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte User roles para obtener 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:
- obligatorio
hostids ID/array IDs de los hosts a actualizar.

Comportamiento del parámetro:
- obligatorio

Valores de retorno

(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
}

Véase también

Origen

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