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

(object) Parámetros que contienen los IDs de los hosts a actualizar y las 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 object/array Hosts que se actualizarán.

Los hosts deben tener definida únicamente la propiedad hostid.

Comportamiento del parámetro:
- 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 definida únicamente la propiedad groupid.
interfaces object/array Interfaces de host para reemplazar las interfaces de host actuales en los hosts indicados.
inventory object Propiedades del inventario de host.

El modo de inventario de host 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 hosts indicados.
templates object/array Templates para reemplazar los templates actualmente vinculados en los hosts indicados.

Los templates deben tener definida únicamente la propiedad templateid.
templates_clear object/array Templates para desvincular y limpiar de los hosts indicados.

Los templates deben tener definida únicamente 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.