host.massupdate

Descripción

object host.massupdate(object parameters)

Este método permite reemplazar o eliminar simultáneamente objetos relacionados y actualizar propiedades en 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 hosts a actualizar y el propiedades que deben actualizarse.

Además de las propiedades estándar del host, el método Acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts	objeto/matriz	Hosts a actualizar. Los hosts deben tener solo la propiedad `hostid` definida. Comportamiento de parámetros: - obligatorio
groups	object/array	Grupos de hosts para reemplazar los grupos de hosts actuales a los que pertenecen los hosts. Los grupos de hosts deben tener solo el `groupid` propiedad definida.
interfaces	object/array	Interfaces de host para reemplazar las interfaces de host actuales en los hosts dados.
inventario	objeto	Propiedades de Inventario de host. El modo de inventario de host no se puede actualizar usando el parámetro `inventory`, use `inventory_mode` en su lugar.
macros	object/array	Macros de usuario para reemplazar las macros de usuario actuales en los hosts dados.
templates	object/array	Plantillas para reemplazar las plantillas actualmente vinculadas en los hosts dados. Las plantillas deben tener definida solo la propiedad `templateid` .
templates_clear	object/array	Plantillas para desvincular y borrar de los hosts dados. Las plantillas deben tener definida solo la propiedad `templateid` .

Valores devueltos

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

Ejemplos

Habilitación de múltiples equipos

Habilite el monitoreo de dos equipos, es decir, establezca su estado en "0".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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

Documentation