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

(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	ID/matriz	ID de los equipos que se actualizarán. Comportamiento del parámetro: - obligatorio
groupids	ID/matriz	ID de los grupos de equipos de los cuales eliminar los hosts dados.
interfaces	objeto/matriz	Interfaces de equipo para eliminar de los equipos dados. El objeto de interfaz de equipo debe tener solo definidas las propiedades`ip`, `dns` y `puerto`.
macros	cadena/matriz	Macros de usuario para eliminar de los equipos dados.
templateids	ID/matriz	ID de las plantillas para desvincularse de los equipos dados.
templateids_clear	ID/array	ID de las plantillas para desvincular y borrar de los equipos dados.

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.

Documentation