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 equipos a actualizar y las propiedades que deben actualizarse.

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

Parámetro Tipo Descripción
hosts objeto/matriz Equipos a actualizar.

Los equipos deben tener la propiedad hostid definida.

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 la propiedad groupid definido.
interfaces objeto/matriz Interfaces de equipos para reemplazar las interfaces de equipo actuales en los equipos dados.
inventory objeto Propiedades del inventario del equipo.

El modo de inventario del equipo 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 equipos dados.
templates object/array Plantillas para reemplazar las plantillas actualmente vinculadas en los hosts dados.

Las plantillas deben tener definida la propiedad templateid.
templates_clear object/array Plantillas para desvincular y borrar de los equipos dados.

Las plantillas 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 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.