host.massremove

Descripción

object host.massremove(object parameters)

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

Este método solo está disponible para tipos de usuario Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en ajustes de rol de usuario. Ver User
roles para más información.

Parámetros

(object) Parámetros que contienen los IDs de los hosts a actualizar y el objetos que deben ser eliminados.

Parámetro Tipo Descripción
hostids
(obligatorio)		 cadena/matriz ID de los hosts que se actualizarán.
groupids cadena/matriz Grupos de hosts de los que eliminar los hosts dados.
interfaces objeto/matriz Interfaces de host para eliminar de los hosts 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 Templates para desvincularse de los hosts dados.
templateids_clear cadena/matriz Templates para desvincular y eliminar de los hosts dados.

Valores devueltos

(object) Devuelve un objeto que contiene los IDs de los hosts actualizados bajo la propiedad hostids.

Ejemplos

Desvincular templates

Desvincular una template de dos hosts y eliminar todas las entidades plantillas. Solicitud:

{
"jsonrpc": "2.0",
"method": "host.massremove",
"params": {
"hostids": ["69665", "69666"],
"templateids_clear": "325"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"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.