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.
(objeto)
Parámetros que contienen los ID de los equipos a actualizar y los objetos que deben ser eliminados.
Parámetro | Tipo | Descripción |
---|---|---|
hostids | cadena/matriz | ID de los equipos que se actualizarán. Comportamiento de parámetros: - requerido |
groupids | cadena/matriz | Grupos de equipos de los que eliminar los equipos dados. |
interfaces | objeto/matriz | Interfaces de equipos para eliminar de los equipos dados. El objeto de interfaz de host debe tener definidas las propiedades ip , dns y port . |
macros | cadena/matriz | Macros de usuario para eliminar de los hosts dados. |
templateids | cadena/matriz | Plantillas para desvincularse de los equipos dados. |
templateids_clear | string/array | Plantillas para desvincular y borrar de los equipos dados. |
(objeto)
Devuelve un objeto que contiene los ID de los equipos actualizados bajo la propiedad hostids
.
Desvincular una plantilla de dos equipos y eliminar todas las entidades de las plantillas.
{
"jsonrpc": "2.0",
"method": "host.massremove",
"params": {
"hostids": ["69665", "69666"],
"templateids_clear": "325"
},
"id": 1
}
Respuesta:
CHost::massRemove() en ui/include/classes/api/services/CHost.php.