Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

host.massupdate

Descripción

object host.massupdate(object parameters)

Este método permite reemplazar o eliminar simultáneamente objetos relacionados y actualizar propiedades en varios equipos.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

(object) Parámetros que contienen los IDs de los equipos a actualizar y las propiedades que deben ser actualizadas.

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

Parámetro Tipo Descripción
hosts object/array Equipos que se actualizarán.

Los equipos deben tener definida únicamente la propiedad hostid.

Comportamiento del parámetro:
- obligatorio
groups object/array Grupos de equipos para reemplazar los grupos de equipos actuales a los que pertenecen los equipos.

Los grupos de equipos deben tener definida únicamente la propiedad groupid.
interfaces object/array Interfaces de equipo para reemplazar las interfaces de equipo actuales en los equipos indicados.
inventory object Propiedades del inventario de equipo.

El modo de inventario de equipo no puede actualizarse usando el parámetro inventory, utilice inventory_mode en su lugar.
macros object/array Macros de usuario para reemplazar las macros de usuario actuales en los equipos indicados.
templates object/array Plantillas para reemplazar las plantillas actualmente vinculadas en los equipos indicados.

Las plantillas deben tener definida únicamente la propiedad templateid.
templates_clear object/array Plantillas para desvincular y limpiar de los equipos indicados.

Las plantillas deben tener definida únicamente la propiedad templateid.

Valores de retorno

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

Ejemplos

Habilitar varios equipos

Habilite la monitorización 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
       }

Véase también

Fuente

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