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

(objeto) Parámetros que contienen los ID de los hosts a actualizar y el objetos para agregar a todos los hosts.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts	objeto/matriz	Hosts a actualizar. Los equipos deben tener solo la propiedad `hostid` definida. Comportamiento de parámetros: - obligatorio
groups	objeto/matriz	Grupos de equipos para agregar a los equipos dados. Los grupos de equipos deben tener solo la propiedad `groupid` definida.
interfaces	objeto/matriz	Interfaces de equipo que se crearán para los equipos dados.
macros	objeto/matriz	Macros de usuario que se crearán para los equipos dados.
templates	objeto/matriz	Plantillas para vincular a los equipos dados. Las plantillas deben tener solo la propiedad `templateid` definida.

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.

Documentation