host.massadd

Descripción

object host.massadd(object parameters)

Este método permite agregar simultáneamente múltiples objetos relacionados a todos los equipos dados.

Este método solo está disponible para los tipos de usuarios 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 los objetos a añadir a todos los hosts.

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 que se añadirán a los hosts indicados.

Los grupos de hosts deben tener definida únicamente la propiedad groupid.
interfaces object/array Interfaces de host que se crearán para los hosts indicados.
macros object/array Macros de usuario que se crearán para los hosts indicados.
templates object/array Templates que se enlazarán a los hosts indicados.

Los templates deben tener definida únicamente la propiedad templateid.

Valores devueltos

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

Ejemplos

Agregar macros

Agregue dos nuevas macros a dos equipos.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "host.massadd",
    "params": {
        "hosts": [
            {
                "hostid": "10160"
            },
            {
                "hostid": "10167"
            }
        ],
        "macros": [
            {
                "macro": "{$TEST1}",
                "value": "MACROTEST1"
            },
            {
                "macro": "{$TEST2}",
                "value": "MACROTEST2",
                "description": "Test description"
            }
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10160",
            "10167"
        ]
    },
    "id": 1
}

Ver también

Fuente

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