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.

Documentation