Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

host.massupdate

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

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.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ

(objeto) ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ 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.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Tipo ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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.