host.massremove

Descripción

object host.massremove(object parameters)

Este método permite eliminar objetos relacionados de múltiples equipos.

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 los objetos que deben eliminarse.

Parámetro Tipo Descripción
hostids ID/array IDs de los hosts que se actualizarán.

Comportamiento del parámetro:
- obligatorio
groupids ID/array IDs de los grupos de hosts de los que se eliminarán los hosts indicados.
interfaces object/array Interfaces de host que se eliminarán de los hosts indicados.

El objeto de interfaz de host debe tener definidas solo las propiedades ip, dns y port.
macros string/array Macros de usuario que se eliminarán de los hosts indicados.
templateids ID/array IDs de las templates que se desvincularán de los hosts indicados.
templateids_clear ID/array IDs de las templates que se desvincularán y borrarán de los hosts indicados.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los equipos actualizados bajo la propiedad hostids.

Examples

Desvincular plantillas

Desvincular una plantilla de dos equipos y eliminar todas las entidades de las plantillas.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "host.massremove",
    "params": {
        "hostids": ["69665", "69666"],
        "templateids_clear": "325"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}

Ver también

Fuente

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