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 hosts.

Este método solo está disponible para tipos de usuarios 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

(objecto) Parámetros que contienen los ID de los hosts a actualizar y las propiedades que deben actualizarse.

Además de las [standard host properties, el método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts (obligatorio)	objeto/matriz	Hosts a actualizar. Los hosts deben tener la propiedad `hostid` definida.
grupos	objeto/matriz	Host groupspara reemplazar los grupos de hosts actuales a los que pertenecen los hosts. Los grupos de hosts deben tener la propiedad `groupid` definida.
interfaces	objeto/matriz	Host interfaces para reemplazar las interfaces de host actuales en los hosts dados.
inventario	objeto	Propiedades del host inventory. El modo de inventario del host no se puede actualizar usando el parámetro `inventory`, use `inventory_mode` en su lugar.
macros	objeto/matriz	User macros para reemplazar las macros de usuario actuales en los hosts dados.
templates	objeto/matriz	Templates para reemplazar las templates actualmente vinculadas en los hosts dados. Las templates deben tener definida la propiedad `templateid`.
templates_clear	objeto/matriz	Templates para desvincular y borrar de los hosts dados. Las templates deben tener definida 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 hosts

Habilite la métrica de dos hosts, es decir, establezca su estado en 0.

Solicitud:

{
       "jsonrpc": "2.0",
       "method": "host.massupdate",
       "params": {
       "hosts": [
       {
       "hostid": "69665"
       },
       {
       "hostid": "69666"
       }
       ],
       "status": 0
       },
       "auth": "038e1d7b1735c6a5436ee9eae095879e",
       "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